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

FMU

Импортирует в Engee модели, созданные в других средах, с помощью FMI.

Тип: FMU

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

/Basic/User-Defined Functions/FMU

Описание

Блок FMU импортирует в Engee модели, созданные в других средах, с помощью интерфейса функциональных макетов (Functional Mock-up Interface, FMI).

Блок поддерживает FMI версии 2.0 для совместного моделирования (режим Co-Simulation).

Чтобы использовать этот блок, необходимо иметь существующий функциональный макет (Functional Mock-up Unit, FMU), экспортированный из другого инструмента или написанный на языке C.

Начальные значения параметров, определенных в FMU, можно задать в поле Parameters.

Входные и выходные порты настраиваются в параметрах Inputs names, Outputs names и Internal variables.

Входные и выходные порты поддерживают числовые и строковые типы данных.

По умолчанию у блока указан один выходной порт Out1.

Порты

Выход

# Out1 — выходной порт
none | string size limited to 255

Details

Выходной порт.

Типы данных

Float64

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

Нет

Параметры

Основные

# FMU name — имя FMU

Details

Укажите имя файла FMU с расширением или без. Этот параметр чувствителен к регистру. FMU должен существовать в пути Engee.

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

model.fmu

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

FMUName

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

Нет

Вычисляемый

Да

# Enable FMU tolerance — включить допустимую погрешность FMU
Logical

Details

Установите этот флажок, чтобы разрешить FMU задавать значение погрешности. В противном случае снимите этот флажок.

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

false (выключено)

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

FMUIsToleranceUsed

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

Нет

Вычисляемый

Нет

# Relative tolerance — значение относительной погрешности
Real number

Details

Значение относительной погрешности FMU (%) в виде скаляра.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable FMU tolerance.

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

0.001

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

FMUToleranceValue

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

Нет

Вычисляемый

Да

# Parameters — параметры
String

Details

Параметры, определенные в FMU.

Достаточно указать только те параметры, начальные значения которых нужно изменить.

Пример: g=>-5.5 e=>5.

Если имя параметра будет задано неверно, то будет выдана ошибка с сообщением о доступных именах параметров.

Если нет необходимости менять значения по умолчанию, то строка остается пустой.

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

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

Params

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

Нет

Вычисляемый

Да

# Inputs names — входные порты
String

Details

Укажите через пробел имена доступных входных портов, которые необходимо использовать.

Пример: In_1 In_2.

Если имя порта будет задано неверно, то будет выдана ошибка с сообщением о доступных именах портов.

Если модель не имеет входных портов или нет необходимости их использовать, то значение для Inputs names не заполняется.

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

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

InputsNames

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

Нет

Вычисляемый

Да

# Outputs names — выходные порты
String

Details

Укажите через пробел имена доступных выходных портов, которые необходимо использовать.

Пример: Out_1 Out_2.

Если имя порта будет задано неверно, то будет выдана ошибка с сообщением о доступных именах портов.

Если модель не имеет выходных портов или нет необходимости их использовать, то значение для Outputs names не заполняется.

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

Out1

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

OutputsNames

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

Нет

Вычисляемый

Да

# Internal variables — внутренние переменные
String

Details

Укажите через пробел имена доступных внутренних переменных, значения которых необходимо выводить.

Пример: Var_1 Var_2.

Если имя переменной будет задано неверно, то будет выдана ошибка с сообщением о доступных именах переменных.

Если модель не имеет внутренних переменных или нет необходимости их использовать, то значение для Internal variables не заполняется.

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

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

InternalVariables

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

Нет

Вычисляемый

Да

# Communication Step Size — размер шага между временными интервалами совместного моделирования
SampleTime (real number / vector of two real numbers)

Details

Размер шага коммуникации. Укажите размер шага между временными интервалами моделирования для блока.

В большинстве случаев, чтобы предотвратить неожиданное поведение, задайте положительное значение. Чтобы унаследовать время выборки от движущего блока или решателя модели, установите для этого параметра значение -1.

Блок поддерживает только периодический дискретный шаг расчета без смещения (например, положительный скаляр).

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

-1

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

FMUSampleTime

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

Нет

Вычисляемый

Да