| STD_ENVTOPO | Creates an envtopo() image for a STUDY set, uses cluster contributions instead of individual components. Plots the envelope of a data epoch, plus envelopes and average scalp maps for specified or largest-contributing clusters for each condition. Click on individual axes to examine them in detail (using axcopy()). See envtopo() for further details. |
| Usage: | >> std_envtopo(STUDY, ALLEEG, 'key1', 'val1', ...); |
| Inputs: | |
STUDY |
an EEGLAB STUDY structure containing EEG structures |
ALLEEG |
the ALLEEG data structure; can also be an EEG dataset structure. |
| Optional inputs: | |
'clusters' |
[integer array] vector of cluster numbers. If one cluster, plots the cluster contribution to the data envelope. If multiple clusters selects the largest contributing clusters from within the 'limcontrib' region (see below) and plots the envelopes of their contributions {default| [] -> 'all'} |
'subclus' |
[integer array] vector of cluster numbers to omit when computing the ERP envelope of the data (e.g., artifact clusters) {default|[] -> none} |
'env_erp' |
['contrib' | 'all'] |
'contrib' |
> If one cluster, the grand ERP envelope includes only the datasets that are part of that cluster. 'all' -> Grand ERP envelope includes all datasets in STUDY. If multiple clusters, this is the only option possible. |
'only_clust' |
[ 'on' | 'off'] dataset components to include in the grand ERP. 'on' will include only the components that were part of the clustering For example, if components were rejected from clustering because of high dipole model residual variance, don't include their data in the grand ERP. 'off' will include all components in the datasets except those in the subtructed ('subclus') clusters {default 'off'}. |
'baseline' |
[minms maxms] - a new baseline to remove from the grand ERP and cluster ERP contributions. |
'diff' |
[condition1 condition2] the indexes of two condition. Plots additional figure with the difference of the two condition envtopo. |
'clustnums' |
[integer array] vector of cluster numbers to plot {default|0 -> all} Else if int < 0, the number of largest contributing clusters to plot {default|[] -> 7} |
'timerange' |
data start and end input latencies (in ms) {default: from 'limits' if any} |
'limits' |
0 or [minms maxms] or [minms maxms minuV maxuV]. Specify start/end plot (x) limits (in ms) and min/max y-axis limits (in uV). If 0, or if both minmx & maxms == 0 -> use latencies from 'timerange' (else, 0:frames-1). If both minuV and maxuV == 0 -> use data uV limits {default: 0} |
'limcontrib' |
[minms maxms] time range (in ms) in which to rank clusters contribution (boundaries shown by thin dotted lines) {default|[]|[0 0] -> plotting limits} |
'vert' |
vector of times (in ms) at which to plot vertical dashed lines {default|[] -> none} |
| See also: | envtopo() |