Home > brede > brede_read_volumes.m

brede_read_volumes

PURPOSE ^

brede_read_volumes - Read volume files

SYNOPSIS ^

function O = brede_read_volumes(filenames, varargin)

DESCRIPTION ^

 brede_read_volumes   - Read volume files

       O = brede_read_volumes(filenames, 'PropertyName',
           'PropertyValue')

       Input:    filenames    Filenames as a cellstring or txt-filename
                              as string with filenames

       Property: Description  String for the description field of the
                              'mat' structure
                 FileType     [ {Analyze} | Guess | NIfTI1 ]
                 Info         [ {0} | waitbar ] Amount of information 
                 Output       [ {mat} | vol ] Output structure
                 VolumeMask   'Vol' structure indicating with
                              non-zero value which voxel should be
                              returned in the 'mat' structure.

       Output:   O          'Mat' or 'vol' structures

       Read a series of volume files. If the files are returned as a
       'mat' structure (output='mat') then each volume file will
       correspond to a row in the O.matrix field.

       Presently, only reading from 3D ANALYZE and Nifti-1 files are
       implemented. 

       The 'VoxelMask' and 'description' property will only work when
       'mat' structure is used as output.

       Example:
         % With 120 ANALYZE files called sn_jerom25_run17_* 
         for n=1:120, f{n}= sprintf('sn_jerom25_run17_%03d',n-1); end
         M = brede_read_volumes(f, 'output', 'mat', 'info', 'waitbar')
         [A,Z] = brede_mat_ica(M, 'components', 5, 'sources', 'right');
         Vz = brede_mat_mat2vol(Z);
         figure, brede_ta2_vol(Vz{1}, 'space', 'jerom')

       See also BREDE, BREDE_READ, BREDE_MAT, BREDE_VOL,
                BREDE_READ_ANALYZE, BREDE_READ_GUESSFILETYPE,
                BREDE_READ_NIFTI1, BREDE_UI_GETFILES, BREDE_VOL_VOL2MAT.

 $Id: brede_read_volumes.m,v 1.8 2008/02/19 19:18:43 fn Exp $

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Fri 27-Nov-2009 18:11:22 by m2html © 2005