Chunkbinary
-----------

Files in this distribution:

 ChunkBinary/
   Makefiles/
     Makefile_generic    - Generic Makefile
     Makefile_solaris    - Makefile for Solaris platforms
     Makefile_irix       - Makefile for Irix platforms
   src/
     chunkbinary.c       - Source code for the "chunkbinary" executable
   bin/
     chunkbinary         - executable
     f96183063045.ecst   - test input file
                            a 6144 x 6144 array of 16bit unsigned ints
     out.hdf             - test output HDF file


Requirements
------------

  1. You must have the HDF4.1r2 libraries installed on your system.
  2. Make sure that your LD_LIBRARY_PATH (or LD_LIBRARYN32_PATH on Irix)
     environment variable points to the directory containing the HDF
     Libraries

Installation
------------
  1. Copy one of the example Makefiles to the src/ directory and make 
     the appropriate modifications - instructions will be found in the 
     example Makefiles
  2. Type the command `make` - to compile and install the executable
                      `make clean` - removes all objects/executables
  3. `make` will install the chunkbinary executable into the bin/ 
     directory.

Usage
-----

  chunkbinary <binary file> <outfile.hdf> [noattr]

  Examples:
    1. chunkbinary f96183063045.ecst f96183063045.hdf 
   
       This will convert the binary data file f96183063045.ecst
       to its corresponding hdf file along with attributes
    
    2. chunkbinary f96183063045.ecst f96183063045.hdf noattr

       This will convert the binary data file f96183063045.ecst
       to its corresponding hdf file, but without any attributes
   
 
How the Program Works
----------

ChunkBinary converts a 6144 x 6144 array of 16 bit unsigned ints
into a chunked HDF scientific data set.

Since a 6144x6144 array is very large the array must be converted by
reading in the array in sections, a smaller array or set of scanlines.

If your machine does not have enough memory to read in the first
set of scanlines, the chunkbinary program will subdivide the array
into smaller fractions and try to read in that smaller array into memory.