Documentation for "vsfid2mat"

VSFID2MAT write Matlab structure array as an HDF4 vdata, to an open HDF4 file I

 NAME

   vsfid2mat -- read an HDF VS into a matlab structure

 SYNOPSIS

   [vstru, vattr] = vsfid2mat(file_id, vname)

 INPUTS

   file_id   - HDF file ID from hopen
   vname     - name for the new vdata

 OUTPUT

   vstru     - structure of arrays, the main data
   vattr     - cell array of attributes, optional

 OUTPUT DATA FORMATS

   The output vstru is a structure whose fields are fsize-by-nrec
   arrays.  fsize is the field size and nrec the number of records;
   nrec should be the same for all fields.

   The output vattr is a cell list of attribute specifications.
   Each attribute specification is a list of three strings, of 
   the form
                      {fname, aname, aval}
   
   where fname is either a field name or for general attributes the
   vdata name, aname is the attribute name, and aval the attribute
   value.

 NOTES

   vstru is a structure of arrays rather than an array of
   structures, because manipulating the former is much faster
   in Matlab, for large arrays; see stransp1.m and stransp2.m 
   to go between the two formats.


 H. Motteler, 9 July 01