Assert

The assert statement provides a convenient means for specifying checks on model validity within a model. The assert expression in an assert statement or equation should normally evaluate to true. When the assertion evaluates to false, the message in the second argument will be displayed to the user and the simulation will stop. The class AssertTest contains an example of the use of assert.

class AssertTest parameter Real lowlimit; parameter Real highlimit; Real x = 5; algorithm assert(x >= lowlimit and x <= highlimit, "Variable x out of limit"); end AssertTest;
class Test1 AssertTest assertTest(lowlimit = 4, highlimit = 8); end Test1;
class Test2 AssertTest assertTest(lowlimit = 6, highlimit = 20); end Test2;

1 Simulation of Test1 and Test2

simulate( Test1 )
plot( { assertTest.x, assertTest.highlimit, assertTest.lowlimit })

In the simulation of Test2 we see that an error occurs and by looking in the file ??dslog.txt we see that the assertion fails and returns the message "Variable x out of limit".

simulate( Test2, stopTime=10 )