eldo_user

Eldo Control Language
Simulation Dynamic Control
Simulation Dynamic Control
A callback mechanism is provided to temporarily stop the simulation at specific times to let the
user execute some ECL commands to monitor the simulation. The way to get simulation results
inside this callback is different to the simulation function method: you must explicitly use some
predefined functions to obtain the results you want to access.
Callback functions can use and modify variables of the calling task but the syntax may be quite
heavy, especially if there are many variables to manage. This is why some simulation control
functions are also provided to replace the simulation function and work directly in the main
task.
Limitations:
• Dynamic control is only allowed over one simulation at a time.
• Eldo Premier is not compatible with the functionality inside this Simulation Dynamic
Control section. An error message will be output if callbacks or flow-control functions
are used with Eldo Premier.
• Callback functions are restricted to transient analyses.
This section is divided into the following:
• Callback Functions
• Extended Simulation Functions
Callback Functions
A callback function can be defined and associated to a simulation function so that it is executed
at predefined time intervals during a transient analysis.
The callback function is an ECL user-defined function (or task). It can be assigned to a
“simulation” function using the “callback” argument or the simulation function. When setting
this argument, another argument is required which defines the condition when this callback will
be called. This argument must be chosen from among the following five arguments:
• progress_period
Its value must be a number and stands for the percentage of simulation that has to be
reached before calling the callback. For example, setting progress_period=20 means to
execute the callback function when 20%, 40%, 60%, 80% and 100% of the simulation
have been computed.
• elapsed_s_period
1014
Eldo® User's Manual, 15.3