1,658
edits
Changes
Jump to navigation
Jump to search
BrainStreamEventFields (view source)
Revision as of 12:47, 26 September 2018
, 12:47, 26 September 2018Created page with "<!---Start1---> = Fields of the Event Structure = Every incoming marker instatiates a new [[BrainStreamImportantConcepts#SecEvents|event]. The event structure contains a numb..."
<!---Start1--->
= Fields of the Event Structure =
Every incoming marker instatiates a new [[BrainStreamImportantConcepts#SecEvents|event]. The event structure contains a number of fixed fields:
<pre>event.name : name of the marker
event.time : time [s] referred to number of acquired samples
event.brainstreamversion : current version of [[BrainStream|Brain Stream]]
</pre> If a DATA timepoint is specified for the event, the event structure also contains the following fields: <br /><pre>
event.BRAINSTREAM : contains information required for internal [[BrainStream|Brain Stream]] processing
.data.raw : raw data [channels x data]
.trial.time : start of data segment [s]
.samp : always set to 1
.offset : start of data [#samples]
.duration : number of samples
.hdr.Fs : sample frequency
.channels.* : see remarks below
.labels.* : see remarks below
.Cal : raw data calibration matrix
.nChans : number of channels
.label : all channel labels (compatible with fieldtrip)
.orig : always original header information
.usedcap : name of cap used in current block (user should take care of further handling)
.trial : same as event.data.trial
</pre>
*: channel and label information can be grouped together based on settings specified for corresponding hardware device topic in the blocksettings. It uses fieldrips <tt>ft_channelselection</tt> function to match channels that belong to certain groups, like 'EEG' or 'EOG'. The data for the selected channels appears in a separate field. For example, if you defined a group of eeg electrodes, the data for these electrodes shows up in event.data.eeg. See [[Http://fieldtrip.fcdonders.nl/reference/ft_channelselectionChannelSelection|http://fieldtrip.fcdonders.nl/reference/ft_channelselection channel selection]] on the FieldTrip website for more options.
Depending on the utilized data source, additional fields might be present inside the hdr structure.
In addition, requested copies of global variables appear as separate fields of the event structure (for more information see the [[BrainStreamImportantConcepts#SecVariables|Global Variables] section).
<!---End1--->
<!--
* Access control
-->
= Fields of the Event Structure =
Every incoming marker instatiates a new [[BrainStreamImportantConcepts#SecEvents|event]. The event structure contains a number of fixed fields:
<pre>event.name : name of the marker
event.time : time [s] referred to number of acquired samples
event.brainstreamversion : current version of [[BrainStream|Brain Stream]]
</pre> If a DATA timepoint is specified for the event, the event structure also contains the following fields: <br /><pre>
event.BRAINSTREAM : contains information required for internal [[BrainStream|Brain Stream]] processing
.data.raw : raw data [channels x data]
.trial.time : start of data segment [s]
.samp : always set to 1
.offset : start of data [#samples]
.duration : number of samples
.hdr.Fs : sample frequency
.channels.* : see remarks below
.labels.* : see remarks below
.Cal : raw data calibration matrix
.nChans : number of channels
.label : all channel labels (compatible with fieldtrip)
.orig : always original header information
.usedcap : name of cap used in current block (user should take care of further handling)
.trial : same as event.data.trial
</pre>
*: channel and label information can be grouped together based on settings specified for corresponding hardware device topic in the blocksettings. It uses fieldrips <tt>ft_channelselection</tt> function to match channels that belong to certain groups, like 'EEG' or 'EOG'. The data for the selected channels appears in a separate field. For example, if you defined a group of eeg electrodes, the data for these electrodes shows up in event.data.eeg. See [[Http://fieldtrip.fcdonders.nl/reference/ft_channelselectionChannelSelection|http://fieldtrip.fcdonders.nl/reference/ft_channelselection channel selection]] on the FieldTrip website for more options.
Depending on the utilized data source, additional fields might be present inside the hdr structure.
In addition, requested copies of global variables appear as separate fields of the event structure (for more information see the [[BrainStreamImportantConcepts#SecVariables|Global Variables] section).
<!---End1--->
<!--
* Access control
-->