| POP_CHANEVENT | Import event latencies from the rising and/or falling 'edge' latencies of a specified event-marker channel in EEG.data |
 | |
| Usage: | >> OUTEEG = pop_chanevent( INEEG ); % select parameters via a pop-up window >> OUTEEG = pop_chanevent( INEEG, chanindices, 'key', 'val' ... ); % no pop-up |
| Graphic interface: | |
"Event channel(s)" |
[edit box] indices of event channel(s) to import. Command line equivalent: chanindices. |
"Preprocessing transform" |
[edit box] apply this preprocessing formula or function to the selected data channel(s) X, transforming X into the command output before edge extraction. Command line equivalent 'oper'. |
"Transition to extract" |
[list box] extract events when the event channel values go up ('leading'), down ('trailing') or both ('both'). Command line equivalent: 'edge'. |
"Transition length" |
[edit box] Increase this number to avoid having events very close to each other due to a not perfectly straight edge. Command line equivalent: 'edgelen'. |
"Assign duration to events?" |
[checkbox] . Assign duration to each extracted event. This option can only be used when extracting events on leading edges. Event will last until next trailing edge (down) event. Command line equivalent: 'duration'. |
"Delete event channel(s)" |
[checkbox] check to delete the event channel after events have been extracted from it. Command line equivalent: 'delchan'. |
"Delete old events if any" |
[checkbox] check this checkbox to remove any prior events in the dataset. Otherwise imported events are appended to old events. Command line equivalent: 'delevent'. |
"Only one event type" |
[checkbox] check this checkbox to assign all transitions in the event channel to one event type. Else, one type is assigned for each non-zero channel value. Command line equivalent: 'nbtype'. |
| Inputs: | |
INEEG |
input dataset structure |
chanindices |
index|(indices) of the event channel(s) |
| Optional inputs: | |
'edge' |
['leading'|'trailing'|'both'] extract events when values in the event channel go up ('leading'), down ('trailing') or both ('both'). {Default is 'both'}. |
'edgelen' |
[integer] maximum edge length (for some data edge do not take whole value and it takes a few sample points for signal to rise. Default is 1 (perfect edges). |
'oper' |
[string] prior to extracting edges, preprocess data channel(s) using the string command argument. In this command, the data channel(s) are designated by (capital) X. For example, 'X>3' will test the value of X at each time point (returning 1 if the data channel value is larger than 3, and 0 otherwise). You may also use any function (Ex: 'myfunction(X)'). |
'duration' |
['on'|'off'] extract event duration. This option can only be used when extracting events on leading edges. Event will last until next trailing-edge (down) event { 'off' }. |
'delchan' |
['on'|'off'] delete channel from data { 'on' }. |
'delevent' |
['on'|'off'] delete old events if any { 'on' }. |
'nbtype' |
[1|NaN] setting this to 1 will force the program to consider all events to have the same type. {Default is NaN}. If set (1), all transitions are considered the same event type If unset (NaN), each (transformed) event channel value following a transition determines an event type (Ex: Detecting leading-edge transitions of 0 0 1 0 2 0 ... produces event types 1 and 2). |
'typename' |
[string] event type name. Only relevant if 'nbtype' is 1 or if there is only one event type in the event channel. {Default is 'chanX', X being the index of the selected event channel}. |
| Outputs: | |
OUTEEG |
EEGLAB output data structure |
| Author: | Arnaud Delorme, CNL / Salk Institute, 29 July 2002 |
| See also: | eeglab() |