trial element

Attributes

<trial name>
/ beginResponseFrame = integer
/ beginResponseFrame = expression
/ beginResponseTime = integer
/ beginResponseTime = value
/ correctResponse = (character, character,...)
/ correctResponse = (scancode, scancode, ...)
/ correctResponse = (anyResponse, noResponse, ...)
/ correctResponse = (stimulusname, stimulusname, ...)
/ correctResponse = (mouseevent, mouseevent, ...)
/ correctResponse = (gamepadstickevent, gamepadevent, ...)
/ correctResponse = (joystickevent, joystickevent, ...)
/ correctResponse = (word, word, ...)
/ correctResponse = (response)
/ correctResponse = (expression, expression, ...)
/ draw = stimulusname
/ dropSources = (stimulus, stimulus, expression, expression, ...)
/ dropTargets = (stimulus, stimulus, expression, expression, ...)
/ inputDevice = device
/ inputMask = mask
/ isCorrectResponse = { script }
/ isValidResponse = { script }
/ monkeyResponse = (character, character,...)
/ monkeyResponse = (scancode, scancode, ...)
/ monkeyResponse = (anyResponse, noResponse, ...)
/ monkeyResponse = (stimulusname, stimulusname, ...)
/ monkeyResponse = (mouseevent, mouseevent, ...)
/ monkeyResponse = (gamepadevent, gamepadevent, ...)
/ monkeyResponse = (joystickevent, joystickevent, ...)
/ monkeyResponse = (word, word, ...)
/ monkeyResponse = (keyword)
/ monkeyResponse = (expression, expression, ...)
/ postTrialPause = integer
/ postTrialPause = expression
/ postTrialSignal = (modality, signal)
/ postTrialSignal = (mouse, stimulusname)
/ postTrialSignal = (mouse, mouseevent)
/ preTrialPause = integer
/ preTrialPause = expression
/ preTrialSignal = (modality, signal)
/ preTrialSignal = (mouse, stimulusname)
/ preTrialSignal = (mouse, mouseevent)
/ responseInterrupt = mode
/ responseMessage = bool(responsevalue, stimulusname, duration)
/ responseMessage = (responsevalue, stimulusname, duration)
/ stimulusFrames = [framenumber = stimulusname, stimulusname, ...; framenumber = stimulusname, ...]
/ stimulusFrames = [framenumber = listname]
/ stimulusFrames = [framenumber = selectMode(stimulusname, stimulusname, stimulusname, ...)]
/ stimulusTimes = [time = stimulusname, stimulusname, ...; time = stimulusname, ...]
/ stimulusTimes = [time = listname]
/ stimulusTimes = [time = selectMode(stimulusname, stimulusname, stimulusname, ...)]
/ stop = { script }
/ trialDuration = integer
/ trialDuration = expression
/ undoDraw = { script }
/ validResponse = (character, character,...)
/ validResponse = (scancode, scancode, ...)
/ validResponse = (anyResponse, noResponse, ...)
/ validResponse = (stimulusname, stimulusname, ...)
/ validResponse = (mouseevent, mouseevent, ...)
/ validResponse = (gamepadevent, gamepadevent, ...)
/ validResponse = (joystickevent, joystickevent, ...)
/ validResponse = (word, word, ...)
/ validResponse = (keyword)
/ validResponse = (expression, expression, ...)
/ branch = { script }
/ correctMessage = true(stimulusname, duration)
/ correctMessage = false
/ dataStreams = (datastream, eyetracker)
/ dataStreams = false
/ errorMessage = true(stimulusname, duration)
/ errorMessage = false
/ onTrialBegin = { script }
/ onTrialEnd = { script }
/ photoCapture = boolean
/ quit = { script }
/ recordData = option
/ response = responsename
/ response = timeout(milliseconds)
/ response = window(center, width, stimulusname)
/ response = responsemode
/ screenCapture = boolean
/ showMouseCursor = boolean
/ skip = { script }
/ soundCapture = boolean
/ stop = { script }
/ timeout = integer
/ timeout = expression
</trial>

Properties

trial.name.altLatency
trial.name.beginResponseFrame
trial.name.beginResponseTime
trial.name.inputMask
trial.name.lastDropLatency
trial.name.lastDropSource
trial.name.lastDropTarget
trial.name.postTrialPause
trial.name.preTrialPause
trial.name.trialCode
trial.name.trialDuration
trial.name.correct
trial.name.correctCount
trial.name.correctStreak
trial.name.count
trial.name.elapsedTime
trial.name.error
trial.name.errorCount
trial.name.errorStreak
trial.name.inWindow
trial.name.inWindowCount
trial.name.inWindowStreak
trial.name.lastPhotoCapturePath
trial.name.lastScreenCapturePath
trial.name.lastSoundCapturePath
trial.name.latency
trial.name.maxLatency
trial.name.meanLatency
trial.name.medianLatency
trial.name.minLatency
trial.name.notInWindow
trial.name.notInWindowCount
trial.name.notInWindowStreak
trial.name.percentCorrect
trial.name.photoCapture
trial.name.recordData
trial.name.response
trial.name.responseMonitor
trial.name.responseText
trial.name.responseX
trial.name.responseY
trial.name.screenCapture
trial.name.sdLatency
trial.name.showMouseCursor
trial.name.soundCapture
trial.name.sumLatency
trial.name.timeout
trial.name.timestamp
trial.name.totalCorrectCount
trial.name.totalCount
trial.name.totalErrorCount
trial.name.totalMaxLatency
trial.name.totalMeanLatency
trial.name.totalMedianLatency
trial.name.totalMinLatency
trial.name.totalNumCorrect
trial.name.totalPercentCorrect
trial.name.totalSDLatency
trial.name.totalSumLatency
trial.name.totalTrialCount
trial.name.totalVarLatency
trial.name.trialCount
trial.name.varLatency
trial.name.windowCenter
trial.name.windowDecThreshold
trial.name.windowDecUnit
trial.name.windowHitDuration
trial.name.windowIncThreshold
trial.name.windowIncUnit
trial.name.windowMaxCenter
trial.name.windowMinCenter
trial.name.windowOffset
trial.name.windowOnset
trial.name.windowWidth
trial.name.name
trial.name.typeName

Functions

trial.name.clearStimulusFrames
trial.name.insertStimulusFrame
trial.name.insertStimulusTime
trial.name.removeStimulusFrame
trial.name.removeStimulusTime
trial.name.resetStimulusFrames
trial.name.setStimulusFrame
trial.name.setStimulusTime
trial.name.stimulusFrame
trial.name.stimulusTime

Remarks

The trial element is the primary tool for controlling the flow of an experimental task. Trials allow customization of stimulus presentation, response procedure, time constraints, and response feedback. Each time a trial is executed, a line of data is written to the data file. Inquisit supports a number of specialized kinds of trials that provide a simple way to configure specific, commonly used types of tasks. Specialized trials include openended, likert, and surveypage.

Examples

The following trial runs <em>happytrial</em> if the response is "a" and <em>sadtrial</em> if the response is "b":

<trial myTrial>
/ stimulusTimes = [0=myText]
/ validResponse = ("a", "b")
/ responseTrial = ("a", happytrial)
/ responseTrial = ("b", sadtrial)
</trial>

The following trial presents a rapid series of 5 pictures at 10 millisecond intervals. The subject may respond by clicking the left or right mouse button. If the left button is clicked, an error message appears. If the right button is clicked, a correct message appears.

<trial myTrial>
/ stimulusTimes = [0=pic1; 10=pic2; 20=pic3; 30=pic4; 40=pic5]
/ inputDevice = mousekey
/ validResponse = (lButtonDown, rButtonDown)
/ errorMessage = (redx, 500)
/ correctMessage = (greenstar, 500)
</trial>