Old Roulette Element

Modified on 2018/08/29 04:05 by Administrator — Categorized as: Base Elements, Deprecated, Elements

Summary

Element Icon Old Roulette
Info
Category: Deprecated AddIn: Base Layer
Creator: OkazoLab Scope: Parent event
Owns Snippets: None Usage: Snippets

Properties

NameDescription                              ConstraintsTypeOn
runtime
change
Randomization
Min value        The minimal integer value that generated random numbers can take. Has to be less than the Max Value property. Change in runtime causes generating a new block of random numbers                Int32         
Max value        The maximum integer value that generated random numbers can take. Has to be greater than the Min Value property. Change in runtime causes regeneration of a block                Int32         
Value frequences        The frequences that denote a relative probabaility for each integer number in the range Min Value,Max Value to be included in a block.The frequences and the total amount of possible integer numbers define the block size. Change in runtime causes regeneration a block                IList         
Block Length        Total length of the random block estimated with the current properties.                Int64         
Blocking        If true, the random values are generated in the balanced block, with fixed number of occurences. If false, the random values are drawn                 Boolean         
Factors        Factorial design for random numbers. Each random number is represented decomposed on factors in Factored Random Value property                String         
No Repetition        If true, the last value of each block will be always different with the first value of the following block                Boolean         
colspan="5" bgcolor="#AADDDDD" |   
                          String         
Runtime Status
Index in block        Index of the current random value in a random block                Int32         
Current Block        Index of the current random block                UInt32         
Block completed        Is true when the last value for the current random block is just taken. A new block will be generated for the next activation of the parent event.                Boolean         
Runtime Actions
Force new block        Set to true in order to generate a new block immediately (note: new values will be accesible on the next activation only)                Boolean         
Cancel value        Set this parameter to true in runtime in order to cancel the current random value withdrawal.                Boolean         
Runtime Output
Random Value        Returns a random value in the current position of the random block. Each activation of the parent event shift this position to the next numebr in a random block.                Int32         
Random Values        Returns an entire block of random values as an ordered array of integers. This property changes only when the block is regenerated.                Int32[]         
Factored Random Value        Returns the current random value as an array of factors                Int32[]         
Control
Is Enabled        If set to false the element is completely omitted when the experiment is run                Boolean         
Title        Title of the element                String         

Old Roulette Element is an element that is designed to produce flexible randomization scenarios in your experiment. In the simplest case it works as a random number generator.
Warning! This element is deprecated, use the new Roulette element instead.


Description

In the simplest case it works as a random number generator. For more complicated scenarios it can generate the balanced random blocks of integer numbers and provides a runtime control over them. A simple roulette random number generator can be created by choosing an appropriate event and selecting EventAdd Element command and selecting Roulette under the Design section.

Practical Use

A Simple Random Number Generator

Many experiments require the use of simple random number generators for independent, non-blocked features of the design. In a visual task for example it may be necessary to randomly rotate the stimuli on each trial. This factor is unrelated to the experimental factors that will be manipulated in the design (see next section). Once the new Roulette element has been added, it is necessary to amend certain properties in order to get it to behave as appropriately. If the random number generator is simply that, then it is necessary to set the range of the random numbers that are desired in the Factors box by specifying the highest number in the range and placing the letter x behind it. If a stimulus is going to be rotated by a random number of degrees upon each trial for example, then we would set the factors box to read “360x”.

It is of course necessary to specify via code, the parameter that will be controlled by the random number that has been generated.

Experimental Factors and Blocking

Most experiments will have a roulette counter to ensure that the main experimental factors are randomly presented, a specific number of times, within each block. If, under the Roulette properties, the property for Blocking is set to ‘True’, then the main levels of the experimental variables can be defined. Under Factors the levels of each experimental variable should be written as ‘2x3x3’ or ‘2x2’ etc. The Block Length will then be calculated, and if a certain variable should be more frequent then others, then this can be manipulated via the Value Frequencies option.

It is of course necessary to assign the output of the Factored Random Value as a multiparameter array (see Parameters and then in the code snippets, assign the individual parameters of this array to variable names. It is then necessary to specify what the properties of these parameters should be, in the differing levels of each variable. See the bottom of this page for a more detailed example.

In the example below, Blocking is set to "true", and the experimental design in outlined in the Factors box as 2x2x2x3x4. A multi parameter array named ‘fRandomValue’ (visible in orange) has been assigned to the property Factored Random Value. The individual parameters of this array have been assigned specific names in the snippets box. The last factor (x4) has not been defined. This means that each of the conditions that have been defined, will be repeated 4 times – thus lengthening the duration of each block. Given that the first parameter in the array ‘TContrast’ can be only one of two values (as defined in the Factors box), only four simple lines of code are required to specify what EventIDE should do for each of the 2 levels of this factor. In this example, the shared ‘Colormask’ property of three different elements has been assigned as a multi-parameter array, and the RGB values of this color mask manipulated as required. See the section parameters for more information on manipulating the properties of individual elements.


TContrast=fRandomValue[0];
DContrast=fRandomValue[1];
OContrast=fRandomValue[2];
Distance=fRandomValue [3];