eeg_checkset.m

来自「含有多种ICA算法的eeglab工具箱」· M 代码 · 共 1,234 行 · 第 1/4 页

% eeg_checkset() - check the consistency of fields of an EEG dataset 
%
% Structure of an EEG dataset under EEGLAB:
%    EEG.data         - two-dimensional continuous data array (chans, frames)
%                       OR three-dim. epoched data array (chans, frames, epochs)
%    EEG.setname      - name of the dataset
%    EEG.filename     - filename of the dataset
%    EEG.filepath     - filepath of the dataset
%    EEG.chanlocs     - structure array containing names and positions 
%                       of the channels on the scalp
%    EEG.urchanlocs   - original chanlocs structure
%    EEG.pnts         - number of time points (data frames) per epoch (trial).
%                       OR if data is continuous, total number of time points
%    EEG.nbchan       - number of channels
%    EEG.trials       - number of epochs (trials) in the dataset. If data
%                       is continuous, automatically set to 1.
%    EEG.srate        - channel sampling rate (in Hz)
%    EEG.xmin         - epoch start time (in seconds)
%    EEG.xmax         - epoch end time (in seconds)
%    EEG.times        - time vector (one value per time point)
%    EEG.ref          - ['common'|'averef'|integer] reference index or type
%    EEG.comments     - comments about the dataset
%
% ICA variables:
%    EEG.icaact       - ICA activations (components, frames, epochs)
%                       [] means compute_ica option is set to 0 under
%                       EEGLAB options -> activations are computed on the fly.
%    EEG.icasphere    - sphere array returned by linear (ICA) decomposition
%    EEG.icaweights   - weight array returned by linear (ICA) decomposition
%    EEG.icawinv      - inverse (ICA) weight matrix giving the projected
%                       activity of the components to the electrodes.
%                       NOTE: Any linear unmixing matrix may be used. 
%
% Event and epoch structures:    
%       EEG.event     - event structure (any number of events per epoch)
%       EEG.epoch     - epoch structure (one structure per epoch)
%       EEG.eventdescription - cell array of strings describing event fields.
%       EEG.epochdescription - cell array of strings describing epoch fields.
%       --> See the http://sccn.ucsd.edu/eeglab/maintut/eeglabscript.html 
%           for details
%
% Variables used for manual and semi-automatic data rejection:
%      EEG.specdata          - data spectrum for every single trial
%      EEG.specica           - data spectrum for every single trial
%      EEG.stats.kurtc       - component kurtosis values
%      EEG.stats.kurtg       - global kurtosis of components      
%      EEG.stats.kurta       - kurtosis of accepted epochs      
%      EEG.stats.kurtr       - kurtosis of rejected epochs      
%      EEG.stats.kurtd       - kurtosis of spatial distribution      
%      EEG.reject.entropy    - entropy of epochs  
%      EEG.reject.entropyc   - entropy of components
%      EEG.reject.threshold  - rejection thresholds 
%      EEG.reject.icareject  - epochs rejected by ICA criteria
%      EEG.reject.gcompreject - rejected ICA components
%      EEG.reject.sigreject  - epochs rejected by single-channel criteria
%      EEG.reject.elecreject - epochs rejected by raw data criteria
%
%      EEG.reject.compreject - deprecated
%      EEG.reject.comptrial  - deprecated
%      EEG.reject.eegentropy - deprecated
%      EEG.reject.eegkurt    - deprecated
%      EEG.reject.eegkurtg   - deprecated
%
% Usage:
%       >> [EEGOUT, res] = eeg_checkset( EEG ); % check consistency of EEG
%
% Inputs:
%       EEG        - EEGLAB dataset structure
%
% Outputs:
%       EEGOUT     - output EEGLAB dataset
%
% Author: Arnaud Delorme, CNL / Salk Institute, 2001
%
% See also: eeglab()

%123456789012345678901234567890123456789012345678901234567890123456789012

% Copyright (C) 2001 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: eeg_checkset.m,v $
% Revision 1.129  2004/07/26 15:53:35  arno
% debug conversion
%
% Revision 1.128  2004/07/26 15:49:52  arno
% convert to single for Matlab 7
%
% Revision 1.127  2004/06/16 21:38:30  arno
% resorting urevents
%
% Revision 1.126  2004/06/16 18:58:58  arno
% same
%
% Revision 1.125  2004/06/16 18:57:45  arno
% resort by epoch first
%
% Revision 1.124  2004/06/14 16:10:04  arno
% resoring event latencies
%
% Revision 1.123  2004/06/04 01:05:02  arno
% allowing latencies of 0.5
%
% Revision 1.122  2004/05/26 23:12:02  arno
% epoch duration in ms
%
% Revision 1.121  2004/05/24 17:24:08  arno
% assign 0 to empty durations
%
% Revision 1.120  2004/05/14 17:47:15  arno
% convert history
%
% Revision 1.119  2004/05/06 21:54:55  arno
% message text
%
% Revision 1.118  2004/02/17 20:05:04  arno
% remove ICA weights if invalid
%
% Revision 1.117  2003/12/17 23:25:39  arno
% different check for chanlocs
%
% Revision 1.116  2003/12/17 00:45:57  arno
% adding E prefix to electrodes
%
% Revision 1.115  2003/12/11 17:59:41  arno
% msg
%
% Revision 1.114  2003/12/04 22:33:54  arno
% urevent remove
%
% Revision 1.113  2003/12/04 17:45:12  arno
% debug urevent (made Matlab 5.3 crash systematically)
%
% Revision 1.112  2003/12/04 02:40:56  arno
% msg
%
% Revision 1.111  2003/12/02 22:29:40  arno
% adding urchan
%
% Revision 1.110  2003/12/02 17:07:59  arno
% debug urchanlocs
%
% Revision 1.109  2003/12/02 03:39:06  arno
% urchanlocs
%
% Revision 1.108  2003/11/18 16:42:30  scott
% text labels
%
% Revision 1.107  2003/11/05 16:20:27  arno
% homogenous -> homogeneous
%
% Revision 1.106  2003/11/04 15:47:48  scott
% warning msg edits
%
% Revision 1.105  2003/11/04 01:15:06  arno
% makeur message made clearer
%
% Revision 1.104  2003/09/22 23:45:24  arno
% debug urevent
%
% Revision 1.103  2003/07/28 15:30:31  arno
% default for EEG.ref
%
% Revision 1.102  2003/07/28 15:19:09  arno
% detect reference electrode
%
% Revision 1.101  2003/07/21 14:32:17  arno
% convert single to double precision
%
% Revision 1.100  2003/07/16 20:53:43  arno
% auto creation of urevent table
%
% Revision 1.99  2003/06/27 16:59:11  arno
% updating ur
%
% Revision 1.98  2003/06/18 22:27:53  arno
% implementing makeur
%
% Revision 1.97  2003/06/13 16:41:51  arno
% adding chanlocs homogenous check
%
% Revision 1.96  2003/06/11 21:18:04  arno
% new limits for latencies
%
% Revision 1.95  2003/02/28 17:05:23  arno
% eeg_checkset() -> eeg_checkset in warnings
%
% Revision 1.94  2003/02/28 16:57:34  arno
% typo
%
% Revision 1.93  2003/02/28 15:35:41  scott
% header edits -sm
%
% Revision 1.92  2003/02/28 15:30:00  arno
% updating warning message
%
% Revision 1.91  2003/02/26 02:18:55  arno
% debugging if file has changed of location
%
% Revision 1.90  2003/02/03 20:07:45  arno
% error if no data
%
% Revision 1.89  2003/01/24 19:32:02  arno
% debugging ICA for NaN
%
% Revision 1.88  2003/01/02 17:13:01  scott
% edit header and msgs -sm
%
% Revision 1.87  2003/01/02 16:37:33  arno
% editing message - ad & sm
%
% Revision 1.86  2002/12/24 01:34:44  arno
% debug multiple checks
%
% Revision 1.85  2002/11/15 18:40:54  arno
% adding another test if chanlocs empty
%
% Revision 1.84  2002/11/15 02:11:04  arno
% debugging for single dataset
%
% Revision 1.83  2002/11/15 01:37:42  scott
% Can not -> Cannot
%
% Revision 1.82  2002/11/13 19:57:40  arno
% checkin shrink factor
%
% Revision 1.81  2002/11/13 19:21:09  arno
% updating average reference flag
%
% Revision 1.80  2002/11/13 17:41:11  arno
% editing chanlocs warning -sm
%
% Revision 1.79  2002/11/13 17:10:09  arno
% forcing channel labels to string
%
% Revision 1.78  2002/11/12 22:51:55  arno
% adding a warning for additional reference electrode location
%
% Revision 1.77  2002/11/11 15:28:54  arno
% besa check
%
% Revision 1.76  2002/10/29 01:17:37  arno
% implementing user abord
%
% Revision 1.75  2002/10/20 21:32:08  arno
% nan activation computation debug
%
% Revision 1.74  2002/10/16 22:44:04  arno
% ica recompute for NaNs
%
% Revision 1.73  2002/10/09 00:14:13  arno
% typo last
%
% Revision 1.72  2002/10/09 00:11:41  arno
% debug read float data file
%
% Revision 1.71  2002/09/23 16:42:24  arno
% adding comments
%
% Revision 1.70  2002/09/23 16:15:00  arno
% debug floatread
%
% Revision 1.69  2002/09/23 16:08:57  arno
% check for EEG.data empty
%
% Revision 1.68  2002/09/05 00:04:05  arno
% disp-> error
%
% Revision 1.67  2002/09/04 22:13:55  luca
% adding dataset name check -arno
%
% Revision 1.66  2002/08/28 01:02:48  arno
% changing error messages to disp
%
% Revision 1.65  2002/08/22 21:21:00  arno
% typo
%
% Revision 1.64  2002/08/21 17:56:20  arno
% debug checks
%
% Revision 1.63  2002/08/21 17:46:26  arno
% more reject field checks
%
% Revision 1.62  2002/08/21 02:24:27  arno
% change message
%
% Revision 1.61  2002/08/21 02:22:54  arno
% debug
%
% Revision 1.60  2002/08/21 02:19:38  arno
% add continuous data statement
%
% Revision 1.59  2002/08/21 00:15:20  arno
% debug
%
% Revision 1.58  2002/08/19 19:46:16  arno