#ifdef RCSID
static char RcsId[] = "@(#)$Revision: 1.2 $";
#endif
/*
$Header: /pita/work/HDF/dev/RCS/test/annotations/README,v 1.2 90/06/27 11:24:15 mfolk beta $

$Log:	README,v $
# Revision 1.2  90/06/27  11:24:15  mfolk
# Revised by Mike Folk.
# 
# Revision 1.1  90/04/19  11:10:52  mfolk
# Initial revision
# 
*/
           ******* Annotations routines *******


This directory contains several program that illustrate the use of 
the HDF annotations interface.  They can also be used to test
the basic functionality of the interface after installing the
HDF library.  

Some programs are for testing the HDF object annotation routines.  
Others are for testing HDF file annotation routines.

There are C versions of all of the programs.  Corresponding (but
not identical) Fortran programs exist for some of the programs.

Programs for testing HDF object annotation interface:

   putSDS_RISan <outfile> <height> <width> <reps>:  writes a file
       containingg some number (<reps>) of SDSs and images.  The
       dimensions of the images are all <height>x<width>.
       Two out of every three SDSs are given annotations, but
       all RISs are given annotations.

   getSDSan <infile>: prints all of the annotations for all of
       of the SDSs in <infile>.

   getSDSlablist <infile>: gets SDS label list for <infile>
   getSDSlablistF:  FORTRAN version.

   ann.test: a script to test the above routines.  The results of 
       running ann.test are shown in the file ann.test.result. This
       script works only with the C routines.

   get1anF: a test program to get the *second* SDS label and description
       from a file.

Programs for testing HDF file annotations:

   file_ann_test:  reads and writes several file ids and one file
        description, then reads back all file ids and the first
        file description from the same file.
   file_ann_testF:  FORTRAN version.

One ancillary routine is included:

    gen2Dfloat contains a program to generate a 2D array of floating
    point numbers for storing in an SDS.  It is called by putSDS_RISan.



