ica¶
ica rejects independent components of the ICA currently loaded in AnyWave, or restores them. It does what you do by hand
when you reject components in the ICA panel: AnyWave marks the components as rejected and rebuilds the signals.
anywave('ica', cfg);
Note
The command is called ica (not ica_command). The name ica_command belongs to the Python package.
| field | content | required |
|---|---|---|
labels |
cell array of the labels of the components | yes |
command |
'reject' (default) or 'undo' |
no |
The labels of the components start with the modality: E_IC1, E_IC2... for EEG, S_IC1... for sEEG, M_IC1... for MEG
and EMG_IC1... for EMG. The numbering starts at 1.
Examples¶
Reject components 10 and 15 of a MEG ICA:
function main(varargin)
anywave('init', varargin);
cfg = [];
cfg.labels = {'M_IC10', 'M_IC15'};
cfg.command = 'reject'; % the default, you can leave it out
anywave('ica', cfg);
end
Restore them:
cfg = [];
cfg.labels = {'M_IC10', 'M_IC15'};
cfg.command = 'undo';
anywave('ica', cfg);
Build the list of labels in your code:
rejected = [1 4 7]; % numbers of the components
labels = arrayfun(@(k) sprintf('E_IC%d', k), rejected, 'UniformOutput', false);
anywave('ica', struct('labels', {labels})); % {labels}: the list itself is the value of the field
Good to know¶
- An ICA must be loaded in AnyWave. Without an ICA the command is accepted and nothing happens.
- A single label may be given as a character vector:
cfg.labels = 'E_IC1'is the same ascfg.labels = {'E_IC1'}. - A label that is not a component of the loaded ICA (
E_IC99, orM_IC1when only an EEG ICA is loaded) is ignored, without any error: check the names of your labels. - The command returns nothing: do not assign its result (
out = anywave('ica', cfg)is a MATLAB error). The views are updated as when you reject or restore a component by hand, see Reject components.
Errors¶
| message | cause |
|---|---|
ERROR: labels key is not specified in struct/dict parameter. |
no labels field |
ERROR: labels is empty. |
labels is an empty list |
ERROR: command must be 'reject' or 'undo'. |
any other value for command |
bad arguments. Expected struct. |
the argument is not a struct |