Engee documentation

Support package Universal mechanism

The support package Universal Mechanism provides Engee with the UM solver through a client-server DLL that works in the context of the integrating solver "Universal Mechanism" and exchanges signals with Engee. The package runs on top of the subsystem Engee.Integrations.

Ports are used By default:

  • Receiving signals in UM: 7489

  • Transmitting signals from UM: 7490

Requirements

  • The subsystem is installed and running Engee.Integrations.

  • A "Universal mechanism" has been installed.

  • Integration files: Engee_UM.dll and configuration settings.cfg placed next to umsimul.exe.

  • Ports 7489 and 7490 available locally.

Quick start

  1. Install or connect the Engee subsystem.Integrations as shown in article.

  2. Create a file settings.cfg next to umsimul.exe (usually C:\Program Files\UM Software Lab\Universal Mechanism\9\bin\umsimul.exe) and set the parameters of the signals:

    MODEL_NAME OscillatorExample
    INPUT_SIGNAL_COUNT 3
    OUTPUT_SIGNAL_COUNT 3
    MODEL_PARAM_COUNT 3
    INPUT_SIGNAL_NAMES dX dY dZ
    OUTPUT_SIGNAL_NAMES Fx Fy Fz
    MODEL_PARAM_NAMES Cx Cy Cz
    INIT_MODEL_PARAM 2000 2000 2000
  3. Open an example of a harmonic oscillator: samples\tutorial\oscillator.

  4. In the "Universal Mechanism", open the Communication wizard: Tools → Interface with external libraries…​.

  5. Add a library Engee_UM.dll and map the input/output signals to the model variables in the MIND.

  6. In Engee, run the model; in "Universal Mechanism", click the "Simulation" button. The received signals will be visualized in the MIND according to the logic of the model.

  7. When the integrating solver is finished, click "Abort".