Documentation for "h4vsread"

H4VSREAD  read  HDF4 vdatas as a structure of arrays

 NAME

   h4vsread -- read an HDF VS as a structure of arrays

 SYNOPSIS

   vlist = h4vsread(hfile) 

 INPUTS

   hfile  - hdf file name

 OUTPUT

   vlist  - cell list of structures arrays and attributes

 OUTPUT DATA FORMAT

   The input vlist is a cell array with one element for each 
   vdata to be written.  Each element of vlist has the form 

                 {vname, vstru, vattr, vclass},   
   where

    - vname is the vdata name

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

    - 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.

    - vclass is an optional vdata class name

 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