Flow routes

Modified on 2015/01/03 21:52 by Administrator — Categorized as: Design objects, Main concepts

	Flow Routes
Info
Category:	Main concepts
Role:	Scenario design

¶

The flow route is a directional link that connects two events on the same layer. Together, the routes define a flow logic: the order of events on each layer, and when the events are switching. Four types of the routes are available, depending on how they gate the event flow: ‘time’, ‘condition’, ‘time or condition’ and ‘time and condition’. The default ‘time’ routes take an account a predefined duration of the source event, whereas 3 conditional route types also rely on a conditional code that can be attached to the route. The conditional code is a logical expression, written by an user. The condition is continuously evaluated by the program at runtime and a route gets open when the expression returns true.

Table of Contents [Hide/Show]

Things To Know
Creating and managing routes
Flow route types
    Time route
    Condition route
    Time or condition route
    Time and condition route
Examples of the route conditions
    Simple conditional expression
    Composite conditional expression
Recurrent route

Things To Know ¶

Switching between two events occurs only if the 'between' route exists AND the route is open. The programs continuously evaluate all outgoing routes of the current event and opens a particular route once its conditions are met.
Flow routes allows logic branching when two or more routes originate from the same event and are controlled by different conditions.
The routes are directional, in order to make a two-events loop, two routes have to be created with opposite directions
Event that has no incoming routes will never be activated, unless it's the first event on the layer
When multiple outgoing routes become open at the same time, the first route by the creation order is used. The order can be changed in GUI

Creating and managing routes ¶

Example of flow logic

Branching
in event 3

The routes can be created and edited in the flow routes panel. Once the routes are created, the attached condition code can be edited in the flow conditions editor, which can be opened via the Snippets panel. In this editor all outgoing routes of the current event are shown in a list. The list allows changing the evaluation order of the existing routes. The route type can be always changed, such that condition code is preserved even if it's not compiled/used at runtime.

Flow route types ¶

Time route ¶

The time route gets opened automatically when a duration of the source event reaches the predefined value (see properties of event). This a default type of the flow route.

Condition route ¶

The condition route gets opened when its attached condition becomes true. The condition is specified by a logical expression written by user's. The expression can include any global or proxy variable so its bool state can be controlled programmically at runtime. If no condition specified, the route always stays closed (disabled) at runtime.

Time or condition route ¶

The time or condition route gets opened when a duration of the source event expires OR route's attached condition becomes true. If no condition specified, only the duration is evaluated. This type of route is useful for the 'response' events in experiments such that the event is set to end on participant's response or after certain time period.

Time and condition route ¶

The time or condition route gets opened when a duration of the source event expires AND route's attached condition becomes true. If no condition specified, the route is disabled. This type of route is designed for the events whose minimal duration has to be garantied.

Examples of the route conditions ¶

Simple conditional expression ¶


// RT is a global variable 
RT>0

Composite conditional expression ¶

 
// TrialNumber and ConditionNumber are global variables 
(TrialNumber==20)||(ConditionNumber>=6)

Recurrent route ¶

Recurrent link

Recurrent route is a special type of route that has the same source and target event. The recurrent routes are used to build a sequence of frames of accurate durations (e.g. RSVP streams or any animated stimuli, like the random-dot motion). The recurrent route is created in the flow route panel by dragging a link out and into the same event.