h5toh4 -h
h5toh4
h5file [-r[oot]]
h4file h5toh4
h5file [-r[oot]]h5toh4 -m
h5file1 [-r[oot]]
[h5file2 [-r[oot]]]
[h5file3 [-r[oot]]] ...h5toh4 -h[elp], OR
h5toh4 <infile> [-r[oot]] [<outfile>]
h5toh4 -m[ultiple] <infile> [-r[oot]] [<infile> [-r[oot]] ...]
h5toh4
is an HDF5 utility which reads
an HDF5 file, h5file, and converts all
supported objects to produce an HDF4 file,
h4file. If h4file already exists,
it will be replaced.
If only one file name is given, the name must end in
.h5
and is assumed to represent the
HDF5 input file. h5toh4
replaces the
.h5
suffix with .hdf
to form
the name of the resulting HDF4 file and proceeds as above.
If a file with the name of the intended HDF4 file already
exists, h5toh4
exits with an error without
changing the contents of any file.
The -m
option allows multiple HDF5 file
arguments. Each file name is treated the same as the
single file name case above.
The -h
option causes the following
syntax summary to be displayed.
The following HDF5 objects occurring in an HDF5 file are converted to HDF4 objects in the HDF4 file:
- By default, the HDF5 root group is removed from the file after all the root group attributes are processed.
- Attributes of the root group are written as HDF4 file descriptions with the value "HDF5_<AttributeName> = <AttributeValue>"
- Attributes of the root group suffixed with GLO_SDS are written as global to the SD interface. Similarly, attributes suffixed with GLO_GR are written as global to the GR interface.
- An HDF5 dataset (see HDF5 Image specification (http://hdf.ncsa.uiuc.edu/HDF5/doc/ADGuide/ImageSpec.html) is converted into an HDF4 GR Image. Corresponding HDF5 palette datasets are converted to HDF4 pallete objects.
- HDF5 Table data (see the HDF5 Table specification http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5tb_spec.html) is stored as an HDF4 Vdata.
- Attributes created by the h4toh5 utility are converted into an HDF5 attribute or annotation that corresponds to the original, or else are omitted if not needed.
Attributes not described above are copied to attributes of the HDF4 objects. Attributes may be of integer, floating point, or fixed length string datatype and they may have up to 32 fixed dimensions.
All datatypes are converted to big-endian. Floating point datatypes are converted to IEEE format.
-h
-m
-r[oot]
- This is an optional argument. When specified, the root group in the HDF5 file is converted to a 'dummy' vgroup in the HDF4 file giving a single rooted tree in the HDF4 file. When this option is not specified, the dummy vgroup is omitted.