From af308b715af48d8bebb85192db1161c1b8295231 Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Thu, 21 Dec 2000 14:41:30 -0500 Subject: [svn-r3176] Purpose: Added h4toh5 Platforms tested: IE 5 --- doc/html/Tools.html | 315 ++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 247 insertions(+), 68 deletions(-) diff --git a/doc/html/Tools.html b/doc/html/Tools.html index 5b79cbc..1577b09 100644 --- a/doc/html/Tools.html +++ b/doc/html/Tools.html @@ -55,14 +55,16 @@ These tools enable the user to examine HDF5 files interactively.
    -
  • h5dump -- A tool for displaying - HDF5 file contents -
  • h5ls -- A tool for listing specified - features of HDF5 file contents -
  • h5repart -- A tool for repartitioning - a file, creating a family of files -
  • h5toh4 -- A tool for converting an - HDF5 file to an HDF4 file. +
  • h5dump -- + A tool for displaying HDF5 file contents +
  • h5ls -- + A tool for listing specified features of HDF5 file contents +
  • h5repart -- + A tool for repartitioning a file, creating a family of files +
  • h5toh4 -- + A tool for converting an HDF5 file to an HDF4 file +
  • h4toh5 -- + A tool for converting an HDF4 file to an HDF5 file
@@ -157,35 +159,36 @@ These tools enable the user to examine HDF5 files interactively.
Displays the specified named data type(s).
-w number
Displays the information with the specified number of columns. -
-o filename -
Output the raw data of datasets to a separate file filename. +
-o filename +
Output the raw data of datasets to a separate file + filename.
file
The file to be examined.
Examples: -
    -
  1. Dumping the group /GroupFoo/GroupBar in the file - quux.h5: -
    - h5dump -g /GroupFoo/GroupBar quux.h5 -
    2. -
  2. Dumping the dataset Fnord in the group - /GroupFoo/GroupBar in the file quux.h5: -
    - h5dump -d /GroupFoo/GroupBar/Fnord quux.h5 -
    3. -
  3. Dumping the attribute metadata of the dataset - Fnord which is in group - /GroupFoo/GroupBar in the file quux.h5: -
    - h5dump -a /GroupFoo/GroupBar/Fnord/metadata quux.h5 -
    4. -
  4. Dumping the attribute metadata which is an - attribute of the root group in the file quux.h5: -
    - h5dump -a /metadata quux.h5 -
    5. -
+
    +
  1. Dumping the group /GroupFoo/GroupBar in the file + quux.h5: +
    + h5dump -g /GroupFoo/GroupBar quux.h5 +
    +
  2. Dumping the dataset Fnord in the group + /GroupFoo/GroupBar in the file quux.h5: +
    + h5dump -d /GroupFoo/GroupBar/Fnord quux.h5 +
    +
  3. Dumping the attribute metadata of the dataset + Fnord which is in group + /GroupFoo/GroupBar in the file quux.h5: +
    + h5dump -a /GroupFoo/GroupBar/Fnord/metadata quux.h5 +
    +
  4. Dumping the attribute metadata which is an + attribute of the root group in the file quux.h5: +
    + h5dump -a /metadata quux.h5 +
    +
Current Status:
The current version of h5dump displays the following information: @@ -258,44 +261,58 @@ These tools enable the user to examine HDF5 files interactively. in the specified format.
Options and Parameters:
-
-h   or   -?   or   --help +
-h   or   + -?   or   + --help
Print a usage message and exit. -
-a   or   --address -
Primt addresses for raw data. +
-a   or   + --address +
Primt addresses for raw data.
-d   or   --data
Print the values of datasets. -
-e   or   --errors -
Show all HDF5 error reporting. -
-f   or   --full -
Print full path names instead of base names. -
-g   or   --group -
Show information about a group, not its contents. -
-l   or   --label -
Label members of compound datasets. -
-r   or   --recursive -
List all groups recursively, avoiding cycles. -
-s   or   --string -
Print 1-bytes integer datasets as ASCII. -
-S   or   --simple -
Use a machine-readable output format. -
-wN   or   --width=N +
-e   or   + --errors +
Show all HDF5 error reporting. +
-f   or   + --full +
Print full path names instead of base names. +
-g   or   + --group +
Show information about a group, not its contents. +
-l   or   + --label +
Label members of compound datasets. +
-r   or   + --recursive +
List all groups recursively, avoiding cycles. +
-s   or   + --string +
Print 1-bytes integer datasets as ASCII. +
-S   or   + --simple +
Use a machine-readable output format. +
-wN   or   + --width=N
Set the number of columns of output. -
-v   or   --verbose +
-v   or   + --verbose
Generate more verbose output. -
-V   or   --version +
-V   or   + --version
Print version number and exit. -
-x   or   --hexdump -
Show raw data in hexadecimal format. +
-x   or   + --hexdump +
Show raw data in hexadecimal format.
file
The file name may include a printf(3C) integer format such as %%05d to open a file family.
objects
Each object consists of an HDF5 file name optionally - followed by a slash and an object name within the file - (if no object is specified within the file then the - contents of the root group are displayed). The file name - may include a printf(3C) integer format such - as "%05d" to open a file family. + followed by a slash and an object name within the file + (if no object is specified within the file then the + contents of the root group are displayed). The file name + may include a printf(3C) integer format such + as "%05d" to open a file family.
+
Purpose: +
Converts an HDF4 file to an HDF5 file. +
Description: +
h4toh5 is a file conversion utility that reads + an HDF4 file, h4file (input.hdf for example), + and writes an HDF5 file, h5file (output.h5 + for example), containing the same data. +

+ If no output file h5file is specified, + h4toh5 uses the input filename to designate + the output file, replacing the extension .hdf + with .h5. + For example, if the input file scheme3.hdf is + specified with no output filename, h4toh5 will + name the output file scheme3.h5. +

+ + The -h option causes a syntax summary + similar to the following to be displayed: + 

              h4toh5 inputfile.hdf outputfile.h5
+              h5toh4 inputfile.hdf
+

+ Each object in the HDF4 file is converted to an equivalent + HDF5 object, according to the mapping described in + + Mapping HDF4 Objects to HDF5 Objects. + (If this mapping changes between HDF5 Library releases, a more up-to-date + version may be available at + + Mapping HDF4 Objects to HDF5 Objects on the HDF FTP server.) +

+ In this inital version, h4toh5 converts the following + HDF4 objects: +

+ + + + + + + + +
+ HDF4 Object + + Resulting HDF5 Object +
+ SDS + + Dataset +
+ GR, RI8, and RI24 image + + Dataset +
+ Vdata + + Dataset +
+ Vgroup + + Group +
+ Annotation + + Attribute +
+ Palette + + Dataset +
+
+
Options and Parameters: +
+
-h +
Displays a syntax summary. + +
h4file +
The HDF4 file to be converted. +
h5file +
The HDF5 file to be created. +
+ + + + + + + + + +
@@ -504,7 +683,7 @@ Tools   HDF Help Desk
-Last modified: 17 November 2000 +Last modified: 15 December 2000
Describes HDF5 Release 1.4 Beta, December 2000 -- cgit v0.12