Documentation for "h4vswrite"

H4VSWRITE write HDF4 vdatas as a structure of arrays

 NAME

   h4vswrite -- write a structure of arrays as an HDF VS 

 SYNOPSIS

   h4vswrite(hfile, vlist)

 INPUTS

   hfile  - hdf file name
   vlist  - cell list of structures arrays and attributes

 OUTPUT

   an HDF file with a vdata for each matlab structure array

 INPUT 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; if this is not
      specified it defaults to "structure array"

 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