Engee documentation

Model building

Adding and connecting blocks

A mathematical model in Engee represents blocks of different mathematical operations arranged on a workspace and connected by links.

To go to the list of available blocks, click the icon Library.

img17

To add a block to the model, drag it from the Block Library to the workspace using the left mouse button.

block adding 1

A mathematical model usually consists of a source block that generates data (e.g. Sine Wave Function), a processor block (e.g. Saturation) and a receiver block (e.g. Terminator).

To select multiple blocks, hold Shift and the left mouse button, move the cursor to select the desired blocks.

vydelenie blokov

To transfer data between blocks, connections between block output and block input are used. The arrow pointing out of the block indicates the data output (1), pointing into the block - the input (2).

in out

There are several ways to connect blocks:

  • Click and hold the left mouse button on the output of one block, move the cursor to the input of the next block and release the mouse button.

  • Drag one block to another, an interactive hint (light green line) will appear, which is not yet a connection. Left-click to turn it into a full-fledged link.

    soedinenie blokov

  • click Ctrl+ЛКМ on an already completed link to create branches:

    model branching

There can be more than one block of each type in the model. For example, you can add another handler block and receiver block by connecting them to existing blocks in the model.

img19

Configuring block parameters

To go to the block settings, double left-click on the required block, or left-click on the block and press Settings img10.

img20

After that the module window will open *Settings*in which you can set the parameters of the block by editing the corresponding fields and selecting items in the drop-down lists.

img21

You can run models with unconnected blocks and lines on the canvas.

rn 2024 vo 11

Parameters as expressions

Block parameters can be configured using expressions. To do this, in script editor interactive script icon or command line img 41 1 2, define a variable on which to base an expression. For example:

  • On the command line, assign the t variable the value 5:

    build a model params

    The variables window will display all created variables and their values.

  • In the block settings, select the required parameters and enter an expression with the previously defined variable:

    build a model params 1

  • In the graph window, see the simulation results:

    build a model params 2

Creating a model hierarchy using subsystems

For convenient visualisation of the mathematical model you can use the block Subsystem. This is necessary when the number of blocks in the model is so large that it becomes inconvenient to work with them.

img18

img21a

To add a subsystem, you can:

  • highlight the blocks you want to add to the subsystem, press the multi-dot and then the icon subsystem icon 1 1 Subsystem;

    subsystem creation

  • add block Subsystem from the block library, double-click on it with the left mouse button (so you will enter the subsystem) and add the required blocks in the standard way.

Within one subsystem you can create an unlimited number of other subsystems at different nesting levels. As a result, the model has a hierarchy. To navigate through different levels of the model use Navigation panel.

model hierarchy 3 1

Disconnecting and skipping blocks

You can disable or skip blocks of the Engee workspace:

  • Comment Out - function is the same as if the block did not exist in the model. This means that the block is disabled and its presence does not affect the behaviour of the model:

    comment out 1

  • Comment Through - the function is the same as if the inputs of the block are directly connected to its outputs. This means that the block is skipped and data flows through it unchanged. This is equivalent to connecting all block inputs directly to the corresponding block outputs:

    comment through 1

Features disabling and skipping Engee blocks:

  • You cannot disable library blocks Physical Modeling;

  • You cannot disable or skip links;

  • You cannot skip blocks with different numbers of inputs/outputs;

  • You cannot disable input and output ports.

Bookmarks in models

Bookmarks allow you to quickly navigate between different models and nesting levels. To add a bookmark, click the icon Make screenshot icon screenshot 1 and select a section Bookmarks. Two options are available in this bookmark section:

  • Add Bookmark - the system saves the current position in the model. After that, a screenshot of the bookmark will appear in the lower right corner, where you can change its name or delete it:

    bookmark 1

  • Open List - displays all saved bookmarks that can be used for navigation. You can also rename or delete bookmarks in the list:

    bookmark 2

To navigate to a bookmark, select the desired one from the list and double-click on it with the left mouse button. If necessary, use the search by name.