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

Euler Cosimulation

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

Тип: EngeeFunction

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

/Interfaces/Euler/Euler Cosimulation

Описание

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

Блок Euler Cosimulation предназначен для организации косимуляции между Engee и Euler. Он обеспечивает передачу входных сигналов из Engee в Euler и получение выходных данных из Euler на каждом шаге моделирования.

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

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

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

  • Автоматически — генерацией конфигурационного файла settings.cfg на основе параметров блока.

При автоматической генерации:

  • Engee находит на холсте модель с блоком Euler Cosimulation;

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

  • Формирует файл settings.cfg с описанием модели и сигналов;

  • Сохраняет settings.cfg в выбранный каталог для последующего использования в Euler.

Путь размещения settings.cfg критичен: файл должен лежать в той же папке, что и открытый проект Euler (*.elr), иначе Euler не сможет прочитать конфигурацию.

DLL-библиотека интеграции может располагаться в любой папке и подключается в Euler по указанному пути.

Порты

Вход

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

Details
Типы данных

Float64

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

Нет

Выход

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

Details
Типы данных

Float64

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

Нет

Параметры

Параметры

# IP адрес Эйлер: — IPv4 адрес, на котором находится сервер Euler

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

"127.0.0.1"

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

m_ip

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

Нет

Вычисляемый

Да

# Порт Эйлер: — порт сервера Euler

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

7489

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

m_port

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

Нет

Вычисляемый

Да

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

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

24

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

m_recv_buf_len

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

Нет

Вычисляемый

Да

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

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

(:FX, :FT)

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

m_input_signal_names

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

Нет

Вычисляемый

Да

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

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

(:fx, :fy, :fz)

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

m_output_signal_names

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

Нет

Вычисляемый

Да

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

Details

Начальные значения параметров модели, передаваемые в Euler при запуске косимуляции (параметр INIT_MODEL_PARAM в settings.cfg).

Параметр INIT_MODEL_PARAM зарезервирован и в дальнейшем может не использоваться.
Значение по умолчанию

(Cx=2000, Cy=2500, Cz=3000)

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

m_init_param_names

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

Нет

Вычисляемый

Да

# Количество переменных состояний модели: — число переменных состояния, используемое Euler при первичной инициализации и отображении структуры модели в графическом интерфейсе

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

0

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

m_num_continuous_state

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

Нет

Вычисляемый

Да

# Количество дискретных состояний модели: — число дискретных состояний, используемое Euler при первичной инициализации и отображении структуры модели в графическом интерфейсе

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

0

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

m_num_discrete_state

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

Нет

Вычисляемый

Да

# Путь к Эйлер: — путь к установленному исполняемому файлу или каталогу Euler

Details

Путь к установленному Euler (исполняемому файлу или каталогу установки). Используется, если для организации косимуляции требуется указать расположение Euler в файловой системе (например, для запуска или поиска компонентов среды).

Если Euler запускается вручную, а DLL подключается по указанному пути, то параметр может не требоваться.
Значение по умолчанию

"C:\\Program Files\\AutoMechanics\\Euler Demo 12.14.41\\Samples\\Projects\\Beginner\\"

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

m_um_path

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

Нет

Вычисляемый

Да

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

Details

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

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

0.01

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

m_sample_time

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

Нет

Вычисляемый

Да

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

Details

Включает диагностическое логирование обмена в процессе косимуляции. При активной опции создается файл engee_logs.txt, который располагается рядом с settings.cfg.

В лог записывается:

  • Текущее модельное время Euler и Engee;

  • Значения принятых и отправленных сигналов;

  • Диагностические сообщения обмена.

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

true (включено)

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

m_is_diagnostic

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

Нет

Вычисляемый

Да

# Сгенерировать конфигурационный файл — генерирует файл settings.cfg для косимуляции

Details

Формирует конфигурационный файл settings.cfg на основе параметров блока (имя модели, состав и имена входных/выходных сигналов, параметры и режим логирования). Файл используется Euler для чтения конфигурации косимуляции; после генерации поместите settings.cfg в папку открытого проекта Euler (*.elr).

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

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

m_gen_cfg

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

Нет

Вычисляемый

Нет