| POP_EPOCH | Convert a continuous EEG dataset to epoched data by extracting data epochs time locked to specified event types or event indices. May also sub-epoch an already epoched dataset (if sub-epochs are same size or smaller). This pop_function calls epoch(). |
 | |
| Usage: | >> OUTEEG = pop_epoch( EEG); % pop-up a data entry window >> OUTEEG = pop_epoch( EEG, events, timelimits); >> [OUTEEG, indices] = pop_epoch( EEG, typerange, timelimits,'key1', value1 ...); |
| Graphic interface: | |
"Time-locking event type(s)" |
[edit box] Select 'Edit > Event values' to see a list of event.type values; else use the push button. To use event types containing spaces, enter in single-quotes. epoch() function command line equivalent: 'typerange' |
"..." |
[push button] scroll event types. |
"Epoch limits" |
[edit box] epoch latency range [start, end] in seconds relative to the time-locking events. epoch() function equivalent: 'timelim' |
"Name for the new dataset" |
[edit box] epoch() function equivalent: 'newname' |
"Out-of-bounds EEG ..." |
[edit box] Rejection limits ([min max], []=none). epoch() function equivalent: 'valuelim' |
| Inputs: | |
EEG |
Input dataset. Data may already be epoched; in this case, extract (shorter) subepochs time locked to epoch events. |
typerange |
Cell array of event types to time lock to. See also: 'eventindices' {default {} --> time lock epochs to any type of event} (Note: An event field called 'type' must be defined in the 'EEG.event' structure. |
| See also: | commandline argument 'eventindices' below). |
timelim |
Epoch latency limits [start end] in seconds relative to the time-locking event {default: [-1 2]} |
| Optional inputs: | 'eventindices'- [int indices] Extract data epochs time locked to the indexed event numbers. |
'valuelim' |
[min max] or [max]. Lower and upper bound latencies for trial data. Else if one positive value is given, use its negative as the lower bound. The given values are also considered outliers (min max) {default: none} |
'verbose' |
['yes'|'no'] {default: 'yes'} |
'newname' |
[string] New dataset name {default: "[old_dataset] epochs"} 'epochinfo'- ['yes'|'no'] Propagate event information into the new epoch structure {default: 'yes'} |
| Outputs: | |
OUTEEG |
output dataset |
indices |
indices of accepted events |
| Authors: | Arnaud Delorme and Hilit Serby, SCCN, INC, UCSD, 2001 |
| See also: | eeglab(), epoch() |