The binary dumper utility dumps HDF-EOS objects in binary format. This is useful for feeding the output of it into existing program, which does not understand HDF, for example: custom software and COTS products.

This is a beta release of the "bindmp" utility.

1. Setup the system flag

     The HDFSYS flag is set by the user basing on the platform used. The list below      gives what it should be for each supported platform:

     e.g. setenv HDFSYS DEC_ALPHA

2. Set up the compiler option.

     The CFLAGS flag is set by the user basing on the platform used. The list below      gives what it should be for each supported platform:

     e.g. setenv CFLAGS "-O -std"

     This utility can be build on UNIX from the source code provided in the file      bindmp.c by first modifying the "comp" script by supplying the correct location of      the HDF library and include files on your system and the proper compiler options      from the list below.

     e.g.

     cc -std1 -L/home/urmila/hdfeos/lib -L/home/urmila/hdf/lib      -I/home/urmila/hdfeos/include -I/home/urmila/hdf/include $1 -lhsfeos -lGctp      -lmfhdf -ldf -o $2 -lm -lz

3. To build executable bindmp.

     e.g. comp bindmp.c bindmp

Run instruction.

     See informaiton in the file "bindmp.man". The file "bindmp.man" is a text      version of a manpage for the bindmp utility.

NAME

     binmp - Dumps data of a HDF-EOS object binary.

SYNOPSIS

     bindmp <options> <object_name> <file_name> <output_file>

DESCRIPTION

REQUIRED INPUTS

     object_name
          The HDF-EOS object name.      

     level_number, field_name or -all
          For Swath and Grid data field_name or -all is required.

          For Point Data level_number and field_name or either one of the option or -all           should be given.

     file_name
          The HDF-EOS file name.

     output_file
          The name of the output file where binary data will be written.

OPTIONS

    -l <level_number> (for point data only)
     Writes only the data for the specified level in the POINT object.
     This may be combined with -f <field_name> option, but should
     not be used with -all option.

   -f field_name
     Writes only the data of specified field for the SWATH or GRID object.
     This option should not be used with -all option.

  -all
     Writes data of all fields for SWATH, GRID or POINT object. This option should      not be used with -l (for level) and -f(for field) options.

     EXAMPLES

1. Writes the data from the object SWATH1 in HDF-EOS file "SwathFile.hdf".

--- write all fields from the object SWATH1 using the default format:
    bindmp -all SWATH1 SwathFile.hdf swath.out. (swath.out is the output file where     all the data will be dumped in the binary format).

    bindmp -f Temperature SWATH1 SwathFile.hdf swath.out.

2. Write the data from object "UTM" which is in the HDF-EOS file     "Gridc_Test.hdf".

--- write all fields from the object "UTM" using the default format:

    bindmp -all UTM Gridc_Test.hdf grid.out. (grid.out is the output file where all the     data will be dumped in the binary format).

--- write specified field from the object "UTM" which is in the HDF-EOS file     "Gridc_Test.hdf".

    bindmp -f Voltage UTM Gridc_Test.hdf grid.out.

3. Write the data from the object "Balloon Data" which is in the HDF-EOS file     "balloon_sp.hdfeos".

---write all fields, all levels from the object "Balloon Data" , using the default     format.

    bindmp -all "Balloon Data" balloon_sp.hdfeos point.out. (point.out is the output     file where all the data will be dumped in the binary format).

---write specified level information from the object "Balloon Data" which is in the     HDF-EOS file "balloon_sp.hdfeos".

   bindmp -l 2 "Balloon Data" balloon_sp.hdfeos point.out.

---write specified level along with the field specified field name from the object     "Balloon Data" which is in the HDF-EOS file "balloon_sp.hdfeos".

     bindmp -l 2 -f Time "Balloon Data" balloon_sp.hdfeos point.out.