columns attribute

Member of

<data> <dataStream>

Syntax

/ columns = (columnname, columnname, columnname, property, property, property)

Parameters

Name	Type	Description
columnname	datacolumnenum	Value Description blockCode The Name of the current block blockNum The current block number. blockTimeout The current block timeout value in milliseconds. build The Inquisit release version. correct 1 if the response was correct, 0 if it was an error. correctCount The number of correct responses in the current block. correctStreak The number of consecutive correct responses in the current block. date The current date. error 1 if the response was an error, 0 if it was correct. errorCount The number of error responses in the current block. errorStreak The number of consecutive error responses in the current block. group The group id. inWindow 1 if the response was in the window, 0 if it was not. latency The response time in milliseconds. maxLatency The longest response time in the current block. meanLatency The average response time in the current block. medianLatency The median response time in the current block. minLatency The shortest response time in the current block. percentCorrect The percent of correct responses in the current block. posttrialPause The postrialpause value for the current trial. pretrialPause The pretrialPause value for the current trial. response The response for the current trial. responseMonitor The number of the monitor of the last mouse response in the current block. responseText The response as text for the current trial. responseX The vertical coordinate in pixels of the last mouse response in the current block. responseY The horizontal coordinate in pixels of the last mouse response in the current block. sdLatency The standard deviation of response times in the current block. session The session number. stimulus The stimulus item presented on the current trial (same as stimulusItem). stimulusItem The stimulus item presented on the current trial. stimulusNumber The index of the stimulus item presented on the current trial. stimulusOnset The onset of the stimulus presented on the current trial. subject The participant identifier. sumLatency The sum of response times in the current block. time The current time. totalCorrectCount The total number correct responses in the experiment. totalErrorCount The total number of error responses in the experiment. totalMaxLatency The longest response time in the experiment. totalMeanLatency The average response time in the experiment. totalMedianLatency The media response time in the experiment. totalMinLatency The shortest response time in the experiment. totalPercentCorrect The percent of correct responses in the experiment. totalSDLatency The standard deviation of response times in the experiment. totalSumLatency The sum of response times in the experiment. totalVarLatency The variance of response times in the experiment. trialCode The name of the current trial. trialDuration The duration of the current trial. trialNum The current trial number. trialTimeout The current trial timeout in milliseconds.
property	value	Any property of any element may be listed as a data column.

Remarks

The columns attribute specifies the data values to be recorded to file and the column in which they are written. There are three types of columns that can be listed: 1) a reserved keyword representing a particular data value, and 2) any property of any element defined in the script. The data values may be specified in any order. On each trial, Inquisit will write a single line of data consisting of each data value specified by the column. Columns will appear in the data file in the specified order.

Stimulusnumber, stimulusItem, and stimulusOnset receive special treatment.

The first stimulusnumber specified in the columns attribute indicates that the item number of the first stimulus appearing on the current trial should be recorded. The second stimulusnumber indicates that the item number of the second stimulus presented on the trial should be recorded, and so on. If no 1st, 2nd, 3rd, etc. stimulus is presented on a given trial, a '0' is recorded.

Similarly, the first stimulusItem specified in the columns attribute indicates that the actual item presented by the first stimulus appearing on the current trial should be recorded. If the stimulus is <text> or <port>, the actual item is recorded. If the stimulus is a <sound>, <picture>, or <video>, the item’s fileName is recorded. If the stimulus is a <shape>, the name of the shape is recorded. Like stimulusnumber, each successive stimulusItem records the item from each successive stimulus presented on the trial. If no 1st, 2nd, 3rd, etc. stimulus is presented on a given trial, a '0' is recorded.

Similarly, the first stimulusOnset specified in the columns attribute indicates that the onset time of the first stimulus appearing on the current trial should be recorded. Like stimulusnumber, each successive stimulusOnset records the onset time for each successive stimulus presented on the trial. If no 1st, 2nd, 3rd, etc. stimulus is presented on a given trial, a '0' is recorded.

Examples

The following records 10 columns to the data file:

<data>
/ columns=(group, subject, computer.ipAddress, blockcode, trialcode, trialnum, latency, response, stimulusItem, stimulusItem, values.totalearnings, values.dprime, script.elapsedTime)
</data>