POP_SPECTOPO Plot spectra of specified data channels or components. Show scalp maps of power at specified frequencies. Calls spectopo().


Usage: >> pop_spectopo( EEG, dataflag); % pops-up interactive window
OR
>> [spectopo_outputs] = pop_spectopo( EEG, dataflag, timerange, process, 'key', 'val',...); % returns spectopo() outputs

Graphic interface for EEG data (dataflag = 1):
"Epoch time range"   
[edit box] [min max] Epoch time range (in ms) to use in computing the spectra (by default the whole epoch or data). Command line equivalent: 'timerange'
"Percent data to sample"   
[edit box] Percentage of data to use in computing the spectra (low % speeds up the computation). spectopo() equivalent: 'percent'
"Frequencies to plot as scalp maps"   
[edit box] Vector of 1-7 frequencies to plot topoplot() scalp maps of power at all channels. spectopo() equivalent: 'freqs'
"Apply to EEG|ERP|BOTH"   
[edit box] Plot spectra of the 'EEG', 'ERP' or of 'BOTH'.

NOTE: This edit box does not appear for continuous data.
Command line equivalent: 'process'
"Plotting frequency range"   
[edit box] [min max] Frequency range (in Hz) to plot. spectopo() equivalent: 'freqrange'
"Spectral and scalp map options (see topoplot)"   
[edit box] 'key','val','key',... sequence of arguments passed to spectopo() for details of the spectral decomposition or to topoplot() to adjust details of the scalp maps. For details see >> help topoplot

Graphic interface for components (dataflag = 0):
"Epoch time range"   
[edit box] [min max] Epoch time range (in ms) to use in computing the spectra (by default the whole epoch or data). Command line equivalent: 'timerange'
"Frequency (Hz) to analyze"   
[edit box] Single frequency (Hz) at which to plot component contributions. spectopo() equivalent: 'freqs'
"Electrode number to analyze"   
[edit box] 1-nchans --> Plot component contributions at this channel; [] --> Plot contributions at channel with max power; 0 --> Plot component contributions to global (RMS) power. spectopo() equivalent: 'plotchan'
"Percent data to sample"   
[edit box] Percent of data to use in computing the spectra (low % speeds up the computation). spectopo() equivalent: 'percent'
"Components to include ..."   
[Edit box] Only compute spectrum of a subset of the components. spectopo() equivalent: 'icacomps'
"Number of largest-contributing ..."   
[edit box] Number of component maps to plot. spectopo() equivalent: 'nicamaps'
"Else, map only these components ..."   
[edit box] Use this entry to override plotting maps of the components that project most strongly (at the selected frequency) to the the selected channel (or whole scalp if 'plotchan' (above) == 0). spectopo() equivalent: 'icamaps'
"[Checked] Compute comp spectra ..."   
[checkbox] If checked, compute the spectra of the selected component activations; else, if unchecked compute the spectra of (the data MINUS each selected component). spectopo() equivalent: 'icamode'
"Plotting frequency range"   
[edit box] [min max] Frequency range (in Hz) to plot. spectopo() equivalent: 'freqrange'
"Spectral and scalp map options (see topoplot)"   
[edit box] 'key','val','key',... sequence of arguments passed to spectopo() for details of the spectral decomposition or to topoplot() to adjust details of the scalp maps. For details see >> help topoplot

Inputs:
EEG   
Input EEGLAB dataset
dataflag   
If 1, process the input data channels. If 0, process its component activations. {Default: 1, process the data channels}.
timerange   
[min_ms max_ms] Epoch time range to use in computing the spectra {Default: whole input epochs}
process   
'EEG'|ERP'|'BOTH' If processing data epochs, work on either the mean single-trial 'EEG' spectra, the spectrum of the trial-average 'ERP', or plot 'BOTH' the EEG and ERP spectra. {Default: 'EEG'}

Optional inputs:
'key','val'   
Optional topoplot() and/or spectopo() plotting arguments {Default, 'electrodes','off'}

Outputs: As from spectopo(). When nargin<2, a query window pops-up
to ask for additional arguments and NO outputs are returned.

Note: Only the outputs of the 'ERP' spectral analysis
are returned when plotting 'BOTH' ERP and EEG spectra.

Author: Arnaud Delorme & Scott Makeig, CNL / Salk Institute, 10 March 2002

See also: spectopo(), topoplot()

See the matlab file pop_spectopo.m (may require other functions)

Back to functions