Comment on page
Adding restrictions to the 2D Model
There are three types of restrictions:
- 1.Time restrictions. For example, a time limit to complete a task or a specific action in a specific time frame.
- 2.Spatial. For example, adding regions ("Start", "Finish") or prohibiting/forcing a robot, its sensor, or some moving object to be at a certain time in a certain place.
- 3.Device restrictions. For example, a limitation on the set of sensors or on the behavior of devices.
The main tag
<constraints>...</constraints>
which contains all the restrictions is used to describe them. Used as a container. Restrictions are described inside the tag, each inner tag must be one of four:Tag | Description |
Time limit. | |
A constraint with an arbitrary condition in violation of which a specified error will be generated. | |
The main tool for setting dynamic constraints. Used as a container. | |
An unconditional event that runs before the program starts executing. |
The main tag containing all restrictions. Used as a container.
<constraints>
<!-- Time limit -->
<timelimit value="30000"/>
<!-- Conditional constraint. An error message will be shown at violation. -->
<constraint checkOnce="true" failMessage="The robot must be at start before run!">
<inside objectId="robot1" regionId="start_zone"/>
</constraint>
<!-- Initializing variable x with value 2 -->
<init>
<setter name="x">
<int value="2"/>
</setter>
</init>
</constraints>
Time limit. Mandatory.
Attribute | Description |
value="value" | Timeout in milliseconds after which the execution will be terminated and the "Time limit exceeded" error will be displayed. |
<timelimit value="35000"/>
A constraint with an arbitrary condition. If the condition is violated a specified error message will be displayed. Can be used as a container. Has one child tag:
<conditions>...</conditions>
.Attribute | Description |
checkOnce="true" | Boolean attribute. If the value is true, then the restriction will be checked once at program startup. Is useful for one-time checks such as sensor layout etc. |
failMessage="Error!" | An error message will be displayed when a restriction is violated. |
<constraint checkOnce="true" failMessage="The robot must be at start before run!">
<!-- Checks if the IR distance sensor is connected to the A1 port -->
<constraint checkOnce="true" failMessage="The IR distance sensor must be connected to the robots A1 port!">
<equals>
<typeOf objectId="robot1.A1"/>
<string value="twoDModel::robotModel::parts::RangeSensor"/>
</equals>
</constraint>
<!-- Checks if the robot is inside the specified region for the entire program execution time-->
<constraint failMessage="The robot has left the allowed zone!">
<inside objectId="robot1" regionId="warzone"/>
</constraint>
The main tool for setting dynamic constraints. Used as a container.
Attribute | Description |
settedUpInitially="true" | An attribute that allows you to indicate whether the event is set up at the start of the program. The event can be set up or dropped. In the setup state, the event pulls its trigger if its condition is met, otherwise it's just ignored by the system. The default value is false. |
id="finish checker" | Events unique ID. The event can be referred by id from others. Optional. |
dropsOnFire = "true" | A boolean attribute that indicates whether the event should continue to be set up after it is triggered or not. Optional. The default value is true. |
<event id="finish checker" settedUpInitially="false">
<condition>
<inside objectId="robot1" regionId="finish"/>
</condition>
<trigger>
<success/>
</trigger>
</event>
Unconditional event executing before the program starts.
Example:
<!-- Setting the "my_value" variable to the value of two-->
<init>
<setter name="my_value">
<int value="2"/>
</setter>
</init>
Now lets talk about the conditions in the <constraint> and <event> elements. Conditions are set using the <condition> tag if only one of the atomic conditions is tested, or the <conditions> tag if a compound condition is tested.
The condition being checked is described inside this tag.
Example:
<condition>
<!-- The condition of equality of two values is described inside the tag -->
<equals>
<objectState object="robot1.display.smiles"/>
<bool value="true"/>
</equals>
</condition>
Used to create compound conditions. The logical bond is the mandatory attribute. The bond may be
and
or or
. Negation is specified by the <not>
tag without attributes. Other <conditions>
elements may also appear among subexpressions.Attribute | Description |
glue="and" | Logical bond. |
<conditions glue="and">
<!-- Condition1 -->
<!-- Condition2 -->
<!-- ... -->
<!-- ConditionN -->
</conditions>
<conditions glue="and">
<not>
<!-- Condition1 -->
</not>
</conditions>
<conditions glue="and">
<timer timeout="1000" forceDropOnTimeout="true"/>
<conditions glue="or">
<greater>
<objectState object="robot1.display.labels.size"/>
<int value="20"/>
</greater>
<less>
<objectState object="robot1.display.labels.size"/>
<int value="19"/>
</less>
</conditions>
</conditions>
Atomic condition is one of the following elements:
Equals. The functional symbols value comparison operation. Can be used as a container.
<equals>
<objectState object="robot1.display.labels.first.text"/>
<string value="finish"/>
</equals>
Not equal. The functional symbols value comparison operation. Can be used as a container.
<notEqual>
<objectState object="robot1.display.labels.first.text"/>
<string value="finish"/>
</notEqual>
Greater. The functional symbols value comparison operation. Can be used as a container.
<greater>
<objectState object="robot1.display.labels.size"/>
<int value="0"/>
</greater>
Less. The functional symbols value comparison operation. Can be used as a container.
<less>
<objectState object="robot1.display.labels.size"/>
<int value="10"/>
</less>
Sets spatial constraints.
Attribute | Description |
objectId="id" | Object ID. |
regionId="id" | Region ID. |
<!-- Limits the location of the "robot1" robot to the "start" zone -->
<inside objectId="robot1" regionId="start"/>
Checks whether the event set up or not.
Attribute | Description |
id="event1" | The ID of the event is checked |
<!-- The "event1" event is set up condition -->
<condition>
<settedUp id="event1"/>
</condition>
<!-- The "event2" event is dropped condition -->
<condition>
<dropped id="event2"/>
</condition>
The "check event" event conditions check that the other "Try move" event is set up and the "Go back" event is dropped. If both of them return "true" after the check the program successfully ends.
<event id="check event" settedUpInitially="true">
<conditions glue="and">
<settedUp id="Try move"/>
<dropped id="Go back"/>
</conditions>
<trigger>
<success/>
</trigger>
</event>
A predicate that starts to return "true" when the specified time has passed since the moment when this event was set, and up to that moment it returns "false".
Attribute | Description |
timeout="1000" | The time interval after which this predicate will become true. Mandatory. The value must be a non-negative integer. |
forceDropOnTimeout="true" | A Boolean attribute that allows you to drop the event that has this timer in a condition. If set to true, the event will be dropped even if there are other active timers and unmet conditions. Optional. The default value is true. |
<timer timeout="1000" forceDropOnTimeout="false"/>
Let's look at using <timer/> with different forceDropOnTimeout attribute values.
The "check region" event checks time and spatial limits. The first condition (timer) becomes true after 1000ms. Its value doesn't change after that. The second one (inside) checks that the robot is inside the "start_zone" region. When both conditions will be met simultaneously the program will end successfully.
1. Since the forceDropOnTimeout attribute is "false", the event will be still set up after a specified timeframe and wait for the second condition to be met.
<event id="check region" settedUpInitially="true">
<conditions glue="and">
<timer timeout="1000" forceDropOnTimeout="false"/>
<inside objectId="robot1" regionId="start_zone"/>
</conditions>
<trigger>
<success/>
</trigger>
</event>
2. Since the forceDropOnTimeout attribute is "true", the event will be dropped after the specified timeframe despite the presence of a second condition. Therefore, if the robot is not in the required region right after 1000 ms, then the success message will not be displayed even if the robot will be there after some time.
<event id="check region" settedUpInitially="true">
<conditions glue="and">
<timer timeout="1000" forceDropOnTimeout="true"/>
<inside objectId="robot1" regionId="start_zone"/>
</conditions>
<trigger>
<success/>
</trigger>
</event>
Variable or operation | Description |
Integer, fractional, string, and boolean constants. | |
Variable value. | |
Get the object state. | |
Get the meta-type of the object with the specified identifier. | |
Unary arithmetic functions that have exactly one child, which must be an integer value. | |
Binary arithmetic functions that have exactly two child elements, each of them must be an integer. |
Setting a constant.
Attribute | Description |
value="0″ | Constant value. |
<int value="0"/>
<string value="finish"/>
Variable value.
It is possible to take the property of any variable using a dot. For example, "rect.width" will return the width of the rectangle stored in "rect".
Attribute | Description |
name="my_value" | Variable name |
<variableValue name="rotation"/>
Get the object state.
Attribute | Description |
object="robot1.display.labels.size" | Object ID |
<objectState object="robot1.display.labels.first.text"/>
<!-- Assign to the "rotation" variable the robots rotation angle -->
<setter name="rotation">
<objectState object="robot1.rotation"/>
</setter>
<!-- Checking if the "rotation" value equals to the robots rotation angle -->
<equals>
<variableValue name="rotation"/>
<objectState object="robot1.rotation"/>
</equals>
Get the objects with specified ID meta-type. For example, the type of the
wall
object with id=777
will be wall
.Most often, this element will be needed to check the type of connected sensors and motors.
Attribute | Description |
objectId="id" | Objects unique ID. |
<typeOf objectId="robot1.A3"/>
Unary arithmetic operations for changing the sign and taking the modulus of a number.
<minus>
<objectState object="robot1.rotation"/>
</minus>
<abs>
<objectState object="robot1.rotation"/>
</abs>
<!-- Modulus of the difference of the "rotation" variable and the robots rotation angle -->
<abs>
<difference>
<variableValue name="rotation"/>
<objectState object="robot1.rotation"/>
</difference>
</abs>
Sum and difference of values. Minimum and maximum value.
<!-- The difference of the "rotation" variable and the robots rotation angle -->
<difference>
<variableValue name="rotation"/>
<objectState object="robot1.rotation"/>
</difference>
<!-- The sum of the "counter" variable and one -->
<sum>
<variableValue name="counter"/>
<int value="1"/>
</sum>
Tag | Description |
An action or a group of actions that will be performed one or many times after the event condition is met. | |
Display an error message. Finish checking the task. | |
Display success message, finish the check. | |
Set the variable value. | |
Setting or dropping the event. |
An action or a group of actions that will be performed one or many times after the event condition is met.
<trigger>
<success/>
</trigger>
Display an error message. Finish checking the task.
Attribute | Description |
message="Wrong answer!" | Error message text |
<fail message="Wrong answer!"/>
The task is successfully done.
Attribute | Description |
deffered="false" | Optional. The default value is "false". If set to "true" the trigger won't stop the program, I. e. the checker will wait until the program finishes and either reports the success if there were no errors, or otherwise, it will finish with an error. In other words, you won't get the error "The program has finished, but the task is not completed": the program will either terminate successfully or with a meaningful error like "Time limit exceeded". |
<success/>
Set the variable value.
Attribute | Description |
name="my_value" | Variable name |
<!-- Creating the "total_score" variable with the value of zero -->
<setter name="total_score">
<int value="0"/>
</setter>
<!-- Addind 2 to the "total_score" -->
<setter name="total_score">
<sum>
<variableValue name="total_score"/>
<int value="2"/>
</sum>
</setter>
Setting up or dropping an event.
Attribute | Description |
id="finish checker" | The ID of the event. |
<!-- Set up the "finish checker" event -->
<triggers>
<setUp id="finish checker"/>
</triggers>
Name | Description |
twoDModel::robotModel::parts::RangeSensor | Distance sensor |
trik::robotModel::twoD::parts::TwoDLightSensor | Light sensor |
twoDModel::robotModel::parts::TouchSensor | Touch sensor |
trik::robotModel::twoD::parts::LineSensor | Line sensor |
Name | Description |
twoDModel::robotModel::parts::RangeSensor | Distance sensor |
twoDModel::robotModel::parts::LightSensor | Light sensor |
twoDModel::robotModel::parts::TouchSensor | Touch sensor |
twoDModel::robotModel::parts::ColorSensorRed | Color sensor (red) |
twoDModel::robotModel::parts::ColorSensorGreen | Color sensor (green) |
twoDModel::robotModel::parts::ColorSensorBlue | Color sensor (blue) |
twoDModel::robotModel::parts::ColorSensorPassive | Color sensor (passive) |
twoDModel::robotModel::parts::ColorSensorFull | Color sensor EVX/NXT (color) |
twoDModel::robotModel::parts::ColorSensorAmbient | Color sensor EV3 (ambient) |
ev3::robotModel::twoD::parts::GyroscopeSensor | Gyroscope |
ev3::robotModel::twoD::parts::GyroscopeSensor | Compass |
Property | Description |
robot1.rotation |