stop attribute

The stop command enables a script to specify conditions based on the subject's performance under which the block should be aborted.

Applies to

<block>

Syntax

/ stop = (type.name.property, operator, value)

Parameters

type.name.property Specifies the property that is evaluated by the condition, where type is the type of element, name is the name of the element on which performance should be evaluated, and property is the performance measure (e.g., "block.practicerun.meanlatency" or "block.testblock.numcorrect").
operator Specifies the operator for comparing the type.name.property and value parameters. The operator must be one of the following:

Operator Definition
EQ Equal to
GE Greater than or equal to
GT Greater than
LE Less than or equal to
LT Less than
NE Not equal to

value Specifies the value against which property is compared.

Remarks

The stop command enables a script to conditionally end a block based on the subject's performance. You may specify multiple stop commands. After each trial in the block, the stop conditions for the block are evaluated, and if any are true the block is ends. Otherwise, the block continues until the last trial is run.

Examples

The following block is interrupted if the subject gives 5 incorrect answers in a row, or if mean response latency on testtrials drifts above 1000 milliseconds:

<block myblock>
/ trials=[1-20=noreplace(testtrials, distractortrials)]
/ stop=(block.myblock.errorstreak, GE, 5)
/ stop=(trial.testtrials.percentcorrect, GE, 1000)
</block>


Send comments on this topic.
1999-2006 Millisecond Software, LLC. All rights reserved.