From 750856c53aa1cae3217e853ab7571b20bc658ffc Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Thu, 10 Sep 1998 10:40:15 -0500 Subject: [svn-r684] RM_H5Front.html Added link to Tools.html Clean up formatting. Added RM_H5R.html, Ragged Arrays, but link is commented out for Beta. RM_H5.html H5version Removed patch number parameter. H5check_version Removed patch number parameter. Corrected datatype to unsigned (was unsigned *). Added missing "Purpose:" statement. RM_H5A.html H5Aread/write Added reference to data conversion limitations. RM_H5D.html H5Dwrite Added "Writing to an external dataset will fail if the HDF5 file is not open for writing." H5Dread/write Added reference to data conversion limitations. RM_H5F.html H5Fflush Added H5Fflush. RM_H5G.html H5Gget_stat Fixed formatting error. Added mtime to the description of the data structure. Added the following "Note:", per Robb's checkin mesage: "Some systems will be able to record the time accurately but unable to retrieve the correct time; such systems (e.g., Irix64) will report an mtime value of 0 (zero)." Corrected successful return value. H5Gset_comment Added the following statement to "Description:" "Comments can be attached to any object that has an object header, e.g., data sets, groups, named data types, and data spaces, but not symbolic links. RM_H5P.html Cleaned up file formatting. H5Pset_filter Added these three functions. H5Pget_nfilters H5Pget_filter H5Pget_deflate Removed these three functions. (Actually, H5Pset_compression they are commented out, in case they should H5Pget_compression be reinstated.) RM_H5R.html Intial version of H5R reference manual entry, but still largely just a template. Not yet ready for distribution. Links to this document are currently commented out. RM_H5S.html H5S_set_extent_simple Changed name to H5Sselect_extent_simple. now: H5Sselect_extent_simpl H5Sselect_npoints Corrected return value. Now: H5Sget_select_npoints H5Sget_class Reinstated to RM. Changed name. now: H5Sget_space_type H5Soffset_simple Added these 6 functions. The there is a H5Sextent_copy link to Dataspaces.html for the 10 "not yet H5Sset_extent_none implemented (NYI)" functions. H5Sselect_all H5Sselect_none H5Sselect_valid RM_H5T.html Added the following datatypes (though the list of native datatypes is commented out): H5T_NATIVE_HSIZE H5T_NATIVE_HSSIZE H5T_NATIVE_HERR H5T_NATIVE_HBOOL Tools.html Corrected h5ls and h5repart sections. Glossary.html Unlinked for Beta. Copyright.html New file. Copyright statement, linked into User's Guide and Reference Manual. General Changed the following function names: From: To: H5version H5get_libversion H5vers_check H5check_version H5Anum_attrs H5Aget_num_attrs H5Fget_create_template H5Fget_create_plist H5Fget_access_template H5Fget_access_plist And associated "template" -> "property list" edits. H5Gstat H5Gget_stat H5Sextent_npoints H5Sget_simple_extent_npoints H5Sextent_ndims H5Sget_simple_extent_ndims H5Sextent_dims H5Sget_simple_extent_dims H5Sget_class H5Sget_simple_extent_type H5Sselect_npoints H5Sget_select_npoints Added links to Tools.html and RM_H5R.html (Ragged Arrays), though link to RM_H5R.html is commented out for now. --- doc/src/Copyright.html | 76 +++++++++ doc/src/Glossary.html | 36 ++-- doc/src/RM_H5.html | 41 ++--- doc/src/RM_H5A.html | 32 +++- doc/src/RM_H5D.html | 27 ++- doc/src/RM_H5E.html | 6 + doc/src/RM_H5F.html | 64 +++++-- doc/src/RM_H5Front.html | 32 +++- doc/src/RM_H5G.html | 33 +++- doc/src/RM_H5P.html | 431 +++++++++++++++++++++++++++++++++++++++--------- doc/src/RM_H5R.html | 248 ++++++++++++++++++++++++++++ doc/src/RM_H5S.html | 269 +++++++++++++++++++++++++++--- doc/src/RM_H5T.html | 18 +- doc/src/RM_H5Z.html | 6 + doc/src/Tools.html | 27 +-- 15 files changed, 1163 insertions(+), 183 deletions(-) create mode 100644 doc/src/Copyright.html create mode 100644 doc/src/RM_H5R.html diff --git a/doc/src/Copyright.html b/doc/src/Copyright.html new file mode 100644 index 0000000..f295867 --- /dev/null +++ b/doc/src/Copyright.html @@ -0,0 +1,76 @@ + + +HDF5 Copyright Notice + + + + + +
+ +

Copyright Notice and Statement for +
+NCSA Hierarchical Data Format (HDF) Software Library and Utilities

+
+

+ + +NCSA Hierarchical Data Format (HDF) Software Library and Utilities +
+Copyright 1998 the Board of Trustees of the University of Illinois +
+All rights reserved. +

+ +Contributors: National Center for Supercomputing Applications (NCSA) at +the University of Illinois, Lawrence Livermore Nat'l Laboratory (LLNL), +Sandia National Laboratories (SNL), Los Alamos National Laboratory (LANL), +Jean-loup Gailly and Mark Adler (gzip library) +

+ +Redistribution and use in source and binary forms, with or without +modification, are permitted for any purpose (including commercial purposes) +provided that the following conditions are met: +

+ +

    +
  1. Redistributions of source code must retain the above copyright notice, +this list of conditions and the following disclaimer. + +
  2. Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or materials provided with the distribution. + +
  3. In addition, redistributions of modified forms of the source or binary +code must carry prominent notices stating that the original code was +changed and the date of the change. + +
  4. All publications or advertising materials mentioning features or use of +this software must acknowledge that it was developed by the National Center +for Supercomputing Applications at the University of Illinois, and credit +the Contributors. + +
  5. Neither the name of the University nor the names of the Contributors may +be used to endorse or promote products derived from this software without +specific prior written permission from the University or the Contributors. + +
  6. THIS SOFTWARE IS PROVIDED BY THE UNIVERSITY AND THE CONTRIBUTORS "AS IS" +WITH NO WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED. In no event +shall the University or the Contributors be liable for any damages suffered +by the users arising out of the use of this software, even if advised of +the possibility of such damage. + +
+ + +
+ +
+HDF Help Desk + +
+Last modified: 8 September 1998 + + + + diff --git a/doc/src/Glossary.html b/doc/src/Glossary.html index 31b2db6..9c727a4 100755 --- a/doc/src/Glossary.html +++ b/doc/src/Glossary.html @@ -25,23 +25,29 @@ Glossary

HDF5 Glossary

-(Under construction! - This is the bare beginning of a Glossary to accompany the HDF5 documentation; - it is by no means complete.) +(Under construction! + This is the bare beginning of a Glossary to accompany the HDF5 + documentation; it is by no means complete.) -
    -
  1. Basic Types -
  2. Complex Types -
  3. Disk I/O Types -
+ -

Since many of the typedefs in the HDF5 API are not well-defined yet, -the types below may change radically en route to a final API...

-Basic Types: +basic data types: -Complex Types: +Complex data types: -Disk I/O Types: +disk I/O data types: diff --git a/doc/src/RM_H5.html b/doc/src/RM_H5.html index 8b2ab70..ad2cb8d 100755 --- a/doc/src/RM_H5.html +++ b/doc/src/RM_H5.html @@ -18,7 +18,10 @@ H5   H5S   H5T   H5Z   +Tools   +
@@ -37,8 +40,8 @@ and it users.              
hid_t create_id -
File creation template identifier, used when modifying +
File creation property list identifier, used when modifying default file meta-data.
hid_t access_id
File access property list identifier. If parallel file access is desired, this is a collective call according to the communicator stored in the - access_template. - Use 0 for default access template. + access_id. + Use 0 for default access properties.
Returns:
Returns a file identifier if successful; @@ -168,6 +172,33 @@ documented below.
+
Name: H5Fflush +
Signature: +
herr_t H5Fis_hdf5(hid_t object_id + ) +
Purpose: +
Flushes all buffers associated with a file to disk. +
Description: +
H5Fflush causes all buffers associated with a + file to be immediately flushed to disk without removing the + data from the cache. +

+ object_id can be any object associated with the file, + including the file itself, a dataset, a group, an attribute, or + a named data type. +

Parameters: +
+
const char *object_id +
Identifier of object used to identify the file. +
+
Returns: +
Returns SUCCEED (0) if successful; + otherwise returns FAIL (-1). +
+ + +
+
Name: H5Fis_hdf5
Signature:
hbool_t H5Fis_hdf5(const char *name @@ -190,14 +221,14 @@ documented below.
-
Name: H5Fget_create_template +
Name: H5Fget_create_plist
Signature: -
hid_t H5Fget_create_template(hid_t file_id +
hid_t H5Fget_create_plist(hid_t file_id )
Purpose:
Returns a file creation property list identifier.
Description: -
H5Fget_create_template returns a file creation +
H5Fget_create_plist returns a file creation property list identifier identifying the creation properties used to create this file. This function is useful for duplicating properties when creating another file. @@ -222,13 +253,13 @@ documented below.
-
Name: H5Fget_access_template +
Name: H5Fget_access_plist
Signature: -
hid_t H5Fget_access_template(hid_t file_id) +
hid_t H5Fget_access_plist(hid_t file_id)
Purpose:
Returns a file access property list identifier.
Description: -
H5Fget_access_template returns the +
H5Fget_access_plist returns the file access property list identifier of the specified file.

See "File Access Properties" in @@ -286,7 +317,10 @@ H5F   H5S   H5T   H5Z   +Tools   +

@@ -294,7 +328,7 @@ H5F   HDF Help Desk
-Last modified: 14 July 1998 +Last modified: 14 August 1998 diff --git a/doc/src/RM_H5Front.html b/doc/src/RM_H5Front.html index 9c4e1ce..c3701b8 100644 --- a/doc/src/RM_H5Front.html +++ b/doc/src/RM_H5Front.html @@ -14,10 +14,16 @@ HDF5 Reference Manual  H5F   H5G   H5P   + H5S   H5T   H5Z   +Tools   +
@@ -32,7 +38,7 @@ tools required to meet specific aspects of the HDF5 data-handling requirements.
  • Library Functions -- The general-purpose H5 functions.
  • File Interface -- The H5F API for accessing HDF files. -
  • Property List Interface -- The H5P API for manipulating object templates. +
  • Property List Interface -- The H5P API for manipulating object property lists.
  • Dataset Interface -- The H5D API for manipulating scientific datasets.
  • Datatype Interface -- The H5T API for defining dataset element information.
  • Dataspace Interface -- The H5S API for defining dataset dataspace. @@ -40,7 +46,14 @@ tools required to meet specific aspects of the HDF5 data-handling requirements.
  • Error Interface -- The H5E API for error handling.
  • Compression Interface -- The H5Z API for compression.
  • Annotation Interface -- The H5A API for annotations. +
  • Tools -- Interactive tools for the examination of existing HDF5 files. + + @@ -55,18 +68,31 @@ HDF5 Reference Manual  H5F   H5G   H5P   + H5S   H5T   H5Z   +Tools   +
    + + +
    HDF Help Desk -
    -Last modified: 14 July 1998 +Last modified: 8 September 1998 + +    		 +Copyright   +
    + diff --git a/doc/src/RM_H5G.html b/doc/src/RM_H5G.html index 178737b..634d071 100644 --- a/doc/src/RM_H5G.html +++ b/doc/src/RM_H5G.html @@ -18,7 +18,10 @@ H5G   H5S   H5T   H5Z   +Tools   +
    @@ -50,7 +53,7 @@ of objects on disk.       
      -
    • H5Gstat +
    • H5Gget_stat
    • H5Gget_linkval
    • H5Gset_comment
    • H5Gget_comment @@ -503,9 +506,9 @@ then be trivial.
      -
      Name: H5Gstat +
      Name: H5Gget_stat
      Signature: -
      herr_t H5Gstat(hid_t loc_id, +
      herr_t H5Gget_stat(hid_t loc_id, const char *name, hbool_t follow_link, H5G_stat_t *statbuf @@ -513,7 +516,7 @@ then be trivial.
      Purpose:
      Returns information about an object.
      Description: -
      H5Gstat returns information about the +
      H5Gget_stat returns information about the specified object through the statbuf argument. loc_id (a file, group, or dataset identifier) and name together determine the object. @@ -527,13 +530,14 @@ then be trivial. The existence of an object can be tested by calling this function with a null statbuf.

      - H5Gstat() fills in the following data structure: + H5Gget_stat() fills in the following data structure: 

                         typedef struct H5G_stat_t {
                       unsigned long fileno[2];
                       unsigned long objno[2];
                       unsigned nlink;
                       H5G_type_t type;
+                      time_t mtime; 
                       size_t linklen;
                   } H5G_stat_t
      @@ -549,11 +553,16 @@ then be trivial. The type field contains the type of the object, one of H5G_GROUP, H5G_DATASET, or H5G_LINK. + The mtime field contains the modification time. If information is being returned about a symbolic link then linklen will be the length of the link value (the name of the pointed-to object with the null terminator); otherwise linklen will be zero. Other fields may be added to this structure in the future. +
      Note: +
      Some systems will be able to record the time accurately but + unable to retrieve the correct time; such systems (e.g., Irix64) + will report an mtime value of 0 (zero).
      Parameters:
      hid_t loc_id @@ -566,7 +575,8 @@ then be trivial.
      OUT: Buffer in which to return information about the object.
      Returns: -
      Returns SUCCEED (0) with the fields of STATBUF (if non-null) initialized. +
      Returns SUCCEED (0) with the fields of statbuf + (if non-null) initialized. Otherwise returns FAIL (-1).
      @@ -594,7 +604,7 @@ then be trivial. The presence of a symbolic link can be tested by passing zero for size and NULL for value.

      - Use H5Gstat() to get the size of a link value. + Use H5Gget_stat() to get the size of a link value.

      Parameters:
      hid_t loc_id @@ -638,6 +648,10 @@ then be trivial.

      Comments should be relatively short, null-terminated, ASCII strings. +

      + Comments can be attached to any object that has an object header, + e.g., data sets, groups, named data types, and data spaces, but + not symbolic links.

      Parameters:
      hid_t loc_id @@ -713,7 +727,10 @@ H5G   H5S   H5T   H5Z   +Tools   +
      @@ -721,7 +738,7 @@ H5G   HDF Help Desk
      -Last modified: 14 July 1998 +Last modified: 2 September 1998 diff --git a/doc/src/RM_H5P.html b/doc/src/RM_H5P.html index 5329ec1..d9f1191 100644 --- a/doc/src/RM_H5P.html +++ b/doc/src/RM_H5P.html @@ -18,14 +18,16 @@ H5P   H5S   H5T   H5Z   +Tools   +

      H5P: Property List Interface

      -

      Property List API Functions

      These functions manipulate property list objects to allow objects which require @@ -88,9 +90,14 @@ many different parameters to be easily manipulated.
    • H5Pset_chunk
    • H5Pget_chunk
    • H5Pset_deflate + +
    • H5Pset_filter +
    • H5Pget_nfilters +
    • H5Pget_filter
    • H5Pset_external
    • H5Pget_external_count
    • H5Pget_external @@ -161,7 +168,6 @@ many different parameters to be easily manipulated. otherwise Fail (-1).
      • -
      Name: H5Pclose @@ -439,7 +445,7 @@ many different parameters to be easily manipulated.
      H5Pget_mpi retrieves the communicator and info object that have been set by H5Pset_mpi. This function is available only in the parallel HDF5 library - and is not a collective function. + and is not a collective function.
      Parameters:
      hid_t plist @@ -504,10 +510,10 @@ many different parameters to be easily manipulated.
      Purpose:
      Retrieves the transfer mode from the dataset transfer property list.
      Description: -
      H5Pget_xfer retrieves the transfer mode from the dataset - transfer property list. +
      H5Pget_xfer retrieves the transfer mode from the + dataset transfer property list. This function is available only in the parallel HDF5 library - and is not a collective function. + and is not a collective function.
      Parameters:
      hid_t plist @@ -532,22 +538,23 @@ many different parameters to be easily manipulated.
      Purpose:
      Sets the size of parameters used to control the symbol table nodes.
      Description: -
      H5Pset_sym_k sets the size of parameters used to control the - symbol table nodes. This function is only valid for - file creation property lists. Passing in a value of 0 for one of the - parameters retains the current value. +
      H5Pset_sym_k sets the size of parameters used to + control the symbol table nodes. This function is only valid + for file creation property lists. Passing in a value of 0 for + one of the parameters retains the current value.

      ik is one half the rank of a tree that stores a symbol table for a group. Internal nodes of the symbol table are on average 75% full. That is, the average rank of the tree is 1.5 times the value of ik.

      - lk is one half of the number of symbols that can be stored in - a symbol table node. A symbol table node is the leaf of a - symbol table tree which is used to store a group. When - symbols are inserted randomly into a group, the group's + lk is one half of the number of symbols that can + be stored in a symbol table node. A symbol table node is the + leaf of a symbol table tree which is used to store a group. + When symbols are inserted randomly into a group, the group's symbol table nodes are 75% full on average. That is, they - contain 1.5 times the number of symbols specified by lk. + contain 1.5 times the number of symbols specified by + lk.

      Parameters:
      hid_t plist @@ -576,11 +583,12 @@ many different parameters to be easily manipulated. and the symbol table leaf node 1/2 size.
      Description:
      H5Pget_sym_k retrieves the size of the - symbol table B-tree 1/2 rank and the symbol table leaf node 1/2 size. - This function is only valid for file creationproperty lists. - If a parameter valued is set to NULL, that parameter is not retrieved. - See the description for H5Pset_sym_k - for more information. + symbol table B-tree 1/2 rank and the symbol table leaf + node 1/2 size. This function is only valid for file creation + property lists. If a parameter valued is set to NULL, that + parameter is not retrieved. See the description for + H5Pset_sym_k for more + information.
      Parameters:
      hid_t plist @@ -607,14 +615,16 @@ many different parameters to be easily manipulated.
      Sets the size of the parameter used to control the B-trees for indexing chunked datasets.
      Description: -
      H5Pset_istore_k sets the size of the parameter used to control the - B-trees for indexing chunked datasets. This function is only valid for - file creation property lists. Passing in a value of 0 for one of the - parameters retains the current value. +
      H5Pset_istore_k sets the size of the parameter + used to control the B-trees for indexing chunked datasets. + This function is only valid for file creation property lists. + Passing in a value of 0 for one of the parameters retains + the current value.

      - ik is one half the rank of a tree that stores chunked raw - data. On average, such a tree will be 75% full, or have an - average rank of 1.5 times the value of ik. + ik is one half the rank of a tree that stores + chunked raw data. On average, such a tree will be 75% full, + or have an average rank of 1.5 times the value of + ik.

      Parameters:
      hid_t plist @@ -705,9 +715,9 @@ many different parameters to be easily manipulated.
      Purpose:
      Returns the layout of the raw data for a dataset.
      Description: -
      H5Pget_layout returns the layout of the raw data for a dataset. - This function is only valid for dataset creation property lists. - Valid types for layout are: +
      H5Pget_layout returns the layout of the raw data for + a dataset. This function is only valid for dataset creation + property lists. Valid types for layout are:
        H5D_COMPACT
        Raw data and object header stored contiguously in file. @@ -741,13 +751,14 @@ many different parameters to be easily manipulated.
        Purpose:
        Sets the size of the chunks used to store a chunked layout dataset.
        Description: -
        H5Pset_chunk sets the size of the chunks used to store a chunked - layout dataset. This function is only valid for dataset creation - property lists. The ndims parameter currently must be the - same size as the rank of the dataset. The values of the - dim array define the size of the chunks to store the - dataset's raw data. As a side-effect, the layout of the dataset is - changed to H5D_CHUNKED, if it isn't already. +
        H5Pset_chunk sets the size of the chunks used to + store a chunked layout dataset. This function is only valid + for dataset creation property lists. + The ndims parameter currently must be the same size + as the rank of the dataset. The values of the dim + array define the size of the chunks to store the dataset's raw data. + As a side-effect, the layout of the dataset is changed to + H5D_CHUNKED, if it is not already.
        Parameters:
        hid_t plist @@ -773,6 +784,7 @@ many different parameters to be easily manipulated. )
        Purpose:
        Retrieves the size of chunks for the raw data of a chunked layout dataset. +
        Description:
        H5Pget_chunk retrieves the size of chunks for the raw data of a chunked layout dataset. @@ -940,8 +952,8 @@ many different parameters to be easily manipulated.
        Purpose:
        Returns information about an external file.
        Description: -
        H5Pget_external returns information about an external file. - The external file is specified by its index, idx, +
        H5Pget_external returns information about an external + file. The external file is specified by its index, idx, which is a number from zero to N-1, where N is the value returned by H5Pget_external_count(). At most name_size characters are copied into the @@ -977,6 +989,189 @@ many different parameters to be easily manipulated.
        +
        Name: H5Pset_filter +
        Signature: +
        herr_t H5Pset_filter(hid_t plist, + H5Z_filter_t filter, + unsigned int flags, + size_t cd_nelmts, + const unsigned int cd_values[] + ) +
        Purpose: +
        Adds a filter to the filter pipeline. +
        Description: +
        H5Pset_filter adds the specified + filter and corresponding properties to the + end of an output filter pipeline. + If plist is a dataset creation property list, + the filter is added to the permanent filter pipeline; + if plist is a dataset transfer property list, + the filter is added to the transient filter pipeline. +

        + The array cd_values contains + cd_nelmts integers which are auxiliary data + for the filter. The integer values will be stored in the + dataset object header as part of the filter information. +

        + The flags argument is a bit vector with + the following fields specifying certain general properties + of the filter: +

        + + + + + + +
        H5Z_FLAG_OPTIONAL  If this bit is set then the filter is + optional. If the filter fails (see below) during an + H5Dwrite() operation then the filter is + just excluded from the pipeline for the chunk for which + it failed; the filter will not participate in the + pipeline during an H5Dread() of the chunk. + This is commonly used for compression filters: if the + compression result would be larger than the input then + the compression filter returns failure and the + uncompressed data is stored in the file. If this bit is + clear and a filter fails then H5Dwrite() + or H5Dread() also fails.
        +
        +
        Note: +
        This function currently supports only the permanent filter + pipeline; plist_id must be a dataset creation + property list. +
        Parameters: +
        +
        hid_t plist +
        IN: Property list identifier. +
        H5Z_filter_t filter +
        IN: Filter to be added to the pipeline. +
        unsigned int flags +
        IN: Bit vector specifying certain general properties + of the filter. +
        size_t cd_nelmts +
        IN: Number of elements in cd_values +
        const unsigned int cd_values[] +
        IN: Auxiliary data for the filter. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Pget_nfilters +
        Signature: +
        int H5Pget_nfilters(hid_t plist) +
        Purpose: +
        Returns the number of filters in the pipeline. +
        Description: +
        H5Pget_nfilters returns the number of filters + defined in the filter pipeline associated with the property list + plist. +

        + In each pipeline, the filters are numbered from + 0 through N-1, where N is the value returned + by this function. During output to the file, the filters are + applied in increasing order; during input from the file, they + are applied in decreasing order. +

        + H5Pget_nfilters returns the number of filters + in the pipeline, including zero (0) if there + are none. +

        Note: +
        This function currently supports only the permanent filter + pipeline; plist_id must be a dataset creation + property list. +
        Parameters: +
        +
        hid_t plist +
        IN: Property list identifier. +
        +
        Returns: +
        Returns the number of filters in the pipeline if successful; + otherwise returns FAIL (-1). +
        + + +
        +
        +
        Name: H5Pget_filter +
        Signature: +
        H5Z_filter_t H5Pget_filter(hid_t plist, + int filter_number, + unsigned int *flags, + size_t *cd_nelmts, + unsigned int *cd_values, + size_t namelen, + char name[] + ) +
        Purpose: +
        Returns information about a filter in a pipeline. +
        Description: +
        + H5Pget_filter returns information about a + filter, specified by its filter number, in a filter pipeline, + specified by the property list with which it is associated. +

        + If plist is a dataset creation property list, + the pipeline is a permanent filter pipeline; + if plist is a dataset transfer property list, + the pipeline is a transient filter pipeline. +

        + On input, cd_nelmts indicates the number of entries + in the cd_values array, as allocated by the caller; + on return,cd_nelmts contains the number of values + defined by the filter. +

        + filter_number is a value between zero and + N-1, as described in + H5Pget_nfilters(). + The function will return FAIL (-1) if the filter number is out + of range. +

        + If name is a pointer to an array of at least + namelen bytes, the filter name will be copied + into that array. The name will be null terminated if + namelen is large enough. The filter name returned + will be the name appearing in the file, the name registered + for the filter, or an empty string. +

        + The structure of the flags argument is discussed + in H5Pset_filter(). +

        Note: +
        This function currently supports only the permanent filter + pipeline; plist must be a dataset creation property + list. +
        Parameters: +
        +
        hid_t plist +
        IN: Property list identifier. +
        int filter_number +
        IN: Sequence number within the filter pipeline of + the filter for which information is sought. +
        unsigned int *flags +
        OUT: Bit vector specifying certain general properties + of the filter. +
        size_t *cd_nelmts +
        IN/OUT: Number of elements in cd_values +
        unsigned int *cd_values +
        OUT: Auxiliary data for the filter. +
        size_t namelen +
        IN: Anticipated number of characters in name. +
        char name[] +
        OUT: Name of the filter. +
        +
        Returns: +
        Returns the filter identification number if successful. + Otherwise returns H5Z_FILTER_ERROR (-1). +
        + + +
        +
        Name: H5Pget_driver
        Signature:
        H5F_driver_t H5Pget_driver(hid_t plist, @@ -1015,9 +1210,8 @@ many different parameters to be easily manipulated. in the stdio.h.
        Description:
        H5Pset_stdio sets the low level file driver to use - the functions declared - in the stdio.h file: fopen(), fseek() or fseek64(), fread(), - fwrite(), and fclose(). + the functions declared in the stdio.h file: fopen(), fseek() + or fseek64(), fread(), fwrite(), and fclose().
        Parameters:
        hid_t plist @@ -1113,13 +1307,14 @@ many different parameters to be easily manipulated.
        Purpose:
        Sets the low-level file driver to use malloc() and free().
        Description: -
        H5Pset_core sets the low-level file driver to use malloc() and free(). +
        H5Pset_core sets the low-level file driver to use + malloc() and free(). This driver is restricted to temporary files which are not - larger than the amount of virtual memory available. The - INCREMENT argument determines the file block size and memory - will be allocated in multiples of INCREMENT bytes. A liberal - INCREMENT results in fewer calls to realloc() and probably - less memory fragmentation. + larger than the amount of virtual memory available. + The increment argument determines the file block size + and memory will be allocated in multiples of INCREMENT bytes. + A liberal increment results in fewer calls to + realloc() and probably less memory fragmentation.
        Parameters:
        hid_t plist @@ -1146,10 +1341,10 @@ many different parameters to be easily manipulated.
        Description:
        H5Pget_core checks to determine whether the file access property list is set to the core driver. - On success, the block size is returned - through the INCREMENT argument if it isn't the null pointer. + On success, the block size is returned through the + increment if it is not the null pointer. In the future, additional arguments may be added to this - function to match those added to H5Pset_core(). + function to match those added to H5Pset_core().
        Parameters:
        hid_t plist @@ -1181,7 +1376,7 @@ many different parameters to be easily manipulated. split meta data from raw data, storing meta data in one file and raw data in another file. The meta file will have a name which is formed by adding meta_extension (recommended - default value: .meta) to the end of the base name + default value: .meta) to the end of the base name and will be accessed according to the meta_properties. The raw file will have a name which is formed by appending raw_extension (recommended default value: @@ -1228,15 +1423,15 @@ many different parameters to be easily manipulated.
        H5Pget_split checks to determine whether the file access property list is set to the split driver. On successful return, - meta_properties and raw_properties will + meta_properties and raw_properties will point to copies of the meta and raw access property lists which should be closed by calling H5Pclose() when the application is finished with them, but if the meta and/or raw file has no property list then a negative value is returned for that property list identifier. Also, if - meta_extension and/or raw_extension are - non-null pointers, at most meta_ext_size or - raw_ext_size characters of the meta or raw file name + meta_extension and/or raw_extension are + non-null pointers, at most meta_ext_size or + raw_ext_size characters of the meta or raw file name extension will be copied to the specified buffer. If the actual name is longer than what was requested then the result will not be null terminated (similar to @@ -1281,6 +1476,7 @@ many different parameters to be easily manipulated.
        Sets the file access properties list to the family driver.
        Description: +
        Original version. Edited version below.
        H5Pset_family sets the file access properties to use the family driver; any previously defined driver properties are erased @@ -1315,6 +1511,60 @@ many different parameters to be easily manipulated.
        +
        Name: H5Pset_family +
        Signature: +
        herr_t H5Pset_family(hid_t plist, + hsize_t memb_size, + hid_t memb_plist + ) +
        Purpose: +
        Sets the file access properties list to the family + driver. +
        Description: +
        Edited version. Original version above. +
        H5Pset_family sets the file access properties + to use the family driver; any previously defined + driver properties are erased from the property list. + See File Families + in the HDF5 User's Guide for a discussion + of file families. +

        + Each member of the file family will use memb_plist + as its file access property list. +

        + The memb_size argument gives the logical size + in bytes of each family member; the actual size could be + smaller depending on whether the file contains holes. + The member size is only used when creating a new file or + truncating an existing file; otherwise the member size comes + from the size of the first member of the family being + opened. +

        + Note: If the size of the off_t type is + four bytes, then the maximum family member size is usually + 2^31-1 because the byte at offset 2,147,483,647 is generally + inaccessable. +

        + Additional parameters may be added to this function in the + future. +

        Parameters: +
        +
        hid_t plist +
        IN: Identifier of the file access property list. +
        hsize_t memb_size +
        IN: Logical size, in bytes, of each family member. +
        hid_t memb_plist +
        IN: Identifier of the file access property list + for each member of the family. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        Name: H5Pget_family
        Signature:
        herr_t H5Pget_family(hid_t tid, @@ -1365,8 +1615,9 @@ many different parameters to be easily manipulated.
        Sets the number of elements in the meta data cache and the total number of bytes in the raw data chunk cache.
        Description: -
        H5Pset_cache sets the number of elements (objects) in the meta data cache and the - total number of bytes in the raw data chunk cache. +
        H5Pset_cache sets the number of elements (objects) + in the meta data cache and the total number of bytes in the + raw data chunk cache.

        Sets or queries the meta data cache and raw data chunk cache parameters. The plist is a file access property @@ -1458,8 +1709,8 @@ many different parameters to be easily manipulated. hyperslab of a simple data space the buffer must be large enough to hold a 1x200x300 slab.

        - If TCONV and/or BKG are null pointers then buffers will be - allocated and freed during the data transfer. + If tconv and/or bkg are null pointers, + then buffers will be allocated and freed during the data transfer.

        The default value for the maximum buffer is 1 Mb.

        Parameters: @@ -1562,6 +1813,8 @@ many different parameters to be easily manipulated.
        + + + + +
        @@ -1658,12 +1919,11 @@ many different parameters to be easily manipulated.
        Sets compression method and compression level.
        Description:
        H5Pset_deflate sets the compression method for a - dataset creation property - list to H5D_COMPRESS_DEFLATE and the compression level to - LEVEL which should be a value between zero and nine, - inclusive. Lower compression levels are faster but result in - less compression. This is the same algorithm as used by the - GNU gzip program. + dataset creation property list to H5D_COMPRESS_DEFLATE + and the compression level to level<>/code>, which should + be a value from zero to nine, inclusive. + Lower compression levels are faster but result in less compression. + This is the same algorithm as used by the GNU gzip program.
        Parameters:
        hid_t plist @@ -1677,6 +1937,8 @@ many different parameters to be easily manipulated.
        + +
        @@ -1713,15 +1977,20 @@ H5P   H5S   H5T   H5Z   +Tools   +
        +
        HDF Help Desk
        -Last modified: 14 July 1998 +Last modified: 25 August 1998 + diff --git a/doc/src/RM_H5R.html b/doc/src/RM_H5R.html new file mode 100644 index 0000000..4e1fd7c --- /dev/null +++ b/doc/src/RM_H5R.html @@ -0,0 +1,248 @@ + + +HDF5/H5R Draft API Specification + + + + +
        +
        +HDF5 Reference Manual  +H5   +H5A   +H5D   +H5E   +H5F   +H5G   +H5P   +H5R   +H5S   +H5T   +H5Z   +Tools   + +
        +
        + +
        +

        H5R: Ragged Array Interface

        +
        + +

        Ragged Array API Functions

        + + +
        + +The H5R Interface is strictly experimental at this time; +the interface may change dramatically or support for ragged arrays +may be unavailable in future in releases. As a result, future releases +may be unable to retrieve data stored with this interface. +

        Use these functions at your own risk!
        +Do not create any archives using this interface!
        +         +
        +

        +These functions enable the user to store and retrieve data in ragged arrays. + + + + +
        + +       + +
        + +

        + + + +

        +
        +
        Name: H5Rcreate +
        Signature: +
        H5Rcreate( , + , + + ) +
        Purpose: +
        +
        Description: +
        H5Rcreate +
        Parameters: +
        +
        +
        +
        +
        +
        +
        +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Ropen +
        Signature: +
        H5Ropen( , + , + + ) +
        Purpose: +
        +
        Description: +
        H5Ropen +
        Parameters: +
        +
        +
        +
        +
        +
        +
        +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Rclose +
        Signature: +
        H5Rclose( , + , + + ) +
        Purpose: +
        +
        Description: +
        H5Rclose +
        Parameters: +
        +
        +
        +
        +
        +
        +
        +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Rwrite +
        Signature: +
        H5Rwrite( , + , + + ) +
        Purpose: +
        +
        Description: +
        H5Rwrite +

        + Datatype conversion takes place at the time of a read or write + and is automatic. See the + Data Conversion + section of The Data Type Interface (H5T) in the + HDF5 User's Guide for a discussion of + data conversion, including the range of conversions currently + supported by the HDF5 libraries. +

        Parameters: +
        +
        +
        +
        +
        +
        +
        +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Rread +
        Signature: +
        H5Rread( , + , + + ) +
        Purpose: +
        +
        Description: +
        H5Rread +

        + Datatype conversion takes place at the time of a read or write + and is automatic. See the + Data Conversion + section of The Data Type Interface (H5T) in the + HDF5 User's Guide for a discussion of + data conversion, including the range of conversions currently + supported by the HDF5 libraries. +

        Parameters: +
        +
        +
        +
        +
        +
        +
        +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +HDF5 Reference Manual  +H5   +H5A   +H5D   +H5E   +H5F   +H5G   +H5P   +H5R   +H5S   +H5T   +H5Z   +Tools   + +
        +
        + +
        +HDF Help Desk + +
        +Last modified: 1 September 1998 + + + diff --git a/doc/src/RM_H5S.html b/doc/src/RM_H5S.html index 8b2882c..64fd250 100644 --- a/doc/src/RM_H5S.html +++ b/doc/src/RM_H5S.html @@ -18,7 +18,10 @@ HDF5/H5S Draft API Specification H5S   H5T   H5Z   +Tools   +
        @@ -36,27 +39,62 @@ elements of a dataset.               +

        +The following H5S functions are included in the HDF5 specification, +but have not yet been implemented. They are described in the +The Data Type Interface (H5T) section +of the HDF5 User's Guide.. + + +
        +
          +
        • H5Scommit +
        • H5Sis_subspace +
        • H5Slock +
        • H5Sopen +
        +        		       +
          +
        • H5Sselect_name +
        • H5Sselect_op +
        • H5Sselect_order +
        +        		       +
          +
        • H5Ssubspace +
        • H5Ssubspace_name +
        • H5Ssubspace_location +
        +
        +

        @@ -196,18 +234,89 @@ elements of a dataset.
        +
        +
        +
        Name: H5Sselect_all +
        Signature: +
        herr_t H5Sselect_all(hid_t space_id) +
        Purpose: +
        Selects the entire dataspace. +
        Description: +
        H5Sselect_all selects the entire extent + of the dataspace space_id. +

        + More specifically, H5Sselect_all selects + the special 5S_SELECT_ALL region for the dataspace + space_id. H5S_SELECT_ALL selects the + entire dataspace for any dataspace it is applied to. +

        Parameters: +
        +
        hid_t space_id +
        IN: The identifier for the dataspace in which the + selection is being made. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Sselect_none +
        Signature: +
        herr_t H5Sselect_none(hid_t space_id) +
        Purpose: +
        Resets the selection region to include no elements. +
        Description: +
        H5Sselect_none resets the selection region + for the dataspace space_id to include no elements. +
        Parameters: +
        +
        hid_t space_id +
        IN: The identifier for the dataspace in which the + selection is being reset. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + +
        +
        +
        Name: H5Sselect_valid +
        Signature: +
        hbool_t H5Sselect_valid(hid_t space_id) +
        Purpose: +
        Verifies that the selection is within the extent of the dataspace. +
        Description: +
        H5Sselect_valid verifies that the selection + for the dataspace space_id is within the extent + of the dataspace if the current offset for the dataspace is used. +
        Parameters: +
        +
        hid_t space_id +
        The identifier for the dataspace in which the + selection is being reset. +
        +
        Returns: +
        Returns TRUE if the selection is contained within + the extent and FALSE if it is not. + Returns FAIL (-1) on error conditions + such as the selection or extent not being defined. +
        -
        Name: H5Sextent_npoints +
        Name: H5Sget_simple_extent_npoints
        Signature: -
        hsize_t H5Sextent_npoints(hid_t space_id) +
        hsize_t H5Sget_simple_extent_npoints(hid_t space_id)
        Purpose:
        Determines the number of elements in a dataspace.
        Description: -
        H5Sextent_npoints determines the number of elements +
        H5Sget_simple_extent_npoints determines the number of elements in a dataspace. For example, a simple 3-dimensional dataspace with dimensions 2, 3, and 4 would have 24 elements.
        Parameters: @@ -223,13 +332,13 @@ elements of a dataset.
        -
        Name: H5Sselect_npoints +
        Name: H5Sget_select_npoints
        Signature: -
        hsize_t H5Sselect_npoints(hid_t space_id) +
        hsize_t H5Sget_select_npoints(hid_t space_id)
        Purpose:
        Determines the number of elements in a dataspace.
        Description: -
        H5Sselect_npoints determines the number of elements +
        H5Sget_select_npoints determines the number of elements in the current selection of a dataspace.
        Parameters:
        @@ -237,20 +346,20 @@ elements of a dataset.
        Dataspace identifier.
        Returns: -
        Returns a dataspace identifier if successful; +
        Returns the number of elements in the selection if successful; otherwise FAIL (-1).
        -
        Name: H5Sextent_ndims +
        Name: H5Sget_simple_extent_ndims
        Signature: -
        int H5Sextent_ndims(hid_t space_id) +
        int H5Sget_simple_extent_ndims(hid_t space_id)
        Purpose:
        Determines the dimensionality of a dataspace.
        Description: -
        H5Sextent_ndims determines the dimensionality (or rank) +
        H5Sget_simple_extent_ndims determines the dimensionality (or rank) of a dataspace.
        Parameters:
        @@ -265,16 +374,16 @@ elements of a dataset.
        -
        Name: H5Sextent_dims +
        Name: H5Sget_simple_extent_dims
        Signature: -
        int H5Sextent_dims(hid_t space_id, +
        int H5Sget_simple_extent_dims(hid_t space_id, hsize_t *dims, hsize_t *maxdims )
        Purpose:
        Retrieves dataspace dimension size and maximum size.
        Description: -
        H5Sextent_dims returns the size and maximum sizes +
        H5Sget_simple_extent_dims returns the size and maximum sizes of each dimension of a dataspace through the dims and maxdims parameters.
        Parameters: @@ -294,9 +403,35 @@ elements of a dataset.
        +
        Name: H5Sget_space_type +
        Signature: +
        H5S_class_t H5Sget_space_type(hid_t space_id) +
        Purpose: +
        Determine the current class of a dataspace. +
        Description: +
        H5Sget_space_type queries a dataspace to determine the + current class of a dataspace. +

        + The function returns a class name, one of the following: + H5S_SCALAR, + H5S_SIMPLE, or + H5S_NONE. +

        Parameters: +
        +
        hid_t space_id +
        Dataspace identifier. +
        +
        Returns: +
        Returns a dataspace class name if successful; + otherwise FAIL (-1). +
        + + +
        +
        Name: H5Sset_extent_simple
        Signature: -
        herr_t H5S_set_extent_simple(hid_t space_id, +
        herr_t H5Sset_extent_simple(hid_t space_id, int rank, const hsize_t *current_size, const hsize_t *maximum_size @@ -304,7 +439,7 @@ elements of a dataset.
        Purpose:
        Sets or resets the size of an existing dataspace.
        Description: -
        H5S_set_extent_simple sets or resets the size of +
        H5Sset_extent_simple sets or resets the size of an existing dataspace.

        rank is the dimensionality, or number of @@ -360,6 +495,39 @@ elements of a dataset.

        +
        Name: H5Soffset_simple +
        Signature: +
        herr_t H5Soffset_simple(hid_t space_id, + const hssize_t *offset + ) +
        Purpose: +
        Sets the offset of a simple dataspace. +
        Description: +
        H5Soffset_simple sets the offset of a + simple dataspace space_id. The offset + array must be the same number of elements as the number of + dimensions for the dataspace. If the offset + array is set to NULL, the offset for the dataspace + is reset to 0. +

        + This function allows the same shaped selection to be moved + to different locations within a dataspace without requiring it + to be redefined. +

        Parameters: +
        +
        hid_t space_id +
        IN: The identifier for the dataspace object to reset. +
        const hssize_t *offset +
        IN: The offset at which to position the selection. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        Name: H5Sextent_class
        Signature:
        H5S_class_t H5Sextent_class(hid_t space_id) @@ -385,6 +553,56 @@ elements of a dataset.
        +
        Name: H5Sextent_copy +
        Signature: +
        herr_t H5Sextent_copy(hid_t dest_space_id, + hid_t source_space_id + ) +
        Purpose: +
        Copies the extent of a dataspace. +
        Description: +
        H5Sextent_copy copies the extent from + source_space_id to dest_space_id. + This action may change the type of the dataspace. +
        Parameters: +
        +
        hid_t dest_space_id +
        IN: The identifier for the dataspace from which + the extent is copied. +
        hid_t source_space_id +
        IN: The identifier for the dataspace to which + the extent is copied. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        +
        Name: H5Sset_extent_none +
        Signature: +
        herr_t H5Sset_extent_none(hid_t space_id) +
        Purpose: +
        Removes the extent from a dataspace. +
        Description: +
        H5Sset_extent_none removes the extent from + a dataspace and sets the type to H5S_NONE. +
        Parameters: +
        +
        hid_t space_id +
        The identifier for the dataspace from which + the extent is to be removed. +
        +
        Returns: +
        Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
        + + +
        +
        Name: H5Sselect_hyperslab
        Signature:
        herr_t H5Sselect_hyperslab(hid_t space_id, @@ -514,7 +732,10 @@ I/O is performed. H5S   H5T   H5Z   +Tools   +
        @@ -522,7 +743,7 @@ H5S   HDF Help Desk
        -Last modified: 14 July 1998 +Last modified: 1 September 1998 diff --git a/doc/src/RM_H5T.html b/doc/src/RM_H5T.html index 0fa5926..7ed2d7c 100644 --- a/doc/src/RM_H5T.html +++ b/doc/src/RM_H5T.html @@ -18,7 +18,10 @@ HDF5/H5T Draft API Specification H5S   H5T   H5Z   +Tools   +
        @@ -121,7 +124,7 @@ A data point is an instance of a datatype,

        See The Datatype Interface (H5T) -in the HDF5 User's Guide for further information. +in the HDF5 User's Guide for further information, including a complete list of all supported datatypes.

        @@ -489,6 +492,14 @@ H5Tget_overflow ()
        Native single-precision float type, declare dataset array as 'float'
        H5T_NATIVE_DOUBLE
        Native double-precision float type, declare dataset array as 'double' +
        H5T_NATIVE_HSIZE +
        Native size_t type, declare dataset array as 'hsize_t' +
        H5T_NATIVE_HSSIZE +
        Native signed size_t type, declare dataset array as 'hssize_t' +
        H5T_NATIVE_HERR +
        Native error type, declare dataset array as 'herr_t' +
        H5T_NATIVE_HBOOL +
        Native boolean type, declare dataset array as 'hbool_t'
      -->
      Parameters: @@ -1741,7 +1752,10 @@ zero. H5S   H5T   H5Z   +Tools   +
      @@ -1749,7 +1763,7 @@ H5T   HDF Help Desk
      -Last modified: 14 July 1998 +Last modified: 2 September 1998 diff --git a/doc/src/RM_H5Z.html b/doc/src/RM_H5Z.html index dbaed4c..5cdc5c8 100644 --- a/doc/src/RM_H5Z.html +++ b/doc/src/RM_H5Z.html @@ -18,7 +18,10 @@ HDF5/H5Z Draft API Specification H5S   H5T   H5Z   +Tools   +
      @@ -109,7 +112,10 @@ See Compression in the H5S   H5T   H5Z   +Tools   +
      diff --git a/doc/src/Tools.html b/doc/src/Tools.html index cf89313..b19b57c 100644 --- a/doc/src/Tools.html +++ b/doc/src/Tools.html @@ -139,12 +139,12 @@ These tools enable the user to examine HDF5 files interactively.
      h5ls [options] file - [group] + [objects...]
      Purpose:
      Prints information about a file or dataset.
      Description: -
      h5ls prints selected information about a file - or dataset in the specified format. +
      h5ls prints selected information about file objects + in the specified format.
      Options and Parameters:
      -h   or   -?   or   --help @@ -160,19 +160,19 @@ These tools enable the user to examine HDF5 files interactively.
      file
      The file name may include a printf(3C) integer format such as %%05d to open a file family. -
      group -
      If a group name is not specified then the contents of - the root group, /, are displayed. - -
      -
      -
      -
      +
      objects +
      The names of zero or more objects about which information + should be displayed. If a group is mentioned then + information about each of its members is displayed. + If no object names are specified then information about + all of the objects in the root group is displayed.
      +
      @@ -200,7 +200,8 @@ These tools enable the user to examine HDF5 files interactively. m for megabytes, or k for kilobytes.

      File family names include an integer printf - format such as %%d. + format such as %d. +

      Options and Parameters:
      -v @@ -216,10 +217,12 @@ These tools enable the user to examine HDF5 files interactively.
      dest_file
      The name of the destination files
      +
      -- cgit v0.12