Engee documentation

EULER Cosimulation

Transferring data to Euler and receiving simulation results from Euler.

blockType: EngeeFunction

Path in the library:

/Interfaces/EULER/EULER Cosimulation

Description

To work with the block, install/update the support package. equipment.

Block EULER Cosimulation it is intended for the organization of cosimulation between Engee and Euler. It provides the transmission of input signals from Engee in Euler and getting the output from Euler at each step of the simulation.

Cosimulation configuration

The configuration for the block can be configured in two ways:

  • Manually — filling in the parameters of the block in its settings (composition and names of signals, exchange parameters, etc.).

  • Automatically — by generating the configuration file settings.cfg based on the block parameters.

With automatic generation:

  • Engee finds a model with a block on the canvas EULER Cosimulation;

  • Retrieves parameters from the block;

  • Generates a settings.cfg file with a description of the model and signals;

  • Saves settings.cfg to the selected directory for later use in Euler.

The placement path settings.cfg is critical: the file must be in the same folder as the open Euler project (*.elr), otherwise Euler will not be able to read the configuration.

The integration DLL library can be located in any folder and is connected to Euler using the specified path.

Ports

Input

# In — input signals of the type BusSignal
vector

Details
Data types

Float64

Complex numbers support

No

Output

# Out — output signals of the type BusSignal
vector

Details
Data types

Float64

Complex numbers support

No

Parameters

Parameters

# IP адрес Эйлер: — The IPv4 address where the Euler server is located

Details
Default value

"127.0.0.1"

Program usage name

m_ip

Tunable

No

Evaluatable

Yes

# Порт Эйлер: — the port of the Euler server

Details
Default value

7489

Program usage name

m_port

Tunable

No

Evaluatable

Yes

# Размер буфера приёма: — the sum of the dimensions of the receiver input signals in Euler

Details
Default value

24

Program usage name

m_recv_buf_len

Tunable

No

Evaluatable

Yes

# Имена входных сигналов: — the names of the signals in the input bus

Details
Default value

(:FX, :FT)

Program usage name

m_input_signal_names

Tunable

No

Evaluatable

Yes

# Имена выходных сигналов: — names of the signals in the output bus

Details
Default value

(:fx, :fy, :fz)

Program usage name

m_output_signal_names

Tunable

No

Evaluatable

Yes

# Путь к Эйлер: — the path to the installed executable file or the Euler directory

Details

The path to the installed Euler (executable file or installation directory). It is used if, in order to organize simulation, it is necessary to specify the location of Euler in the file system (for example, to launch or search for environment components).

If Euler is started manually, and the DLL is connected using the specified path, then the parameter may not be required.
Default value

"."

Program usage name

m_um_path

Tunable

No

Evaluatable

Yes

# Шаг расчёта, с: — block calculation step

Details

The block calculation step in seconds. Cannot be Inherited (-1).

Default value

0.01

Program usage name

m_sample_time

Tunable

No

Evaluatable

Yes

# Включить профилирование — collecting data on the performance and parameters of the simulation execution

Details

It includes diagnostic logging of the exchange during cosimulation. When the option is active, a file is created engee_logs.txt *, which is located next to *settings.cfg.

It is written to the log:

  • Current model time Euler and Engee;

  • Values of received and sent signals;

  • Diagnostic exchange messages.

The log file may be overwritten on subsequent runs. Use logging primarily for diagnostics and when contacting technical support.
Default value

true (switched on)

Program usage name

m_is_diagnostic

Tunable

No

Evaluatable

Yes

# Сгенерировать конфигурационный файл — generates a settings.cfg file for simulation

Details

Generates a configuration file settings.cfg based on the block parameters (model name, composition and names of input/output signals, parameters and logging mode). The file is used by Euler to read the simulation configuration; after generation, place settings.cfg in the Euler open project folder (*.elr).

Default value

Program usage name

m_gen_cfg

Tunable

No

Evaluatable

No