Download PsyScope User Manual

14.1.1 Standard Actions
RemoveFromList[List, Index]
Given a trial variable of type List in List and an index into this list in Index, the
indexed item is removed from the list. The list is indexed starting with 1. (See also
“13.5 Trial Manager Variables”, p412.)
NewListItem[List]
This action extends the size of the trial variable list given in List; the value of the
new item in the list is undefined. (See also “13.5 Trial Manager Variables”, p412.)
14.1.1.6 Factor Format Actions
QuitBlock[Block, AccessLists]
This action is used to skip any remaining trials in the current block. The current trial
continues to execute normally.
If there are multiple levels of blocks in the experiment hierarchy, then QuitBlock[]
quits within the lowest-level block by default, continuing within that block’s owner
(if there are more blocks to execute). To quit a higher-level block, you can specify
which block to quit in Block. Alternatively, you can specify which block to quit as
a number; this number specifies how many hierarchical levels of blocks to quit
(thus, the default behavior is equivalent to specifying 1 in Block).
By default, when trials in the block are skipped, any lists connected to the blocks
are left unaccessed for the trials which are not executed. If AccessLists is set to
True, then for each factor set connected to the block and its owners, a cell is selected
for each trial that is not executed; this insures that cells are assigned to trials consistently, whether or not they are run.
QuitBlock[] does not terminate the current trial; see also “ QuitTrial[]”, p419.
RerunTrial[TrialNumber, When, Order]
This action tags the specified trial, or the current trial if none is specified, to be run
again. A trial is specified using its absolute trial number; this specification can be
in the form of a variable expression.
The When parameter specifies when the trial should be re-run; the possible values
are Mix and End. Mix specifies that the trial re-run should be mixed in with the remaining first-run trials, while End specifies that the re-run should be delayed until
all of the first-runs are done. If a trial is re-re-run with End, the second-time re-runs
will be performed after the first-time re-runs are complete.
The Order parameter specifies an order within the two When types; the possible values are Start, End, and Random. Start specifies that the trial should be re-run before any other trials currently scheduled for re-run in its set (Mix or End). End
specifies that it should be re-run after the other re-run trials. Random specifies that
it should be rescheduled at a random position within its re-run set.
423