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.
To add a block to the model, drag it from the Block Library to the workspace using the left mouse button.
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.
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).
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.
-
click Ctrl+ЛКМ on an already completed link to create branches:
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.
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 .
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.
You can run models with unconnected blocks and lines on the canvas. |
Parameters as expressions
Block parameters can be configured using expressions. To do this, in script editor or command line
, define a variable on which to base an expression. For example:
-
On the command line, assign the
t
variable the value5
: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:
-
In the graph window, see the simulation results:
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.
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;
-
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.
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 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:
Features disabling and skipping Engee blocks:
|
Bookmarks in models
Bookmarks allow you to quickly navigate between different models and nesting levels. To add a bookmark, click the icon Make screenshot 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:
-
Open List - displays all saved bookmarks that can be used for navigation. You can also rename or delete bookmarks in the list:
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.