| POP_EDITSET |
Edit EEG dataset structure fields. |
 |
|
| Usage: |
>> EEGOUT = pop_editset( EEG ); % pops-up a data entry window
>> EEGOUT = pop_editset( EEG, 'key', val,...); % no pop-up window |
|
| Graphic interface: |
"Dataset name" |
[Edit box] Name for the new dataset. In the right column of the graphic interface, the "EEG.setname" text indicates which field of the EEG structure this parameter corresponds to (in this case, .'setname'). Command line equivalent: 'setname'. |
"Data sampling rate" |
[Edit box] In Hz. Command line equivalent: 'srate' |
"Time points per epoch" |
[Edit box] Number of data frames (points) per epoch. Changing this value will change the number of data epochs. Command line equivalent: 'pnts'. |
"Start time" |
[Edit box] This edit box is only present for epoched data and specifies the epoch start time in ms. Epoch end time is automatically calculated. Command line equivalent: 'xmin' |
"Number of channels" |
[Edit box] Number of data channels. Command line equivalent: 'nbchan'. This edit box cannot be edited. |
"Ref. channel indices or mode" |
[edit box] current reference. This edit box cannot be edited. To change the data reference, use menu item, 'Tools > Re-reference', calling function pop_reref(). The reference can be either a string (channel name), 'common', indicating an unknown common reference, 'averef' indicating average reference, or an array of integers containing indices of the reference channel(s). |
|
| "Subject code" - [Edit box] subject code. For example, 'S01'. See also: |
the command line equivalent, 'subject'. |
"Task Condition" |
[Edit box] task condition. For example, 'Targets'. |
|
| See also: |
the command line equivalent 'condition'. |
"Session number" |
[Edit box] session number (from the same subject). All datasets from the same subject and session will be |
|
| assumed to use the same ICA decomposition. See also: |
command line equivalent 'session'. |
"Subject group" |
[Edit box] subject group. For example 'Patients' or 'Control'. The command line equivalent is 'group'. |
"About this dataset" |
[Edit box] Comments about the dataset. Command line equivalent is 'comments'. |
"Channel locations file or array" |
[Edit box] For channel data formats, see >> readlocs help Command line equivalent: 'chanlocs' |
"ICA weights array or text/binary file" |
[edit box] Import ICA weights from other decompositions (e.g., same session, different conditions). To use the ICA weights from another loaded dataset (n), enter ALLEEG(n).icaweights. Command line equivalent: 'icaweights' |
"ICA sphere array or text/binary file" |
[edit box] Import ICA sphere matrix. In EEGLAB, ICA decompositions require a sphere matrix and an unmixing weight matrix (see above). To use the sphere matrix from a loaded dataset (n), enter ALLEEG(n).icasphere Command line equivalent: 'icasphere'. |
"From other dataset" |
[push button] Press this button to enter the index of another dataset. This will update the channel locations or the ICA edit box. |
|
| Inputs: |
EEG |
EEG dataset structure |
|
| Optional inputs: |
'setname' |
Name of the EEG dataset |
'data' |
['varname'|'filename'] Import data from a Matlab variable or mat file into an EEG data structure |
'dataformat' |
['array|matlab|ascii|float32le|float32be'] Input data format. 'array' is a Matlab array in the global workspace. 'matlab' is a Matlab file (containing a single variable). 'ascii' is an ascii file. 'float32le' and 'float32be' are 32-bit float data files with little-endian and big-endian byte order, respectively. Data must be organised as 2-D (channels, timepoints), i.e. |
channels |
rows, timepoints = columns; else as 3-D (channels, timepoints, epochs). For convenience, the data file is transposed if the number of rows is larger than the number of columns, as the program assumes that there are more channels than data points. |
'subject' |
[string] subject code. For example, 'S01'. {default: none -> each dataset from a different subject} |
'condition' |
[string] task condition. For example, 'Targets' {default: none -> all datasets from one condition} |
'group' |
[string] subject group. For example 'Patients' or 'Control'. {default: none -> all subjects in one group} |
'session' |
[integer] session number (from the same subject). All datasets from the same subject and session will be assumed to use the same ICA decomposition {default: none -> each dataset from a different session} |
'chanlocs' |
['varname'|'filename'] Import a channel location file. For file formats, see >> help readlocs |
'nbchan' |
[int] Number of data channels. |
'xmin' |
[real] Data epoch start time (in seconds). {default: 0} |
'pnts' |
[int] Number of data points per data epoch. The number of data trials is automatically calculated. {default: length of the data -> continuous data assumed} |
'srate' |
[real] Data sampling rate in Hz {default: ???} |
'ref' |
[string or integer] reference channel indices; 'averef' indicates average reference. Note that this does not perform referencing but only sets the initial reference when the data are imported. |
'icaweight' |
[matrix] ICA weight matrix. |
'icasphere' |
[matrix] ICA sphere matrix. By default, the sphere matrix is initialized to the identity matrix if it is left empty. |
'comments' |
[string] Comments on the dataset, accessible through the EEGLAB main menu using ('Edit > About This Dataset'). Use this to attach background information about the experiment or the data to the dataset. |
|
| Outputs: |
EEGOUT |
Modified EEG dataset structure |
|
| Note: |
|
| To create a new dataset: |
>> EEG = pop_editset( eeg_emptyset ); % eeg_emptyset returns an empty dataset |
|
| To erase a variable, use '[]'. The following suppresses channel locations: |
>> EEG = pop_editset( EEG, 'chanlocs', '[]'); |
|
| Author: |
Arnaud Delorme, CNL / Salk Institute, 2001 |
|
| See also: |
pop_importdata(), pop_select(), eeglab() |