pop_editset.m

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

% pop_editset() - Edit EEG dataset structure fields.
%
% Usage:
%   >> EEGOUT = pop_editset( EEG ); % pops-up a data entry window
%   >> EEGOUT = pop_editset( EEG, 'key', val,...); % no pop-up window
%
% Graphic interface:
%   "EEGLAB dataset name" - [Edit box] Name for the new dataset. 
%                  In the last column of the graphic interface, the "EEG.setname"
%                  text indicates which field of the EEG structure this parameter
%                  is corresponding to (in this case 'setname').
%                  Command line equivalent: 'setname'. 
%   "Time points per epoch" - [Edit box] Number of data frames (points) per epoch.
%                  Command line equivalent: 'pnts'
%   "Data sampling rate" - [Edit box] In Hz. Command line equivalent: 'srate'
%   "Optional epoch start time" - [Edit box]  This edit box is only present for 
%                  data epoch and specify the epochs start time in ms. Epoch upper
%                  time limit is automatically calculated. 
%                  Command line equivalent: 'xmin'
%   "Channel locations file or array" - [Edit box] For channel data formats, see 
%                  >> readlocs help     Command line equivalent: 'chanlocs'
%   "ICA weights array or text file" - [edit box] Import ICA weights from other 
%                  decompositions (e.g., same data, different conditions). 
%                  To use the ICA weights from another loaded dataset (n), enter 
%                  ALLEEG(n).icaweights. Command line equivalent: 'icaweights'
%   "ICA sphere array or text file" - [edit box] Import ICA sphere matrix. 
%                  Infomax ICA decompositions may be defined by a sphere matrix 
%                  and an unmixing weight matrix (see above).  To use the sphere 
%                  matrix from another loaded dataset (n), enter ALLEEG(n).icasphere 
%                  Command line equivalent: 'icasphere'.
%   "Data reference" - [text] to change data reference, use menu Tools > Re-reference
%                  calling function pop_reref().
% Inputs:
%   EEG          - EEG dataset structure
%
% Optional inputs:
%   'setname'    - Name of the EEG dataset
%   'data'       - ['varname'|'filename'] Import data from a Matlab variable or file
%                  into an EEG data structure 
%   'dataformat' - ['array|matlab|ascii|float32le|float32be'] Input data format.
%                  'array' is a Matlab array in the global workspace.
%                  'matlab' is a Matlab file (which must contain a single variable).
%                  'ascii' is an ascii file. 'float32le' and 'float32be' are 32-bits
%                  float data files (little endian or big endian byte ordering).
%                  Data must be organised as (channels, timepoints) i.e. 
%                  channels = rows and timepoints = columns or (channels, timepoints, 
%                  epochs). For convenience, The data file is transposed if the number
%                  of rows is larger than the number of columns.
%   'chanlocs'   - ['varname'|'filename'] Import a channel location file.
%                  For file formats, see >> help readlocs
%   'nbchan'     - [int] Number of data channels. 
%   'xmin'       - [real] Data start time (in seconds).
%   'pnts'       - [int] Number of data points per epoch (epoched data only)
%   'srate'      - [real] Data sampling rate in Hz. 
%   'icaweight'  - [matrix] ICA weight matrix. 
%   'icasphere'  - [matrix] ICA sphere matrix. By default, the sphere matrix 
%                  is initialized to the identity matrix if it is left empty.
%   'comments'   - [string] Comments on the dataset accessible through the EEGLAB
%                  main menu (Edit > About This Dataset). Use this to attach 
%                  background information about the data to the dataset.
% Outputs:
%   EEGOUT       - Modified EEG dataset structure
%
% Note:
%   To create a new dataset:
%   >> EEG = pop_editset( eeg_emptyset ); % eeg_emptyset() returns an empty dataset
%
%   To erase a variable, use '[]'. The following suppresses channel locations:
%   >> EEG = pop_editset( EEG, 'chanlocs', '[]');
%
% Author: Arnaud Delorme, CNL / Salk Institute, 2001
%
% See also: pop_importdata(), pop_select(), 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: pop_editset.m,v $
% Revision 1.44  2004/02/04 18:18:43  arno
% implementing binary read for weights and sphere
%
% Revision 1.43  2003/12/08 18:03:37  arno
% do not copy variable names
%
% Revision 1.42  2003/12/05 23:24:47  arno
% command line call problem
%
% Revision 1.41  2003/07/30 18:01:24  arno
% handling empty chanlocs
%
% Revision 1.40  2003/07/28 17:50:18  arno
% same
%
% Revision 1.39  2003/07/28 17:49:12  arno
% ref text
%
% Revision 1.38  2003/07/28 15:28:24  arno
% obsolete averef
%
% Revision 1.37  2003/05/29 21:45:53  arno
% allowing to import numerical data array from command line
%
% Revision 1.36  2003/05/22 01:48:49  arno
% debug icaweight/icasphere
%
% Revision 1.35  2003/03/04 20:11:57  arno
% header typo
%
% Revision 1.34  2003/02/25 01:00:53  scott
% header edit -sm
%
% Revision 1.33  2003/02/24 16:26:38  arno
% resolving ???
%
% Revision 1.32  2003/02/22 17:11:31  scott
% header edit -sm
%
% Revision 1.31  2003/02/21 22:55:09  arno
% adding gui info
%
% Revision 1.30  2003/01/23 21:34:59  scott
% header edits -sm
%
% Revision 1.29  2003/01/22 22:43:53  scott
% edit header -sm
%
% Revision 1.28  2002/11/14 18:29:03  arno
% new average reference
%
% Revision 1.27  2002/11/14 17:38:31  arno
% gui text
%
% Revision 1.26  2002/11/08 19:05:05  arno
% test if array=string before importing it
%
% Revision 1.25  2002/09/25 23:49:58  arno
% correcting float-le problem
%
% Revision 1.24  2002/09/04 18:28:25  luca
% debug command line big variable passed as text - arno
%
% Revision 1.23  2002/08/29 23:17:01  arno
% debugging icaweights and sphere
%
% Revision 1.22  2002/08/26 22:03:01  arno
% average reference more message
%
% Revision 1.21  2002/08/12 18:31:31  arno
% questdlg2
%
% Revision 1.20  2002/07/31 18:12:35  arno
% reading floats le and be
%
% Revision 1.19  2002/05/21 20:47:02  scott
% removed ; from evalin() commands -sm
%
% Revision 1.18  2002/05/01 01:23:44  luca
% same
%
% Revision 1.17  2002/05/01 01:22:56  luca
% same
%
% Revision 1.16  2002/05/01 01:21:18  luca
% transpose bug
%
% Revision 1.15  2002/04/30 18:38:21  arno
% adding about button
%
% Revision 1.14  2002/04/18 16:19:38  scott
% EEG.averef -sm
%
% Revision 1.13  2002/04/18 16:13:20  scott
% working on EEG.averef -sm
%
% Revision 1.12  2002/04/18 14:43:02  scott
% edited error msgs -sm
%
% Revision 1.11  2002/04/18 02:52:05  scott
% [same] -sm
%
% Revision 1.10  2002/04/18 02:44:08  scott
% edited error messages -sm
%
% Revision 1.9  2002/04/18 02:29:24  arno
% further checks for matlab file import
%
% Revision 1.8  2002/04/11 18:28:58  arno
% adding average reference input
%
% Revision 1.7  2002/04/11 18:01:24  arno
% removing warning when removing ICA components
%
% Revision 1.6  2002/04/10 22:42:11  arno
% debuging variable name
%
% Revision 1.5  2002/04/08 02:29:33  scott
% *** empty log message ***
%
% Revision 1.4  2002/04/08 02:26:28  scott
% *** empty log message ***
%
% Revision 1.3  2002/04/08 02:25:00  scott
% *** empty log message ***
%
% Revision 1.2  2002/04/08 02:22:35  scott
% improved workding, moved 'EEG.data' placement -sm
%
% Revision 1.1  2002/04/05 17:32:13  jorn
% Initial revision
%

% 01-25-02 reformated help & license -ad 
% 03-16-02 text interface editing -sm & ad 
% 03-16-02 remove EEG.xmax et EEG.xmin (for continuous) -ad & sm
% 03-31-02 changed interface, reprogrammed all function -ad
% 04-02-02 recompute event latencies when modifying xmin -ad

function [EEGOUT, com] = pop_editset(EEG, varargin);
   
com = '';
if nargin < 1
   help pop_editset;
   return;
end;   

EEGOUT = EEG;
if nargin < 2                 % if several arguments, assign values 
   % popup window parameters	
   % -----------------------
    geometry    = { [1.5 0.6 1 0.7] [1.1 1 1 0.7]   [2 0.1 1 0.7] [2 0.1 1 0.7] [2 0.1 1 0.7] ...
					[2 0.1 1 0.7] [1.5 0.6 1 0.7] [2 0.1 1 0.7] [2 0.1 1 0.7] [2 0.1 1 0.7] };
    commandload = [ '[filename, filepath] = uigetfile(''*'', ''Select a text file'');' ...
                    'if filename ~=0,' ...
                    '   set(findobj(''parent'', gcbf, ''tag'', tagtest), ''string'', [ filepath filename ]);' ...
                    'end;' ...
                    'clear filename filepath tagtest;' ];
	editcomments = 'set(gcf, ''userdata'', pop_comments(get(gcbf, ''userdata''), ''Edit comments of current dataset''));';
		
    if isstr(EEG.ref)
        curref = EEG.ref;
    else
        if length(EEG.ref) > 1
            curref = [ 'channel(s) ' int2str(abs(EEG.ref)) ];
        else
            curref = [ 'channel ' int2str(abs(EEG.ref)) ];
        end;
    end;
    uilist = { ...