summarydata element

The summarydata element specifies a set of summary data for to be recorded for a given participant.

Syntax

<summarydata>
/ file = "location"
/ encrypt = true("password") or false
/ password = "string"
/ separatefiles = boolean
/ columns = (property, property, property, ...)
/ userid = "string"
</summarydata>

Properties

summarydata.encrypt
summarydata.encryptionkey
summarydata.file
summarydata.name
summarydata.password
summarydata.recorddata
summarydata.typename
summarydata.userid

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>