[Master Index] [Index for Toolbox]

# load_raw

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

### Function Synopsis

    Out = load_raw(fname,dirpath);

### Help Text

    LOAD_RAW - Read a BrainStorm "raw" format (.txt or .raw) matrix
     function Out = load_raw(fname,dirpath);
     Read the "raw" format into a matrix. Extensions on the filename are expected
     to be "txt" or "raw", which assume ASCII text or single precision binary.  If
     an optional dirpath is given, then file is read from that directory by using a
     "cd" command; otherwise the present working directory is used. If an empty
     filename is given, the an empty matrix is returned.

     FORMATS:
     The BrainStorm "raw" format is for loading sensor and data from arbitrary
     formats. The file extensions are of keywords {.txt, .raw}. Files of extension
     "txt" are considered ASCII (text) files, and extensions of type "raw" are
     considered as binary files. The formats of each are:
     TXT:
       Each line is terminated with an EOL, each ascii number is separated by white
       space. Data are loaded using Matlab's "load -ascii" convention, see Matlab
       help on "load". Matlab command is load('-ascii',fname). The number of rows
       and columns are automatically inferred from the load routine.
     RAW:
       All values are written as single precision binary, i.e. four-byte floats.
       See Matlab help on "single" and on "fread". Data are loaded using fread as
       fread(fname,inf,'single'). The first float is the number of rows, the second
       float is the number of columns, and the remaining rows*columns floats are
       the data in the matrix of dimension rows x columns.

      See also HELP_DATA_RAW

### Cross-Reference Information

This function is called by

    importdata                         C:\BrainStorm_2001\Toolbox\importdata.m

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

    function Out = load_raw(fname,dirpath);
    %LOAD_RAW - Read a BrainStorm "raw" format (.txt or .raw) matrix
    % function Out = load_raw(fname,dirpath);
    % Read the "raw" format into a matrix. Extensions on the filename are expected
    % to be "txt" or "raw", which assume ASCII text or single precision binary.  If
    % an optional dirpath is given, then file is read from that directory by using a
    % "cd" command; otherwise the present working directory is used. If an empty
    % filename is given, the an empty matrix is returned.
    %
    % FORMATS:
    % The BrainStorm "raw" format is for loading sensor and data from arbitrary
    % formats. The file extensions are of keywords {.txt, .raw}. Files of extension
    % "txt" are considered ASCII (text) files, and extensions of type "raw" are
    % considered as binary files. The formats of each are:
    % TXT:
    %   Each line is terminated with an EOL, each ascii number is separated by white
    %   space. Data are loaded using Matlab's "load -ascii" convention, see Matlab
    %   help on "load". Matlab command is load('-ascii',fname). The number of rows
    %   and columns are automatically inferred from the load routine.
    % RAW:
    %   All values are written as single precision binary, i.e. four-byte floats.
    %   See Matlab help on "single" and on "fread". Data are loaded using fread as
    %   fread(fname,inf,'single'). The first float is the number of rows, the second
    %   float is the number of columns, and the remaining rows*columns floats are
    %   the data in the matrix of dimension rows x columns.
    %
    %  See also HELP_DATA_RAW

    %<autobegin> ---------------------- 26-May-2004 11:30:51 -----------------------
    % --------- Automatically Generated Comments Block Using AUTO_COMMENTS ---------
    %
    % CATEGORY: Utility - General
    %
    % At Check-in: $Author: Mosher $  $Revision: 8 $  $Date: 5/26/04 9:59a $
    %
    % 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:30:51 -----------------------

    % Begin --------------------------- History ------------------------------------
    % 19-Apr-2004 JCM Creation, may be redundant with other routines around
    % End ----------------------------- History ------------------------------------

    % CBB: Add error handling for load routines

    if isempty(fname), % no filename given
       Out = [];
       return
    end

    if ~exist('dirpath','var'),
       dirpath = [];
    end

    if ~isempty(dirpath),
       cd(dirpath);
    end

    [ignore,ignore,RawType] = fileparts(fname);

    switch lower(RawType)
       case '.txt'
          Out = load(fname,'-ascii'); % forces an ASCII read of the data file
       case '.raw'
          fid = fopen(fname,'r');
          MatrixSize = fread(fid,[1,2],'single');
          Out = fread(fid,MatrixSize,'single');
          fclose(fid)
    end

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