datastream element

Attributes

<dataStream name>
/ frequency = integer
/ audit = boolean
/ columns = (columnname, columnname, columnname, property, property, property)
/ encrypt = boolean(password)
/ file = path
/ filter = { script }
/ labels = (label, label, label, ...)
/ password = string
/ separateFiles = boolean
/ userId = string
</dataStream>

Properties

dataStream.name.elapsedTime
dataStream.name.encrypt
dataStream.name.encryptionKey
dataStream.name.file
dataStream.name.fileName
dataStream.name.fullPath
dataStream.name.password
dataStream.name.recordData
dataStream.name.userId
dataStream.name.name
dataStream.name.typeName

Functions

None.

Remarks

The dataStream element allows the continuous recording of data throughout a trial, block or entire experiment. The dataStream records a new set of data approximately every vertical refreshframe. This is useful for mouse or eye coordinates tracking.

Examples

The following dataStream records 10 columns, including mouse coordinates.

<dataStream mouseMovements>
/ columns=(subject, blockcode, trialCode, trialnum, latency, response, stimulusItem, mouse.x, mouse.y, script.elapsedtime)
</dataStream>

In order for the dataStream to be recorded, it needs to be explicitly set under a trial, block or experiment element using the dataStream attribute. In this example, the dataStream 'mouseMovements' is turned on for the entire experiment.

<expt myExpt>
/ blocks = [1=myBlock]
/ dataStreams = (mouseMovements)
</expt>