NAME

       h5fromh4 - convert HDF4 scientific datasets to an HDF5 file

SYNOPSIS

       h5fromh4 [OPTION]... [HDF4FILE]...

DESCRIPTION

       h5fromh4  takes  one  or  more  files  in  HDF4  format  and  outputs files in HDF5 format
       containing the datasets from the HDF4 files.  (Currently, only a single dataset  per  HDF4
       file is converted.)

       HDF4  and HDF5 are free, portable binary formats and supporting libraries developed by the
       National Center for Supercomputing Applications at the University of Illinois  in  Urbana-
       Champaign.

       A  single  h5  file can contain multiple data sets; by default, h5fromh4 creates a dataset
       called "data", but this can be  changed  via  the  -d  option,  or  by  using  the  syntax
       HDF5FILE:DATASET  with the -o option.  The -a option can be used to append new datasets to
       an existing HDF5 file.  If the -o option is used and multiple HDF4  files  are  specified,
       all  the  HDF4 datasets are output into that HDF5 file with the input filenames (minus the
       ".hdf" suffix) used as the dataset names.

       The most basic usage is something like 'h5fromh4 foo.hdf', which will output a file foo.h5
       containing the scientific dataset from foo.hdf.

OPTIONS

       -h     Display help on the command-line options and usage.

       -V     Print the version number and copyright info for h5fromh4.

       -v     Verbose output.

       -a     If  the  HDF5  output  file already exists, append the data as a new dataset rather
              than overwriting the file (the default behavior).  An existing dataset of the  same
              name within the file is overwritten, however.

       -o file
              Send  HDF5 output to file rather than to the input filename with .hdf replaced with
              .h5 (the default).  If multiple input files were specified, this causes  all  input
              datasets  to  be  stored  in  file  (rather than in separate files), with the input
              filenames (minus the .hdf suffix) as the dataset names.

       -d name
              Write to dataset name in the output; otherwise, the output dataset is called "data"
              by default.  Alternatively, use the syntax HDF5FILE:DATASET with the -o option.

BUGS

       Send bug reports to S. G. Johnson, stevenj@alum.mit.edu.

AUTHORS

       Written  by  Steven  G.  Johnson.   Copyright  (c)  2005 by the Massachusetts Institute of
       Technology.