|Note||Since release 7.1, there is a time event block which should be used for events that are time-related.|
Discrete events are used by various blocks in order to trig an action. The snapshot block uses a discrete event in order to trigger the snapshot, the transfer block can specify a discrete transfer by referencing a discrete event.
The discrete event can also be used to notify the ODE solver that something drastic has happened in the model and that the solver needs to reduce the current time_step. A typical case is for models that contain conditions. In a model with a condition such as (time>t_leakage), where t_leakage is a parameter indicating when a container starts to leak, it is important that the solver includes this time point when the simulation is run.
The block has a right hand side expression and a left hand side expression. The event is triggered when these are equal. Whenever a time step is taken by the solver, the solver will see if the difference of the two expressions has changed sign since the last time step. If so, the solver will try to backtrace to the time point when they are equal. After, the solver will restart with a time step given in simulation settings as the initial time step.
From the Projects window
From the Matrix window
From the Blocks window
|Note||Most block properties can be edited directly in the blocks window.|
The block editor is shown by right-clicking the block in a window and selecting Edit. In the Blocks window, you can also show the block editor by selecting the block and clicking the button, or by double-clicking the right-most “validation” column of the block.
The block editor has three tabs:
This page lets you edit basic properties such as name, sub-system and base unit. See editing properties for more information.
|Note||When entering an expression, you can also enter names of objects that are not yet created and let Ecolego use automatic object creation to define them.|
This page lets you specify the condition for the event. It is important that the terms are put on the correct sides. The left hand side should approach the right hand side.
For the example given in the introduction, the left hand side would be “time” and the right hand side would be “t_leakage” because time will approach t_leakage from below.
Another example would be when a discrete event is used to assert that the quantity of a compartment does not decrease below a certain limit. In a transfer, the following expression is written: (Comp1>limit) · TC, where limit is the lower boundary for the compartment. In this case, Comp1 will approach limit from above, so the terms should be shifted in the discrete event: the left hand term is limit and the right hand side is Comp1.
Dimension - You can specify the dimension of the block by using the Type drop down list. Depending on the dimension the index drop down lists are activated. See editing values for more information.
Cyclic events should be modelled using time event blocks.