expt element

The expt element defines a sequence of blocks and instruction pages to be run.

Syntax

<expt exptname>
/ blocks = [blocknumber, blocknumber = blockname;blocknumber = list.name; blocknumber-blocknumber = selectmode(blockname, blockname,...); blocknumber, blocknumber-blocknumber = blockname]
/ correctmessage = false or true(stimulusname, duration)
/ datastreams = (eyetracker) or eyetracker or false
/ errormessage = false or true(stimulusname, duration)
/ groupassignment = assignment
/ groups = (integer, integer, integer, ... of modulus)
/ onblockbegin = [expression; expression; expression; ...]
/ onblockend = [expression; expression; expression; ...]
/ onexptbegin = [expression; expression; expression; ...]
/ onexptend = [expression; expression; expression; ...]
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ postinstructions = (pagename, pagename, pagename, ...)
/ preinstructions = (pagename, pagename, pagename, ...)
/ quit = [expression; expression; expression; ...]
/ recorddata = boolean
/ response = responsename or timeout(milliseconds) or window(center, width, stimulusname) or responsemode
/ screencapture = boolean
/ sessions = (integer, integer, integer, ... of modulus)
/ showmousecursor = boolean
/ skip = [expression; expression; expression; ...]
/ soundcapture = boolean
/ stop = [expression; expression; expression; ...]
/ subjects = (integer, integer, integer, ... of modulus)
/ timeout = integer expression
</expt>

Properties

Functions

None.

Remarks

The primary function of the expt element is to define a randomly selected or sequentially ordered set of blocks to run. The expt element also controls whether instructions are provided at the beginning and end of the script.

Examples

The following expt runs one practice block followed by ten test blocks. An "intro" instruction page is displayed at the beginning of the script, and an "end" instruction page is displayed at the end.

<expt>
/ blocks=[1=practice; 2-11=test]
/ preinstructions = (intro)
/ postinstructions = (end)
</expt>