[Master Index] [Index for Toolbox]

# regcheck

## (Toolbox/regcheck.m in BrainStorm 2.0 (Alpha))

### Function Synopsis

    GUI = regcheck(GUI);

### Help Text

    REGCHECK - Check the regularization tag
     function GUI = regcheck(GUI);
     The following three structure fields are optional for regularization purposes.
      They may be null or missing to represent unused. If multiple fields are given,
      then precedence is given in the order given below.
      .Condition, condition number to use in truncation, e.g. 100
      .Energy, fractional energy to use in truncation, e.g. .95
      .Column_norm, condition number to use in Tikhonov regularization, e.g. 100
      If all are null, no regularization is performed in the RAP-MUSIC loops.
     Returns the same structure, but with all regularization conditions set to exist
      and the field GUI.REG set to the correct field string, such that
      getfield(GUI,GUI.REG) returns the parameter associated with the string.

### Cross-Reference Information

This function is called by

    lcmvbf                             C:\BrainStorm_2001\Toolbox\lcmvbf.m
    least_squares_fit                  C:\BrainStorm_2001\Toolbox\least_squares_fit.m
    minnorm                            C:\BrainStorm_2001\Toolbox\minnorm.m
    rapmusic_gui                       C:\BrainStorm_2001\Toolbox\rapmusic_gui.m

### Listing of function C:\BrainStorm_2001\Toolbox\regcheck.m

    function GUI = regcheck(GUI);
    %REGCHECK - Check the regularization tag
    % function GUI = regcheck(GUI);
    % The following three structure fields are optional for regularization purposes.
    %  They may be null or missing to represent unused. If multiple fields are given,
    %  then precedence is given in the order given below.
    %  .Condition, condition number to use in truncation, e.g. 100
    %  .Energy, fractional energy to use in truncation, e.g. .95
    %  .Column_norm, condition number to use in Tikhonov regularization, e.g. 100
    %  If all are null, no regularization is performed in the RAP-MUSIC loops.
    % Returns the same structure, but with all regularization conditions set to exist
    %  and the field GUI.REG set to the correct field string, such that
    %  getfield(GUI,GUI.REG) returns the parameter associated with the string.

    %<autobegin> ---------------------- 26-May-2004 11:34:14 -----------------------
    % --------- Automatically Generated Comments Block Using AUTO_COMMENTS ---------
    %
    % CATEGORY: Inverse Modeling
    %
    % At Check-in: $Author: Mosher $  $Revision: 12 $  $Date: 5/26/04 10:02a $
    %
    % This software is part of BrainStorm Toolbox Version 2.0 (Alpha) 24-May-2004
    %
    % Principal Investigators and Developers:
    % ** Richard M. Leahy, PhD, Signal & Image Processing Institute,
    %    University of Southern California, Los Angeles, CA
    % ** John C. Mosher, PhD, Biophysics Group,
    %    Los Alamos National Laboratory, Los Alamos, NM
    % ** Sylvain Baillet, PhD, Cognitive Neuroscience & Brain Imaging Laboratory,
    %    CNRS, Hopital de la Salpetriere, Paris, France
    %
    % See BrainStorm website at http://neuroimage.usc.edu for further information.
    %
    % Copyright (c) 2004 BrainStorm by the University of Southern California
    % This software distributed  under the terms of the GNU General Public License
    % as published by the Free Software Foundation. Further details on the GPL
    % license can be found at http://www.gnu.org/copyleft/gpl.html .
    %
    % FOR RESEARCH PURPOSES ONLY. THE SOFTWARE IS PROVIDED "AS IS," AND THE
    % UNIVERSITY OF SOUTHERN CALIFORNIA AND ITS COLLABORATORS DO NOT MAKE ANY
    % WARRANTY, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
    % MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, NOR DO THEY ASSUME ANY
    % LIABILITY OR RESPONSIBILITY FOR THE USE OF THIS SOFTWARE.
    %<autoend> ------------------------ 26-May-2004 11:34:14 -----------------------

    % $Date: 5/26/04 10:02a $ $Revision: 12 $

    % Establish the regularization
    if(~isfield(GUI,'Condition')),
      GUI.Condition = [];
    end
    if(~isfield(GUI,'Energy'))
      GUI.Energy = [];
    end
    if(~isfield(GUI,'Column_norm'))
      GUI.Column_norm = 0; % by default, don't column normalize
    end
    if(~isfield(GUI,'Tikhonov')),
      GUI.Tikhonov = [];
    end

    % Now set the regularization switch
    if(~isempty(GUI.Condition)),
      GUI = setfield(GUI,'REG','Condition');
    elseif(~isempty(GUI.Energy)),
      GUI = setfield(GUI,'REG','Energy');
    elseif(~isempty(GUI.Tikhonov)),
      GUI = setfield(GUI,'REG','Tikhonov');
    else
      GUI = setfield(GUI,'REG','None');
    end

    return

Produced by color_mat2html, a customized BrainStorm 2.0 (Alpha) version of mat2html on Tue Nov 2 16:17:59 2004
Cross-Directory links are: ON