From 0ac562001b125a2b928d57e9daa65ed9165c06e0 Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Thu, 28 Aug 2003 18:03:36 -0500 Subject: [svn-r7429] Purpose: Enhanced indexing; copy edits. Description: Restructured index and clarify descriptions and/or make them more parallel; added link to "Other tools" Added note that h4toh5 and h5toh4 are no longer part of the HDF5 library distribution Lots of copy edits Platforms tested: IE 5, Safari --- doc/html/Tools.html | 147 +++++++++++++++++++++++++++++++++------------------- 1 file changed, 94 insertions(+), 53 deletions(-) diff --git a/doc/html/Tools.html b/doc/html/Tools.html index 8de9377..f7d1675 100644 --- a/doc/html/Tools.html +++ b/doc/html/Tools.html @@ -78,57 +78,84 @@ to convert files from HDF4 format to HDF5 format and vice versa.
  • User utilities: +
  • Configuration and library management utilities: + +
  • Java-based tools for HDF5 + for viewing, manipulating, and generating HDF4 and HDF5 files:
    - Java-based tools for viewing, manipulating, and generating HDF5 - files (distributed separately) + (Distributed separately; external link is + http://hdf.ncsa.uiuc.edu/hdf-java-html/) + + +
  • Data conversion utilities: + + +
  • + HDF5/HDF4 conversion tools:
    - Includes H5view, H5gen, Java HDF5 - Interface (JHI5), and HDF5 VisAD Data Adapter -

    -
  • HDF5/HDF4 conversion tools: + (Distributed separately; external link is + http://hdf.ncsa.uiuc.edu/h4toh5/) + +
  • Other tools, + including third-party and commercial utilities and applications +
    + (Distributed separately; external link is + http://hdf.ncsa.uiuc.edu/tools5.html) + @@ -188,7 +215,7 @@ to convert files from HDF4 format to HDF5 format and vice versa.

    h5dump can also dump a subset of a dataset. This feature operates in much the same way as hyperslabs in HDF5; - the parameters specified on the commnd line are passed to the + the parameters specified on the command line are passed to the function H5Sselect_hyperslab and the resulting selection is displayed. @@ -199,7 +226,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. Data Description Language document.

    - Note: It is not permissable to specify multiple + Note: It is not permissible to specify multiple attributes, datasets, datatypes, groups, or soft links with one flag. For example, one may not issue the command
    @@ -333,7 +360,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. [IETF RFC 2732]) that refers to the DTD to be used to validate the XML

    -

    Subsetting paramaters can also be expressed in a convenient +
    Subsetting parameters can also be expressed in a convenient compact form, as follows:
             @@ -718,7 +745,7 @@ to convert files from HDF4 format to HDF5 format and vice versa.

    Input data and options:
    - Input data can be provided in one of the follwing forms: + Input data can be provided in one of the following forms:

    • As an ASCII, or plain-text, file containing either floating point or integer data
    • As a binary file containing either 32-bit or @@ -790,7 +817,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. etc.
      h5import does not overwrite a pre-existing dataset of the specified or default name. - When an existing dataset of a confilcting name is + When an existing dataset of a conflicting name is encountered, h5import quits with an error; the current input file and any subsequent input files are not processed. @@ -855,7 +882,7 @@ to convert files from HDF4 format to HDF5 format and vice versa.       Compressed and
      -         extendible +         extendable Requires chunked layout.   @@ -979,7 +1006,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. dataset3 for the third input dataset, etc.
      Note that h5import does not overwrite a pre-existing dataset of the specified or default name. - When an existing dataset of a confilcting name is + When an existing dataset of a conflicting name is encountered, h5import quits with an error; the current input file and any subsequent input files are not processed.
      @@ -1183,7 +1210,7 @@ to convert files from HDF4 format to HDF5 format and vice versa.     GZIP Gzip compression.
      - Othe compression algorithms are not implemented + Other compression algorithms are not implemented in this release of h5import. @@ -1288,7 +1315,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. etc.
      h5import does not overwrite a pre-existing dataset of the specified or default name. - When an existing dataset of a confilcting name is + When an existing dataset of a conflicting name is encountered, h5import quits with an error; the current input file and any subsequent input files are not processed. @@ -1373,7 +1400,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. with chunk dimension sizes of 2x2x2x2x2.
      – The output datatype will be 32-bit integer in NATIVE format - (as the output architecure is not specified).
      + (as the output architecture is not specified).
      – The output dataset will be compressed using Gzip compression with a compression level of 7.
      – The output dataset will be stored in @@ -1527,7 +1554,7 @@ to convert files from HDF4 format to HDF5 format and vice versa.
      • HDF5 group objects are converted into HDF4 Vgroup - objects. HDF5 hardlinks and softlinks pointing to + objects. HDF5 hard links and soft links pointing to objects are converted to HDF4 Vgroup references.
      • HDF5 dataset objects of integer datatype are converted into HDF4 SDS objects. These datasets @@ -1565,6 +1592,13 @@ to convert files from HDF4 format to HDF5 format and vice versa. All datatypes are converted to big-endian. Floating point datatypes are converted to IEEE format. +
        Note: +
        The h5toh4 and h4toh5 utilities + are no longer part of the HDF5 product; + they are distributed separately through the page + + Converting between HDF (4.x) and HDF5. +

        Options and Parameters:
        @@ -1627,8 +1661,8 @@ to convert files from HDF4 format to HDF5 format and vice versa. The -h option causes a syntax summary similar to the following to be displayed: 
                      h4toh5 inputfile.hdf outputfile.h5
-              h5toh4 inputfile.hdf
        + h4toh5 inputfile.hdf

        Each object in the HDF4 file is converted to an equivalent HDF5 object, according to the mapping described in @@ -1639,7 +1673,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. Mapping HDF4 Objects to HDF5 Objects on the HDF FTP server.)

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

        @@ -1680,6 +1714,13 @@ to convert files from HDF4 format to HDF5 format and vice versa.
        +
        Note: +
        The h4toh5 and h5toh4 utilities + are no longer part of the HDF5 product; + they are distributed separately through the page + + Converting between HDF (4.x) and HDF5. +

        Options and Parameters:
        -h @@ -1751,7 +1792,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. Example:   HDF5_PARAPREFIX   - Sets the prefix for paralllel output data files. + Sets the prefix for parallel output data files.
        Options and Parameters:
        @@ -1950,7 +1991,7 @@ to convert files from HDF4 format to HDF5 format and vice versa.
        -echo
        Shows all the shell commands executed.
        -force -
        Performs the requested action without offerring any prompt +
        Performs the requested action without offering any prompt requesting confirmation.
        -prefix=dir
        Specifies a new directory in which to find the @@ -1988,7 +2029,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. to compile an HDF5 program. It takes care of specifying where the HDF5 header files and libraries are on the command line.

        - h5cc supercedes all other compiler scripts in that + h5cc supersedes all other compiler scripts in that if you've used them to compile the HDF5 library, then h5cc also uses those scripts. For example, when compiling an MPIch program, you use the mpicc @@ -2070,7 +2111,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. to compile an HDF5 program. It takes care of specifying where the HDF5 header files and libraries are on the command line.

        - h5fc supercedes all other compiler scripts in that + h5fc supersedes all other compiler scripts in that if you've used them to compile the HDF5 Fortran library, then h5fc also uses those scripts. For example, when compiling an MPIch program, you use the mpif90 @@ -2145,7 +2186,7 @@ to convert files from HDF4 format to HDF5 format and vice versa. to compile an HDF5 program. It takes care of specifying where the HDF5 header files and libraries are on the command line.

        - h5c++ supercedes all other compiler scripts in that + h5c++ supersedes all other compiler scripts in that if you've used one set of compiler scripts to compile the HDF5 C++ library, then h5c++ uses those same scripts. For example, when compiling an MPIch program, @@ -2290,7 +2331,7 @@ And in this document, the Describes HDF5 Release 1.6.0, July 2003 -Last modified: 2 July 2003 +Last modified: 16 July 2003 -- cgit v0.12