summarydata element

Attributes

<summaryData>
/ columns = (expression, expression, expression, ...)
/ encrypt = boolean(password)
/ file = path
/ filter = { script }
/ labels = (label, label, label, ...)
/ password = string
/ separateFiles = boolean
/ userId = string
</summaryData>

Properties

summaryData.encrypt
summaryData.encryptionKey
summaryData.file
summaryData.fileName
summaryData.fullPath
summaryData.password
summaryData.recordData
summaryData.userId
summaryData.name
summaryData.typeName

Functions

None.

Remarks

The summarydata element enables a script to record a single row of summary data for each participant that runs a script. Typically, the summarydata element is used to save metrics that capture participants' overall performance on the script. The summary statics are saved to a separate file as the raw, trail-by-trial data file. Recording all of the relevant performance metrics into a summary data file can simplify data analysis by avoiding the often complicated process of calculating these metrics from the raw data. Summary data are saved as tab-delimited text.

Examples

The following records the subject id, start date, start time, and three performance metrics for each participant.

<summarydata>
/ columns=(script.subjectId, script.startDate, script.startTime, expressions.da, expressions.db, expressions.d)
/ file="iat_summary.iqdat"
</summarydata>