sequence
element objects
An element of type sequence is a "parent" element which you can link to any number of other elements that you have in the trial. The sequence element runs those "child" elements in a sequence, by default repeating. The sequence element starts its children, alternates between them, and ends them automatically—you don't need to set properties start/end for them.
sequence elements are mainly useful for setting up repeating sequences of elements. For regular non-repeating sequences you can generally use properties start/end (especially field endOf) of the elements directly. Also note many dynamic visual elements have properties like maxNumLoops, breakInterval, phase which allow you to loop them without using a sequence element (see for example movie elements). sequence elements are useful for setting up sequences of static visual stimuli which don't have properties like that.
▸ Object ends automatically?
By default no, the sequence repeats until a condition you set in property end. You can change this using property maxNumLoops.
If an element will end automatically, you don't need to set an end time or condition in property end. However, you can if you want to add other end conditions that could occur earlier.
No—you must set an end time or condition in property end.
elementExprs
interval
maxNumLoops
phase
All visual elements
position
depth
nn_eyes
rotation
flipHorz
flipVert
colorMask
alpha
intensity
contrastMult
convolution
shader
filterOrder
filterGrayscale
filterResolutionMult
filterGamma
channelResolution
backColor
addDisplay
All visual elements
position
All adjuster elements have
adjust
All response handler elements
translateResponse
scoreResponse
correctResponse
scoreResponseForStaircase
maxNumResponses
recordDefaultResponse
registerTrigger
autoResponse
autoResponseLatency
All elements
start
end
startBuffer
endBuffer
vary
staircase
All objects
info
report
elementExprs
No default
A string or array of strings pointing to elements to run through by their variable names and possibly indexes. You can include empties for breaks in the sequence. e.g. <cd>[<cd><cds>"pictures(1)" "" "pictures(2)" ""<cds><cd>]<cd> or <cd>{<cd><cds>'pictures(1)'<cds><cd> [] <cd><cds>'pictures(2)'<cds><cd> []}<cd>. (In the visual method you can specify a name/index for an object in its object heading, default = object type name. In the coding method it's just the variable name you use in the experiment script.)
interval
Default: 1 sec
A number that is the interval to run each element/break for before switching to the next one (sec). Or a vector for different intervals for different elements/breaks.
maxNumLoops
phase
Default: maxNumLoops = repeat until a condition you set in property end
Default: phase = start at start of sequence
maxNumLoops is a number > 0 that is number of times to repeat the sequence, after which it ends automatically. Note this number can be fractional, not just integer. <cd>inf<cd> = repeat until a condition you set in property end.
phase is start time in the sequence (sec). 0 = start. Generally use for a looping sequence if you want to set a starting point other than sequence start.
Adjustable properties
You can vary or allow the subject to adjust the following properties of an object of this type when it's running. If you need to make other properties adjustable, you can edit the element type code—see Element Type Programming Manual.
Adjustable properties
Adjustable properties
position
nn_eyes
rotation
colorMask
alpha
intensity
contrastMult
drawCodeVars
(None)
(None)
PsychBench uses record properties to record information during experiments. You can't set record properties but you can see them in experiment results using input property report.
All response handler elements
response
responseScore
responseTime
responseLatency
d_responseTime
numResponses
All elements
startTime
endTime
duration
n_startFrame
n_endFrame
startLatencyBufferable
endLatencyBufferable