BGMod Документация / v3
Руководство BGMod

Работа в редакторе

От физической системы к модели

  1. Найдите участки одинакового давления. Представьте каждый гидравлический узел давления 0-сопряжением. Для баланса при общем расходе, например последовательного перепада давления, используйте 1-сопряжение.
  2. Выберите физические законы. R задаёт диссипацию, C — ёмкость, I — инерцию, Se/Sf — предписанные воздействия. Применяйте составные блоки, если их допущения подходят устройству.
  3. Соедините именованные порты. Нажмите B, затем выберите первый и второй порт. У фиксированного порта может быть одна связь. Для ветвления используйте 0/1-сопряжение со стабильными ID портов p1, p2, … . В полной модели у сопряжения должно быть не менее двух связей.
  4. Согласуйте физические области. Гидравлический порт соединяется с гидравлическим, механический — с механическим. CylinderDA преобразует мощность между областями через отдельные порты A, B и M.
  5. Задайте параметры и начальные условия в СИ. Проверьте опорное давление, абсолютные давления аккумулятора, объём накопления C, положение цилиндра и скорость нагрузки. Настройте воздействия источников и расписания насоса и распределителя.
  6. Выполните анализ и расчёт. Диагностика укажет элемент, связь или порт. Перед интерпретацией результата изучите уравнения и внутренние схемы.
Однопортовый R и двухпортовая линия. Примитив R описывает одну пару «перепад давления — расход». Для сопротивления между двумя узлами давления в схеме из примитивов нужно 1-сопряжение с соответствующими знаками. HydraulicResistance объединяет эту конструкцию в блок H1/H2 и напрямую использует p1 − p2. Сама связь не обладает сопротивлением, ёмкостью или инерцией.

Простой рабочий пример

Соедините Sf.H → J0.p1, J0.p2 → C.H и J0.p3 → R.H; везде direction = +1, область — гидравлика. Задайте положительные R и C и подачу Qin. Получится C·dp/dt = Q_in − p/R, где p(0) = q0/C. Здесь примитив R отводит расход к опорному давлению и не задаёт второй узел давления.

Escape отменяет режим соединения. Delete удаляет выбранный объект, а для блока — также все его связи. Незавершённую схему можно сохранить в JSON; полная топология проверяется при анализе. Перетаскивание блоков и масштабирование изменяют только расположение.

Примеры, расписания и результаты

Интерфейс, диагностика и обозначения единиц в графиках и CSV используют английский язык (Pa, m³/s, N, W, s). Кнопка Documentation ↗ открывает английское руководство; переключатель языка вверху ведёт к русской версии.

В панели Elements выберите Hydraulics, Translational mechanics или Electrical, затем вкладку Primitives или Advanced. Примитивы 0, 1, R, C, I, Se, Sf имеют названия, единицы СИ и начальные параметры своей области. Для механики это общая сила, общая скорость, демпфер, податливость пружины, масса, источник силы и источник скорости. Advanced показывает компоненты с портом выбранной области; цилиндр доступен в обеих областях. Переключение библиотеки влияет только на добавляемые элементы. Навигация по вкладкам: стрелки вверх/вниз, Home и End. Область несоединённого примитива также можно изменить в Properties.

Выберите пример в верхнем списке и нажмите «Open example». Начните с модели из статьи для изучения примитивов, затем откройте стенд 7A с именованными портами и разными физическими областями.

Примеры

Читайте результаты вместе со статусом

Вкладка «Equations» показывает состояния, ограничения и доступные только для чтения внутренние графы составных компонентов. Линейные модели выдают постоянные матрицы A/B. Для нелинейных выводятся неявная система G(t,x,w)=0 и алгебраические группы. Оба пути используют интегрирование Radau.

Во вкладке «Charts» величины разделены по размерности. Выберите нужные ряды; регулятор времени результата позволяет увидеть рабочую точку насоса на характеристике.

СтатусСмысл
completedУспешно достигнуто заданное конечное время.
stopped_at_limitДостигнута физическая граница модели: ход цилиндра, объём аккумулятора или допустимое давление. Траектория частичная.
failedАлгебраическая или численная ошибка не позволила продолжить расчёт. Возвращаются только корректные точки до ошибки.

Перед сравнением расчётов проверьте время завершения и диагностику. Частичный CSV содержит статус, время завершения, коды диагностики и пометку частичного результата в имени файла. Начальные ошибки документа и совместимости не позволяют начать расчёт.

Сохранение и редактирование

Кнопка «Save» выгружает JSON v3 с параметрами, портами, начальными состояниями, расписаниями, опорным давлением и снимком данных насоса. Результаты в него не входят. Ранее сохранённые JSON остаются совместимыми; пользовательские названия и импортированные данные сохраняются на исходном языке. Автосохранения на сервере нет. Математические изменения делают результаты устаревшими, геометрические — нет. Запоздавший ответ для прежней версии модели не подменяет актуальный результат.