pop_spectopo.m

含有多种ICA算法的eeglab工具箱

% 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()

%123456789012345678901234567890123456789012345678901234567890123456789012

% Copyright (C) 10 March 2002 Arnaud Delorme, Salk Institute, [e-mail]
%
% This program is free software; you can redistribute it and/or modify
% it under the terms of the GNU General Public License as published by
% the Free Software Foundation; either version 2 of the License, or
% (at your option) any later version.
%
% This program is distributed in the hope that it will be useful,
% but WITHOUT ANY WARRANTY; without even the implied warranty of
% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
% GNU General Public License for more details.
%
% You should have received a copy of the GNU General Public License
% along with this program; if not, write to the Free Software
% Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

% $Log: pop_spectopo.m,v $
% Revision 1.41  2004/03/25 16:54:21  arno
% changing edit box text
%
% Revision 1.40  2003/08/11 17:27:59  arno
% command line problem fixed
%
% Revision 1.39  2003/08/11 15:40:01  arno
% text
%
% Revision 1.38  2003/05/12 23:33:18  arno
% verbose off, deteecting time limits
%
% Revision 1.37  2003/03/12 03:16:24  arno
% help update
%
% Revision 1.36  2003/02/26 17:48:01  arno
% correcting corrections
%
% Revision 1.35  2003/02/26 17:42:11  scott
% header edits -sm
%
% Revision 1.34  2003/02/26 17:40:35  scott
% header edits -sm
%
% Revision 1.33  2003/02/26 03:14:28  arno
% graphic interface help
%
% Revision 1.32  2003/01/28 18:02:42  arno
% adding warning messages if no channel location file
%
% Revision 1.31  2002/10/23 02:32:36  arno
% put tag to figure for spectopo to close
%
% Revision 1.30  2002/10/23 01:40:50  arno
% message - sm & ad
%
% Revision 1.29  2002/10/08 15:41:32  arno
% adding icawinv
%
% Revision 1.28  2002/09/05 00:10:09  arno
% update message
%
% Revision 1.27  2002/08/29 17:52:57  arno
% typo
%
% Revision 1.26  2002/08/20 04:25:31  scott
% text
%
% Revision 1.25  2002/08/16 19:15:50  scott
% worked on help msg and legends
%
% Revision 1.24  2002/08/13 18:37:24  scott
% make output window title 'spectopo()'
%
% Revision 1.23  2002/08/12 22:48:25  arno
% frequency range
%
% Revision 1.22  2002/08/12 22:31:03  arno
% edit
%
% Revision 1.21  2002/08/12 01:43:54  arno
% color
%
% Revision 1.20  2002/08/11 22:20:26  arno
% color
%
% Revision 1.19  2002/08/11 18:46:23  arno
% EEG and ERP options
%
% Revision 1.18  2002/08/09 01:33:18  arno
% debugging boundaries
%
% Revision 1.17  2002/08/09 01:13:15  arno
% debugging boundaries
%
% Revision 1.16  2002/08/09 00:54:35  arno
% adding boundaries for cont. data
%
% Revision 1.15  2002/08/09 00:45:42  arno
% text
%
% Revision 1.14  2002/07/30 18:13:23  arno
% same
%
% Revision 1.13  2002/07/30 18:11:04  arno
% debugging
%
% Revision 1.12  2002/07/29 22:25:58  arno
% updating message
%
% Revision 1.11  2002/07/29 22:15:50  arno
% reprogramming for spectopo component
%
% Revision 1.10  2002/07/28 21:23:00  arno
% adding message
%
% Revision 1.9  2002/07/28 21:00:36  arno
% debugging
%
% Revision 1.8  2002/07/26 01:59:53  arno
% debugging
%
% Revision 1.7  2002/07/24 18:16:49  arno
% changing default freqs
%
% Revision 1.6  2002/07/20 19:21:39  arno
% new spectopo compatibility
%
% Revision 1.5  2002/07/20 01:31:03  arno
% same
%
% Revision 1.4  2002/07/20 01:23:28  arno
% debuging varargin decoding
%
% Revision 1.3  2002/04/25 17:05:21  scott