Документация Engee

UM Cosimulation

Передача данных в Универсальный Механизм и получение результатов косимуляции из Универсального Механизма.

Тип: EngeeFunction

Путь в библиотеке:

/Interfaces/UniversalMechanism/UM Cosimulation

Описание

Для работы с блоком установите/обновите пакет поддержки оборудования.

Блок UM Cosimulation предназначен для организации косимуляции между Engee и программным комплексом Универсальный Механизм (УМ). Он обеспечивает передачу входных сигналов в модель УМ и получение выходных данных на каждом шаге моделирования.

Конфигурация косимуляции

Конфигурация для блока может формироваться двумя способами:

  • Вручную — заполнением параметров блока в его настройках.

  • Автоматически (через программное управление) — с помощью генерации конфигурационного файла.

    Для автоматической генерации используется вызов:

    using Main.EngeeDeviceManager.INTEGRATIONS_API.UM
    UM.generate_cfg_file("/user/example_UM.engee")

При выполнении этой команды:

  • Скрипт находит на холсте модель с блоком UM Cosimulation;

  • Извлекает параметры из блока;

  • Автоматически формирует конфигурационный файл;

  • Помещает его в каталог, указанный в параметре «Путь к УМ».

    В качестве пути должна быть указана папка bin установленного Универсального Механизма, соответствующая конкретной версии, используемой пользователем.

Порты

Вход

# Input signals — входные сигналы типа BusSignal
вектор

Details
Типы данных

Float64

Поддержка комплексных чисел

Нет

Выход

# Output Signals — выходные сигналы типа BusSignal
вектор

Details
Типы данных

Float64

Поддержка комплексных чисел

Нет

Параметры

Main group

# IP адрес UM: — IPv4 адрес, на котором находится сервер Универсального Механизма

Details
Значение по умолчанию

"127.0.0.1"

Имя для программного использования

m_ip

Настраиваемый

Нет

Вычисляемый

Да

# Порт UM: — порт сервера Универсального Механизма

Details
Значение по умолчанию

7489

Имя для программного использования

m_port

Настраиваемый

Нет

Вычисляемый

Да

# Размер буфера приёма: — сумма размерностей входных сигналов приемника в Универсальном Механизме

Details
Значение по умолчанию

24

Имя для программного использования

m_recv_buf_len

Настраиваемый

Нет

Вычисляемый

Да

# Имена входных сигналов: — имена сигналов во входной шине

Details
Значение по умолчанию

(:Fx, :Fy)

Имя для программного использования

m_input_signal_names

Настраиваемый

Нет

Вычисляемый

Да

# Имена выходных сигналов: — имена сигналов в выходной шине

Details
Значение по умолчанию

(:dX, :dY)

Имя для программного использования

m_output_signal_names

Настраиваемый

Нет

Вычисляемый

Да

# Начальные параметры — строка с начальными значениями параметров, передаваемых в Универсальный Механизм

Details

Строка с начальными значениями параметров, передаваемых в Универсальный Механизм при запуске косимуляции. Используется для задания стартовых параметров модели Универсального Механизма. Значения передаются при установлении соединения и применяются до начала расчета. Представляет собой содержимое конфигурационного файла, задаваемое в текстовом виде.

Значение по умолчанию

(Cx=2000, Cx=2000, Cz=2000)

Имя для программного использования

m_init_param_names

Настраиваемый

Нет

Вычисляемый

Да

# Путь к УМ — путь к установленному исполняемому файлу или каталогу Универсального Механизма

Details

Путь к установленному исполняемому файлу или каталогу Универсального Механизма. Используется для указания расположения Универсального Механизма в файловой системе. По данному пути выполняется запуск или подключение к исполняемой среде УМ для организации косимуляции.

Рекомендуется указывать путь именно к папке bin установленного Универсального Механизма соответствующей версии. Пример: C:\Program Files\UM Software Lab\Universal Mechanism\10\bin.
Значение по умолчанию

"C:\Program Files\UM Software Lab\Universal Mechanism\10\bin"

Имя для программного использования

m_um_path

Настраиваемый

Нет

Вычисляемый

Да

# Шаг расчёта, с: — шаг расчета блока

Details

Шаг расчета блока в секундах. Не может быть Inherited (-1).

Значение по умолчанию

0.01

Имя для программного использования

m_sample_time

Настраиваемый

Нет

Вычисляемый

Да

# Включить профилирование — сбор данных о производительности и параметрах исполнения косимуляции

Details

Включает сбор данных о производительности и параметрах исполнения косимуляции. При активной опции в папке bin Универсального Механизма создается файл engee_logs.txt.

В файл записывается:

  • Вызываемые процедуры в Универсальном Механизме;

  • Текущее модельное время Engee на каждом шаге;

  • Текущее модельное время УМ;

  • Входные и выходные параметры обмена.

Содержимое файла существует до тех пор, пока пользователь в Универсальном Механизме не нажмет кнопку «Прервать». После этого файл очищается, и логи становятся недоступны.

Данный механизм предназначен преимущественно для диагностики. При возникновении проблем рекомендуется передавать файл логов в техническую поддержку для ускоренного анализа неисправностей.

Значение по умолчанию

true (включено)

Имя для программного использования

m_is_diagnostic

Настраиваемый

Нет

Вычисляемый

Да