From 82fb21b613326522eb0a51f507fd836fb5879c9a Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Mon, 21 Dec 1998 17:52:56 -0500 Subject: [svn-r985] Checking in changes from "HDF5 Release 1.0" CVS branch that have not yet been checked into "HDF5 Development" branch. General ======= Various "copy edit" types of repairs. Revisions to document cross-linking. Added structural links tying all docs together (banners at top and bottom of documents, similar to Reference Manual banners of the Beta release). Set background color to white in all documents. NCSAfooterlogo.gif hdf2.jpg New image files to make the documents more self-contained (i.e., to prevent loading images from NCSA and HDF home servers). index.html Redesigned to isolate links external to the installation in a single location. Intro to HDF5 ============= H5.intro.html Fixed banner linking Intro to other docs. Set all URLs to be relative within the distribution; nothing points back to the HDF server. Updates to "Limits of the Current Release" and "Changes in the Current Release." HDF5 User's Guide ================= Changed several User Guide section titles such that all sections that are primarily about a particular interface are now titled in the format "The xxxxx Interface (H5x)". H5.user.html Commented out links to developer docs since they are marked in MANIFEST as not being for distribution in the release. Removed 2nd and 3rd indices from page. Changed "freeform" lists of sections (TOCs) to aligned tables. Datatypes.html Removed the sentence "I'm deferring definition until later since they're probably not as important as the other data types." from Section 3.3, "Properties of Date and Time Atomic Types." Added info regarding 'char' versus 'string' datatypes. Added as Section 3.7, "Character and String Datatype Issues." References.html Commented out substantial material (at end of document) from References planning document that is not appropriate for the User Guide but that is worth keeping around. Groups.html Final edits from elimination of "current working group." HDF5 Reference Manual ===================== Removed "Draft" from the __ lines. RM_H5Front.html Removed 2nd and 3rd indices from page. Changed "freeform" lists of sections (TOCs) to aligned tables. RM_H5F.html RM_H5P.html Add file mounting information. --- doc/html/Attributes.html | 130 ++++++++++++++++++++- doc/html/Caching.html | 126 +++++++++++++++++++- doc/html/Chunking.html | 124 +++++++++++++++++++- doc/html/Datasets.html | 124 +++++++++++++++++++- doc/html/Dataspaces.html | 126 +++++++++++++++++++- doc/html/Datatypes.html | 225 ++++++++++++++++++++++++++++++++++-- doc/html/Debugging.html | 125 +++++++++++++++++++- doc/html/Environment.html | 194 ++++++++++++++++++++++++++++++- doc/html/Errors.html | 124 +++++++++++++++++++- doc/html/Files.html | 125 +++++++++++++++++++- doc/html/Filters.html | 128 ++++++++++++++++++++- doc/html/Glossary.html | 2 +- doc/html/Groups.html | 132 ++++++++++++++++++++- doc/html/H5.intro.html | 273 ++++++++++++++++++++++++++------------------ doc/html/H5.user.html | 244 ++++++++++++++++++++++++++++++++------- doc/html/NCSAfooterlogo.gif | Bin 0 -> 1818 bytes doc/html/Properties.html | 128 ++++++++++++++++++++- doc/html/RM_H5.html | 49 ++++++-- doc/html/RM_H5A.html | 49 ++++++-- doc/html/RM_H5D.html | 49 ++++++-- doc/html/RM_H5E.html | 49 ++++++-- doc/html/RM_H5F.html | 123 ++++++++++++++++++-- doc/html/RM_H5Front.html | 123 +++++++++++++++----- doc/html/RM_H5G.html | 54 ++++++--- doc/html/RM_H5I.html | 54 ++++++--- doc/html/RM_H5P.html | 53 +++++++-- doc/html/RM_H5R.html | 50 ++++++-- doc/html/RM_H5RA.html | 49 ++++++-- doc/html/RM_H5S.html | 49 ++++++-- doc/html/RM_H5T.html | 49 ++++++-- doc/html/RM_H5Z.html | 49 ++++++-- doc/html/Ragged.html | 128 ++++++++++++++++++++- doc/html/References.html | 144 +++++++++++++++++++++-- doc/html/Tools.html | 49 ++++++-- doc/html/ddl.html | 126 +++++++++++++++++++- doc/html/hdf2.jpg | Bin 0 -> 3034 bytes doc/html/index.html | 119 ++++++++++--------- 37 files changed, 3289 insertions(+), 456 deletions(-) create mode 100644 doc/html/NCSAfooterlogo.gif create mode 100644 doc/html/hdf2.jpg diff --git a/doc/html/Attributes.html b/doc/html/Attributes.html index f78b23e..fd917ca 100644 --- a/doc/html/Attributes.html +++ b/doc/html/Attributes.html @@ -1,11 +1,73 @@ - + Attributes - -

Attributes

+ + + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+
+ + +

The Attribute Interface (H5A)

1. Introduction

@@ -171,12 +233,72 @@ This function returns non-negative for success or negative for failure. + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ +
HDF Help Desk
-Last modified: 3 September 1998 +Last modified: 30 October 1998 diff --git a/doc/html/Caching.html b/doc/html/Caching.html index 7ecfbe8..c35cc65 100644 --- a/doc/html/Caching.html +++ b/doc/html/Caching.html @@ -4,7 +4,69 @@ Data Caching - + + + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+
+ +

Meta Data Caching

The HDF5 library caches two types of data: meta data and raw @@ -72,6 +134,66 @@ the pointer arguments may be null pointers. + +

+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+ +

Dataset Chunking Issues

Table of Contents

@@ -182,6 +244,64 @@ added before the second alpha release. +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+

The Dataset Interface (H5D)

1. Introduction

@@ -829,6 +889,66 @@ H5Pset_external (plist, "scan3.data", 0, 16); + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+

The Dataspace Interface (H5S)

@@ -555,7 +616,66 @@ is returned. -
+ +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+ +

The Data Type Interface (H5T)

1. Introduction

@@ -358,9 +420,6 @@ 19971205162530; as an integer value in Unix time(2) format; or other variations. -

I'm deferring definition until later since they're probably not - as important as the other data types. -

3.4. Properties of Character String Atomic Types

Fixed-length character string types are used to store textual @@ -437,6 +496,88 @@ but the application is responsible for data conversion of these types. +

3.7 Character and String Datatype Issues

+ + The H5T_NATIVE_CHAR and H5T_NATIVE_UCHAR + data types are actually numeric data (1-byte integers). If the + application wishes to store character data, then an HDF5 + string data type should be derived from + H5T_C_S1 instead. + +

Motivation

+ + HDF5 defines at least three classes of data types: + integer data, floating point data, and character data. + However, the C language defines only integer and + floating point data types; character data in C is + overloaded on the 8- or 16-bit integer types and + character strings are overloaded on arrays of those + integer types which, by convention, are terminated with + a zero element. + + In C, the variable unsigned char s[256] is + either an array of numeric data, a single character string + with at most 255 characters, or an array of 256 characters, + depending entirely on usage. For uniformity with the + other H5T_NATIVE_ types, HDF5 uses the + numeric interpretation of H5T_NATIVE_CHAR + and H5T_NATIVE_UCHAR. + + +

Usage

+ + To store unsigned char s[256] data as an + array of integer values, use the HDF5 data type + H5T_NATIVE_UCHAR and a data space that + describes the 256-element array. Some other application + that reads the data will then be able to read, say, a + 256-element array of 2-byte integers and HDF5 will + perform the numeric translation. + + To store unsigned char s[256] data as a + character string, derive a fixed length string data type + from H5T_C_S1 by increasing its size to + 256 characters. Some other application that reads the + data will be able to read, say, a space padded string + of 16-bit characters and HDF5 will perform the character + and padding translations. + + 
+                hid_t s256 = H5Tcopy(H5T_C_S1);
+                             H5Tset_size(s256, 256);
+
+ + To store unsigned char s[256] data as + an array of 256 ASCII characters, use an + HDF5 data space to describe the array and derive a + one-character string type from H5T_C_S1. + Some other application will be able to read a subset + of the array as 16-bit characters and HDF5 will + perform the character translations. + The H5T_STR_NULLPAD is necessary because + if H5T_STR_NULLTERM were used + (the default) then the single character of storage + would be for the null terminator and no useful data + would actually be stored (unless the length were + incremented to more than one character). + + 
+                hid_t s1 = H5Tcopy(H5T_C_S1);
+                           H5Tset_strpad(s1, H5T_STR_NULLPAD);
+
+ +

Summary

+ + The C language uses the term char to + represent one-byte numeric data and does not make + character strings a first-class data type. + HDF5 makes a distinction between integer and + character data and maps the C signed char + (H5T_NATIVE_CHAR) and + unsigned char (H5T_NATIVE_UCHAR) + data types to the HDF5 integer type class. + +

4. Properties of Compound Types

A compound data type is similar to a struct in C @@ -1412,15 +1553,77 @@ H5Tregister(H5T_PERS_SOFT, "cus2be", conversion path whether that conversion path was actually used or not. - -

-
- HDF Help Desk -
+<<<<<<< Datatypes.html + + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + +
+
+HDF Help Desk +
Last modified: Wed Dec 16 13:04:58 EST 1998 - - + + + diff --git a/doc/html/Debugging.html b/doc/html/Debugging.html index 45b9a84..34ad4e7 100644 --- a/doc/html/Debugging.html +++ b/doc/html/Debugging.html @@ -4,7 +4,69 @@ Debugging HDF5 Applications - + + + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+
+ +

Debugging HDF5 Applications

Introduction

@@ -401,6 +463,65 @@ H5E.c:336: warning: trace info was not inserted modified. +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+ + +

HDF5 Library Environment Variables and Configuration Parameters

+ +

1. Environment Variables

+ +The HDF5 library uses UNIX environment variables to control +or adjust certain library features at runtime. The variables and +their defined effects are as follows: + + +
+
HDF5_DEBUG +
Defines a list of debugging switches documented in the + Debugging section of the + HDF5 User's Guide. + +
HDF5_NOCLEANUP +
When set to a non-empty value, the programs in the test + directory do not remove temporary HDF5 data files. + The default is for each test to remove the files before exit. + +
HDF5_MPI_OPT_TYPES +   (for parallel beta version only) +
When set to 1, PHDF5 will use the MPI optimized + code to perform parallel read/write accesses to datasets. + Currently, this optimization fails when accessing extendable + datasets. The default is not to use the optimized code. + +
HDF5_MPI_1_METAWRITE +   (for parallel beta version only) +
When set to 1, PHDF5 will write the metadata + via process 0 of each opened parallel HDF5 file. This should + improve I/O throughput. The default is not to use this + optimization. + +
+ + +

2. Configuration Parameters

+ +The HDF5 configuration script accepts a list of parameters to control +configuration features when creating the Makefiles for the library. +The command +
+     configure --help +
+will display the current list of parameters and their effects. + + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + +
+ +
+HDF Help Desk +
+======= HDF5 Library Environment Variables and Configuration Parameters @@ -89,14 +270,15 @@
will display the current list of parameters and their effects. -
-
- HDF Help Desk -
+
+
+HDF Help Desk +
+ +Last modified: 25 November 1998 - Last modified: 9 September 1998 - + diff --git a/doc/html/Errors.html b/doc/html/Errors.html index 37ef1b8..8085b40 100644 --- a/doc/html/Errors.html +++ b/doc/html/Errors.html @@ -4,7 +4,69 @@ The Error Handling Interface (H5E) - + + + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+
+ +

The Error Handling Interface (H5E)

1. Introduction

@@ -269,6 +331,64 @@ H5Ewalk_cb(int n, H5E_error_t *err_desc, void *client_data) + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+ +

The File Interface (H5F)

1. Introduction

@@ -529,6 +589,65 @@ +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+ + +

Filters in HDF5

Note: Transient pipelines described in this document have not been implemented. @@ -459,6 +521,66 @@ H5Z: filter statistics accumulated over life of library: + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + + + + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + + + + +
+ + +

The Group Interface (H5G)

1. Introduction

@@ -75,7 +137,7 @@ File ID /foo/bar The object bar in group foo - in the root group of the specified file. + in the root group. @@ -117,7 +179,7 @@ File ID . - The specified file. + The root group of the file. @@ -256,6 +318,66 @@ string is returned. + +
+
+ + + +
+ Introduction to HDF5 
+ HDF5 Reference Manual 
+ Other HDF5 documents and links 
+ +		 + And in this document, the + HDF5 User's Guide:     + Files   +
+ Datasets   + Data Types   + Dataspaces   + Groups   + References   +
+ Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
+ Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
+
+ + +
+
+ + + +
+Introduction to HDF5 
+HDF5 User Guide  + +		 +HDF5 Reference Manual 
+Other HDF5 documents and links  +
+
+
+ +

Introduction to HDF5 Release 1.0

 -

This is an introduction to the HDF5 data model and programming model. Being a Getting Started or QuickStart document, this Introduction to HDF5 is intended to provide enough information for you to develop a basic understanding of how HDF5 works and is meant to be used. Knowledge of the current version of HDF will make it easier to follow the text, but it is not required. More complete information of the sort you will need to actually use HDF5 is available in the HDF5 documentation at http://hdf.ncsa.uiuc.edu/HDF5/. Available documents include the following: +

This is an introduction to the HDF5 data model and programming model. Being a Getting Started or QuickStart document, this Introduction to HDF5 is intended to provide enough information for you to develop a basic understanding of how HDF5 works and is meant to be used. Knowledge of the current version of HDF will make it easier to follow the text, but it is not required. More complete information of the sort you will need to actually use HDF5 is available in the HDF5 documentation. Available documents include the following:

+
  • HDF5 User’s Guide. Where appropriate, this Introduction will refer to specific sections of the User’s Guide. +
  • HDF5 Reference Manual.

    Code examples are available in the source code tree when you install HDF5. @@ -143,25 +162,25 @@ The development of HDF5 is motivated by a number of limitations in the current H

  • A simpler, better-engineered library and API, with improved support for parallel i/o, threads, and other requirements imposed by modern systems and applications.

    Limitations of the Current Release

    -

    The beta release includes most of the basic functionality that is planned for the HDF5 library. However, the library does not implement all of the features detailed in the format and API specifications. Here is a listing of some of the limitations of the current release: +

    This release includes the basic functionality that was planned for the HDF5 library. However, the library does not implement all of the features detailed in the format and API specifications. Here is a listing of some of the limitations of the current release:

    • Data compression is supported, though only GZIP is implemented. GZIP, or GNU Zip, is a compression function from the GNU Project.
    • Some functions for manipulating dataspaces have not been implemented.
    • Some number types, including user-defined number types are not supported. -
    • Deletion (unlinking) and renaming objects is not yet implemented. -
    • The library is not currently thread aware although we have planned for that possibility and intend eventually to implement it.
    +     +
  • The library is not currently thread aware although we have planned for that possibility and intend eventually to implement it. +
  • The only reference supported in this release is an object reference. +

    Changes in the Current Release

    -

    A detailed listing of changes in HDF5 since the last release (HDF5 1.0 alpha 2.0) can be found in the file hdf5/RELEASE in the beta code installation. Important changes include: +

    A detailed listing of changes in HDF5 since the last release (HDF5 1.0 Beta) can be found in the file hdf5/RELEASE in the code installation. Important changes include:

      -
    • Improvements have been made in the Dataspace API. -
    • The library has been changed to accommodate raw data filters provided by application-defined modules. Filters implemented so far include a GZIP data compression module, a checksumming module, and a very simple encryption module. -
    • All integer and floating point formats of supported machines have been implemented, including the `long double' type where applicable. -
    • A string datatype has been added. -
    • All number type conversions have been implemented except conversions between integer and floating point. -
    • New performance-enhancing features have been implemented.
    +
  • An object reference has been implemented. +
  • Union selection (unions of hyperslabs) has been implemented. +
  • Fill values have been implemented. +

    (Return to TOC)

    @@ -172,7 +191,7 @@ The development of HDF5 is motivated by a number of limitations in the current H
  • HDF5 group: a grouping structure containing instances of zero or more groups or datasets, together with supporting metadata.
  • HDF5 dataset: a multidimensional array of data elements, together with supporting metadata. -

    Working with groups and group members is similar in many ways to working with directories and files in UNIX. As with UNIX directories and files, objects in an HDF5 file are often described by giving their full path names. +

    Working with groups and group members is similar in many ways to working with directories and files in UNIX. As with UNIX directories and files, objects in an HDF5 file are often described by giving their full (or absolute) path names.

    / signifies the root group.
    /foo signifies a member of the root group called foo.
    @@ -193,7 +212,7 @@ The development of HDF5 is motivated by a number of limitations in the current H

    Name. A dataset name is a sequence of alphanumeric ASCII characters.

    Datatype. HDF5 allows one to define many different kinds of datatypes. There are two categories of datatypes: atomic datatypes and compound datatypes. Atomic datatypes are those that are not decomposed at the datatype interface level, such as integers and floats. NATIVE datatypes are system-specific instances of atomic datatypes. Compound datatypes are made up of atomic datatypes. And named datatypes are either atomic or compound datatypes that are have been specifically designated to be shared across datasets.

    Atomic datatypes include integers and floating-point numbers. Each atomic type belongs to a particular class and has several properties: size, order, precision, and offset. In this introduction, we consider only a few of these properties. -

    Atomic datatypes include integer, float, date and time, string, bit field, and opaque. (Note: Only integer, float and string classes are available in the current implementation.) +

    Atomic classes include integer, float, date and time, string, bit field, and opaque. (Note: Only integer, float and string classes are available in the current implementation.)

    Properties of integer types include size, order (endian-ness), and signed-ness (signed/unsigned).

    Properties of float types include the size and location of the exponent and mantissa, and the location of the sign bit.

    The datatypes that are supported in the current implementation are: @@ -201,6 +220,7 @@ The development of HDF5 is motivated by a number of limitations in the current H

    • Integer datatypes: 8-bit, 16-bit, 32-bit, and 64-bit integers in both little and big-endian format.
    • Floating-point numbers: IEEE 32-bit and 64-bit floating-point numbers in both little and big-endian format. +
    • References.
    • Strings.

    @@ -304,24 +324,25 @@ The development of HDF5 is motivated by a number of limitations in the current H -

    See Datatypes at http://hdf.ncsa.uiuc.edu/HDF5/Datatypes.html in the HDF User’s Guide for further information. +

    See Datatypes in the HDF User’s Guide for further information.

    A compound datatype is one in which a collection of simple datatypes are represented as a single unit, similar to a struct in C. The parts of a compound datatype are called members. The members of a compound datatype may be of any datatype, including another compound datatype. It is possible to read members from a compound type without reading the whole type.

    Named datatypes. Normally each dataset has its own datatype, but sometimes we may want to share a datatype among several datasets. This can be done using a named datatype. A named data type is stored in the file independently of any dataset, and referenced by all datasets that have that datatype. Named datatypes may have an associated attributes list. -See Datatypes at http://hdf.ncsa.uiuc.edu/HDF5/Datatypes.html in the HDF User’s Guide for further information. +See Datatypes in the HDF User’s Guide for further information.

    Dataspace. A dataset dataspace describes the dimensionality of the dataset. The dimensions of a dataset can be fixed (unchanging), or they may be unlimited, which means that they are extendible (i.e. they can grow larger).

    Properties of a dataspace consist of the rank (number of dimensions) of the data array, the actual sizes of the dimensions of the array, and the maximum sizes of the dimensions of the array. For a fixed-dimension dataset, the actual size is the same as the maximum size of a dimension. When a dimension is unlimited, the maximum size is set to the value H5P_UNLIMITED. (An example below shows how to create extendible datasets.) -

    A dataspace can also describe portions of a dataset, making it possible to do partial I/O operations on selections. Selection is supported by the dataspace interface (H5S). Given an n-dimensional dataset, there are currently three ways to do partial selection: +

    A dataspace can also describe portions of a dataset, making it possible to do partial I/O operations on selections. Selection is supported by the dataspace interface (H5S). Given an n-dimensional dataset, there are currently four ways to do partial selection:

    1. Select a logically contiguous n-dimensional hyperslab.
    2. Select a non-contiguous hyperslab consisting of elements or blocks of elements (hyperslabs) that are equally spaced. +
    3. Select a union of hyperslabs.
    4. Select a list of independent points.

    Since I/O operations have two end-points, the raw data transfer functions require two dataspace arguments: one describes the application memory dataspace or subset thereof, and the other describes the file dataspace or subset thereof. -

    See Dataspaces at http://hdf.ncsa.uiuc.edu/HDF5/Dataspaces.html in the HDF User’s Guide for further information. +

    See Dataspaces in the HDF User’s Guide for further information.

    Storage layout. The HDF5 format makes it possible to store data in a variety of ways. The default storage layout format is contiguous, meaning that data is stored in the same linear way that it is organized in memory. Two other storage layout formats are currently defined for HDF5: compact, and chunked. In the future, other storage layouts may be added.

    Compact storage is used when the amount of data is small and can be stored directly in the object header. (Note: Compact storage is not supported in this release.)

    Chunked storage involves dividing the dataset into equal-sized "chunks" that are stored separately. Chunking has three important benefits. @@ -331,12 +352,14 @@ See Datatypes at http://hdf.ncsa.uiuc.edu/HDF5/Datasets.html in the HDF User’s Guide for further information. +

    +See Datasets and Dataset Chunking Issues in the HDF User’s Guide for further information. +We particularly encourage you to read Dataset Chunking Issues since the issue is complex and beyond the scope of this document.

    HDF5 Attributes

    Attributes are small named datasets that are attached to primary datasets, groups, or named datatypes. Attributes can be used to describe the nature and/or the intended usage of a dataset or group. An attribute has two parts: (1) a name and (2) a value. The value part contains one or more data entries of the same data type.

    The Attribute API (H5A) is used to read or write attribute information. When accessing attributes, they can be identified by name or by an index value. The use of an index value makes it possible to iterate through all of the attributes associated with a given object.

    The HDF5 format and I/O library are designed with the assumption that attributes are small datasets. They are always stored in the object header of the object they are attached to. Because of this, large datasets should not be stored as attributes. How large is "large" is not defined by the library and is up to the user's interpretation. (Large datasets with metadata can be stored as supplemental datasets in a group with the primary dataset.) -

    See Attributes at http://hdf.ncsa.uiuc.edu/HDF5/Attributes.html in the HDF User’s Guide for further information. +

    See Attributes in the HDF User’s Guide for further information.

    (Return to TOC)

    @@ -363,7 +386,11 @@ Example: H5Aget_name, which retrieves name of an attribute.
  • H5Z: Compression registration routine.
    Example: H5Zregister, which registers new compression and uncompression functions for use with the HDF5 library.
  • H5E: Error handling routines.
    -Example: H5Eprint, which prints the current error stack. +Example: H5Eprint, which prints the current error stack. +
  • H5R: Reference routines.
    +Example: H5Rcreate, which creates a reference. +
  • H5I: Identifier routine.
    +Example: H5Iget_type, which retrieves the type of an object.

    Include Files

    There are a number definitions and declarations that should be included with any HDF5 program. These definitions and declarations are contained in several include files. The main include file is hdf5.h. This file includes all of the other files that your program is likely to need. Be sure to include hdf5.h in any program that uses the HDF5 library. @@ -418,26 +445,25 @@ status = H5Fclose(file); 

    hid_t    dataset, datatype, dataspace;   /* declare identifiers */
 
 /* 
-* 1. Create dataspace: Describe the size of the array and 
-* create the data space for fixed size dataset. 
-*/
+ * Create dataspace: Describe the size of the array and 
+ * create the data space for fixed size dataset. 
+ */
 dimsf[0] = NX;
 dimsf[1] = NY;
 dataspace = H5Screate_simple(RANK, dimsf, NULL); 
 /*
-/* 
-* 2. Define datatype for the data in the file.
-* We will store little endian integer numbers.
-*/
+ * Define datatype for the data in the file.
+ * We will store little endian integer numbers.
+ */
 datatype = H5Tcopy(H5T_NATIVE_INT);
 status = H5Tset_order(datatype, H5T_ORDER_LE);
 /*
-* 3. Create a new dataset within the file using defined 
-* dataspace and datatype and default dataset creation
-* properties.
-* NOTE: H5T_NATIVE_INT can be used as datatype if conversion
-* to little endian is not needed.
-*/
+ * Create a new dataset within the file using defined 
+ * dataspace and datatype and default dataset creation
+ * properties.
+ * NOTE: H5T_NATIVE_INT can be used as datatype if conversion
+ * to little endian is not needed.
+ */
 dataset = H5Dcreate(file, DATASETNAME, datatype, dataspace, H5P_DEFAULT);

    How to discard objects when they are no longer needed

    The datatype, dataspace and dataset objects should be released once they are no longer needed by a program. Since each is an independent object, the must be released (or closed) separately. The following lines of code close the datatype, dataspace, and datasets that were created in the preceding section. @@ -456,7 +482,7 @@ status = H5Dwrite(dataset, H5T_NATIVE_INT, H5S_ALL, H5S_ALL,

    Example 1 contains a program that creates a file and a dataset, and writes the dataset to the file.

    Reading is analogous to writing. If, in the previous example, we wish to read an entire dataset, we would use the same basic calls with the same parameters. Of course, the routine H5Dread would replace H5Dwrite.

    Getting information about a dataset

    -

    Although reading is analogous to writing, it is often necessary to query a file to obtain information about a dataset. For instance, we often need to know about the datatype associated with a dataset, as well dataspace information (e.g. rank and dimensions). There are several "get" routines for obtaining this information The following code segment illustrates how we would get this kind of information: +

    Although reading is analogous to writing, it is often necessary to query a file to obtain information about a dataset. For instance, we often need to know about the datatype associated with a dataset, as well dataspace information (e.g. rank and dimensions). There are several "get" routines for obtaining this information. The following code segment illustrates how we would get this kind of information: 

    /*
 * Get datatype and dataspace identifiers and then query
 * dataset class, order, size, rank and dimensions.
@@ -476,25 +502,27 @@ rank      = H5Sget_simple_extent_ndims(dataspace);
 status_n  = H5Sget_simple_extent_dims(dataspace, dims_out);
 printf("rank %d, dimensions %d x %d \n", rank, dims_out[0], dims_out[1]);

    Reading and writing a portion of a dataset

    -

    In the previous discussion, we describe how to access an entire dataset with one write (or read) operation. HDF5 also supports access to portions (or selections) of a dataset in one read/write operation. Currently selections are limited to hyperslabs and the lists of independent points. Both types of selection will be discussed in the following sections. Several sample cases of selection reading/writing are shown on the following figure. +

    In the previous discussion, we describe how to access an entire dataset with one write (or read) operation. HDF5 also supports access to portions (or selections) of a dataset in one read/write operation. Currently selections are limited to hyperslabs, their unions, and the lists of independent points. Both types of selection will be discussed in the following sections. Several sample cases of selection reading/writing are shown on the following figure.

    - +a 
    - +b 
    - +c 
    - +d 

    In example (a) a single hyperslab is read from the midst of a two-dimensional array in a file and stored in the corner of a smaller two-dimensional array in memory. In (b) a regular series of blocks is read from a two-dimensional array in the file and stored as a contiguous sequence of values at a certain offset in a one-dimensional array in memory. In (c) a sequence of points with no regular pattern is read from a two-dimensional array in a file and stored as a sequence of points with no regular pattern in a three-dimensional array in memory. +In (d) a union of hyperslabs in the file dataspace is read and +the data is stored in another union of hyperslabs in the memory dataspace.

    As these examples illustrate, whenever we perform partial read/write operations on the data, the following information must be provided: file dataspace, file dataspace selection, memory dataspace and memory dataspace selection. After the required information is specified, actual read/write operation on the portion of data is done in a single call to the HDF5 read/write functions H5Dread(write).

    Selecting hyperslabs

    Hyperslabs are portions of datasets. A hyperslab selection can be a logically contiguous collection of points in a dataspace, or it can be regular pattern of points or blocks in a dataspace. The following picture illustrates a selection of regularly spaced 3x2 blocks in an 8x12 dataspace. @@ -683,7 +711,8 @@ offset[0] = 1; offset[1] = 2; count[0] = 3; count[1] = 4; -status = H5Sselect_hyperslab(dataspace, H5S_SELECT_SET, offset, NULL, count, NULL); +status = H5Sselect_hyperslab(dataspace, H5S_SELECT_SET, offset, NULL, + count, NULL);

    This describes the dataspace from which we wish to read. We need to define the dataspace in memory analogously. Suppose, for instance, that we have in memory a 3 dimensional 7x7x3 array into which we wish to read the 3x4 hyperslab described above beginning at the element <3,0,0>. Since the in-memory dataspace has three dimensions, we have to describe the hyperslab as an array with three dimensions, with the last dimension being 1: <3,4,1>.

    Notice that we must describe two things: the dimensions of the in-memory array, and the size and position of the hyperslab that we wish to read in. The following code illustrates how this would be done. 

    /*
@@ -703,7 +732,8 @@ offset_out[2] = 0;
 count_out[0]  = 3;
 count_out[1]  = 4;
 count_out[2]  = 1;
-status = H5Sselect_hyperslab(memspace, H5S_SELECT_SET, offset_out, NULL, count_out, NULL);
+status = H5Sselect_hyperslab(memspace, H5S_SELECT_SET, offset_out, NULL, 
+         count_out, NULL);
 
 /*

    Example 2 contains a complete program that performs these operations. @@ -1669,14 +1699,14 @@ and create the union with the first hyperslab. Note that when we add the selected hyperslab to the union, the second argument to the H5Sselect_hyperslab function has to be H5S_SELECT_OR instead of H5S_SELECT_SET. -Using H5S_SELECT_SET would be reset the selection to +Using H5S_SELECT_SET would reset the selection to the second hyperslab.

    Now define the memory dataspace and select the union of the hyperslabs in the memory dataset. 

    - /*
+    /*
      * Create memory dataspace.
      */
     mid = H5Screate_simple(MSPACE_RANK, mdim, NULL);
@@ -1700,8 +1730,7 @@ in the memory dataset.
 Finally we can read the selected data from the file dataspace to the selection
 in memory with one call to the H5Dread function.
 
-
    -    ret = H5Dread(dataset, H5T_NATIVE_INT, mid, fid, H5P_DEFAULT, matrix_out);
+
        ret = H5Dread(dataset, H5T_NATIVE_INT, mid, fid, H5P_DEFAULT, matrix_out);
 
    
 
 
    
@@ -1770,7 +1799,7 @@ H5Tinsert (complex_id, "imaginary", HOFFSET(tmp,im),
      2 2 2 3 3
      2 2 2 3 3
      2 2 2 3 3
    
-
    The current version of HDF 5 requires you to use chunking in order to define extendible datasets. Chunking makes it possible to extend datasets efficiently, without having to reorganize storage excessively. 
+
    HDF 5 requires you to use chunking in order to define extendible datasets. Chunking makes it possible to extend datasets efficiently, without having to reorganize storage excessively. 
 
    The following operations are required in order to write an extendible dataset:
 
      
 
@@ -1784,15 +1813,15 @@ H5Tinsert (complex_id, "imaginary", HOFFSET(tmp,im),
 at the creation time */ 
 hsize_t maxdims[2] = {H5S_UNLIMITED, H5S_UNLIMITED};
 /*
- * 1. Create the data space with unlimited dimensions. 
+ * Create the data space with unlimited dimensions. 
  */
 dataspace = H5Screate_simple(RANK, dims, maxdims);

    Enabling chunking. We can then set the dataset storage layout properties to enable chunking. We do this using the routine H5Pset_chunk: 

    hid_t cparms; 
 hsize_t chunk_dims[2] ={2, 5};
 /* 
-* 2. Modify dataset creation properties to enable chunking.
-*/
+ * Modify dataset creation properties to enable chunking.
+ */
 cparms = H5Pcreate (H5P_DATASET_CREATE);
 status = H5Pset_chunk( cparms, RANK, chunk_dims);
    @@ -1809,8 +1838,8 @@ dataset = H5Dcreate(file, DATASETNAME, H5T_NATIVE_INT, dataspace,

    Extending dataset size. Finally, when we want to extend the size of the dataset, we invoke H5Dextend to extend the size of the dataset. In the following example, we extend the dataset along the first dimension, by seven rows, so that the new dimensions are <10,3>: 

    /*
-* Extend the dataset. Dataset becomes 10 x 3.
-*/
+ * Extend the dataset. Dataset becomes 10 x 3.
+ */
 dims[0] = dims[0] + 7;
 size[0] = dims[0]; 
 size[1] = dims[1]; 
@@ -1824,10 +1853,10 @@ status = H5Dextend (dataset, size);
    H5Gcreate. For example, the following code creates a group called Data in the root group. 
    -     /*
-      *  Create a group in the file.
-      */
-     grp = H5Gcreate(file, "/Data", 0);
+ /*
+  *  Create a group in the file.
+  */
+ grp = H5Gcreate(file, "/Data", 0);
    A group may be created in another group by providing the absolute name of the group to the H5Gcreate @@ -1836,18 +1865,18 @@ to create the group Data_new in the Data group, one can use the following sequence of calls: 
    -    /*
-     * Create group "Data_new" in the group "Data" by specifying
-     * absolute name of the group.
-     */
-   grp_new = H5Gcreate(file, "/Data/Data_new", 0);
+ /*
+  * Create group "Data_new" in the group "Data" by specifying
+  * absolute name of the group.
+  */
+ grp_new = H5Gcreate(file, "/Data/Data_new", 0);
    or 
    -    /*
-     * Create group "Data_new" in the "Data" group.
-     */
-   grp_new = H5Gcreate(grp, "Data_new", 0);
+ /*
+  * Create group "Data_new" in the "Data" group.
+  */
+ grp_new = H5Gcreate(grp, "Data_new", 0);
    Note that the group identifier grp is used as the first parameter in the H5Gcreate function @@ -1868,23 +1897,23 @@ group by specifying its absolute name as illustrated in the following example: 
     
-    /*
-     * Create the dataset "Compressed_Data" in the group using the 
-     * absolute name. The dataset creation property list is modified 
-     * to use GZIP compression with the compression effort set to 6.
-     * Note that compression can be used only when the dataset is 
-     * chunked.
-     */
-    dims[0] = 1000;
-    dims[1] = 20;
-    cdims[0] = 20;
-    cdims[1] = 20;
-    dataspace = H5Screate_simple(RANK, dims, NULL);
-    plist     = H5Pcreate(H5P_DATASET_CREATE);
-                H5Pset_chunk(plist, 2, cdims);
-                H5Pset_deflate( plist, 6);
-    dataset = H5Dcreate(file, "/Data/Compressed_Data", H5T_NATIVE_INT,
-                        dataspace, plist);
+ /*
+  * Create the dataset "Compressed_Data" in the group using the 
+  * absolute name. The dataset creation property list is modified 
+  * to use GZIP compression with the compression effort set to 6.
+  * Note that compression can be used only when the dataset is 
+  * chunked.
+  */
+ dims[0] = 1000;
+ dims[1] = 20;
+ cdims[0] = 20;
+ cdims[1] = 20;
+ dataspace = H5Screate_simple(RANK, dims, NULL);
+ plist     = H5Pcreate(H5P_DATASET_CREATE);
+             H5Pset_chunk(plist, 2, cdims);
+             H5Pset_deflate( plist, 6);
+ dataset = H5Dcreate(file, "/Data/Compressed_Data", H5T_NATIVE_INT,
+                     dataspace, plist);
    A relative dataset name may also be used when a dataset is created. First obtain the identifier of the group in which @@ -1892,18 +1921,18 @@ the dataset is to be created. Then create the dataset with H5Dcreate as illustrated in the following example: 
    -    /* 
-     * Open the group.
-     */
-    grp = H5Gopen(file, "Data");
+ /* 
+  * Open the group.
+  */
+ grp = H5Gopen(file, "Data");
 
-    /*
-     * Create the dataset "Compressed_Data" in the "Data" group
-     * by providing a group identifier and a relative dataset 
-     * name as parameters to the H5Dcreate function.
-     */
-    dataset = H5Dcreate(grp, "Compressed_Data", H5T_NATIVE_INT,
-                        dataspace, plist);
+ /*
+  * Create the dataset "Compressed_Data" in the "Data" group
+  * by providing a group identifier and a relative dataset 
+  * name as parameters to the H5Dcreate function.
+  */
+ dataset = H5Dcreate(grp, "Compressed_Data", H5T_NATIVE_INT,
+                     dataspace, plist);

    @@ -1914,24 +1943,24 @@ the absolute name to access the dataset Compressed_Data in the group Data created in the examples above: 

    -     /*
-      * Open the dataset "Compressed_Data" in the "Data" group. 
-      */
-     dataset = H5Dopen(file, "/Data/Compressed_Data");
+  /*
+   * Open the dataset "Compressed_Data" in the "Data" group. 
+   */
+  dataset = H5Dopen(file, "/Data/Compressed_Data");
    The same dataset can be accessed in another manner. First access the group to which the dataset belongs, then open the dataset. 
    -     /*
-      * Open the group "data" in the file.
-      */
-     grp  = H5Gopen(file, "Data");
+  /*
+   * Open the group "data" in the file.
+   */
+  grp  = H5Gopen(file, "Data");
  
-     /*
-      * Access the "Compressed_Data" dataset in the group.
-      */
-     dataset = H5Dopen(grp, "Compressed_Data");
+  /*
+   * Access the "Compressed_Data" dataset in the group.
+   */
+  dataset = H5Dopen(grp, "Compressed_Data");

    @@ -1939,7 +1968,8 @@ the dataset. how to create a group in a file and a dataset in a group. It uses the iterator function H5Giterate to find the names of the objects -in the root group. +in the root group, and H5Glink and H5Gunlink +to create a new group name and delete the original name.

    Working with attributes

    @@ -2994,13 +3024,16 @@ main (void) H5Fclose(file); return 0; -} +

    Example 7. Creating groups.

    -

    This example shows how to create an HDF5 file with two groups, and to place some datasets within those groups. +

    This example shows how to create and access a group in an +HDF5 file and to place a dataset within this group. +It also illustrates the usage of the H5Giterate, +H5Glink, and H5Gunlink functions. 

     
@@ -3434,13 +3467,33 @@ attr_info(hid_t loc_id, const char *name, void *opdata)
 
 
 
    (Return to TOC)
+
+
 
    
+
    
+
+
+
+
    
+Introduction to HDF5 
    
+HDF5 User Guide 
+
+    		
+HDF5 Reference Manual 
    
+Other HDF5 documents and links 
+
    
+
    
+
    
+
+
 
    
 
+
+
    
 
    
 HDF Help Desk
 
    
-Last modified:  28 October 1998
+Last modified:  30 October 1998
 
     		
 Copyright  
diff --git a/doc/html/H5.user.html b/doc/html/H5.user.html
index 23f28ee..e49e6a4 100644
--- a/doc/html/H5.user.html
+++ b/doc/html/H5.user.html
@@ -1,53 +1,155 @@
 
   
     
-      HDF5 Uer's Guide
+      HDF5 User's Guide
     
   
 
-  
-    
    A User Guide for HDF5
    
+  
+
+
+
    
+
    
+
+
+
+
    
+   Introduction to HDF5 
    
+   HDF5 Reference Manual 
    
+   Other HDF5 documents and links 
    
+   
+    		
+
+
+
+
    
+
    
+
    
+
+
+    
    A User's Guide for HDF5
    
 
     
    The following documents form a loosely organized user's guide
       to the HDF5 library.
 
-    
    		
+   And in this document, the 
+   HDF5 User's Guide:    
+      Files  
+      
    
+      Datasets  
+      Data Types  
+      Dataspaces  
+      Groups  
+      References  
+      
    
+      Attributes  
+      Property Lists  
+      Error Handling  
+      Filters  
+      Caching  
+      
    
+      Chunking  
+      Debugging  
+      Environment  
+      DDL  
+      Ragged Arrays  
+
+
    
+
+
    
+
+
+    
    The Property List Interface (H5P)
    
 
     
    1. Introduction
    
 
@@ -70,6 +132,66 @@
 	are defined above for H5Pcreate().
    • + +
    +
    + + + +
    + Introduction to HDF5 
    + HDF5 Reference Manual 
    + Other HDF5 documents and links 
    + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    +
    + + + + +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ H5   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5   H5T   H5Z   Tools   - + +
    +

    H5: General Library Functions

    @@ -198,7 +212,19 @@ and it users.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -206,6 +232,7 @@ H5   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -213,17 +240,17 @@ H5   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5A.html b/doc/html/RM_H5A.html index e53a6d4..24debde 100644 --- a/doc/html/RM_H5A.html +++ b/doc/html/RM_H5A.html @@ -1,13 +1,26 @@ -HDF5/H5A Draft API Specification +HDF5/H5A API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ H5A   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5A   H5T   H5Z   Tools   - +
    +

    H5A: Attribute Interface

    @@ -498,7 +512,19 @@ See Attributes in the
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -506,6 +532,7 @@ H5A   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -513,17 +540,17 @@ H5A   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5D.html b/doc/html/RM_H5D.html index 22b096c..849ec8d 100644 --- a/doc/html/RM_H5D.html +++ b/doc/html/RM_H5D.html @@ -1,13 +1,26 @@ -HDF5/H5D Draft API Specification +HDF5/H5D API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ H5D   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5D   H5T   H5Z   Tools   - +
    +

    H5D: Datasets Interface

    @@ -406,7 +420,19 @@ and set and retrieve their constant or persistent properties.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -414,6 +440,7 @@ H5D   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -421,17 +448,17 @@ H5D   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5E.html b/doc/html/RM_H5E.html index 8efe624..c0b1e66 100644 --- a/doc/html/RM_H5E.html +++ b/doc/html/RM_H5E.html @@ -1,13 +1,26 @@ -HDF5/H5E Draft API Specification +HDF5/H5E API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ H5E   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5E   H5T   H5Z   Tools   - +
    +

    H5E: Error Interface

    @@ -342,7 +356,19 @@ errors within the H5E package.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -350,6 +376,7 @@ H5E   H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -357,17 +384,17 @@ H5E   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5F.html b/doc/html/RM_H5F.html index 220a307..4325dd0 100644 --- a/doc/html/RM_H5F.html +++ b/doc/html/RM_H5F.html @@ -1,13 +1,26 @@ -HDF5/H5F Draft API Specification +HDF5/H5F API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5F Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5F   H5T   H5Z   Tools   - +
    +

    H5F: File Interface

    @@ -49,6 +63,8 @@ documented below.        @@ -326,6 +342,78 @@ documented below.
    +
    Name: H5Fmount +
    Signature: +
    herr_t H5Fmount(hid_t loc_id, + const char *name, + hid_t child_id, + hid_t plist_id + ) +
    Purpose: +
    Mounts a file. +
    Description: +
    H5Fmount mounts the file specified by + child_id onto the group specified by + loc_id and name using + the mount properties plist_id. +
    Parameters: +
    +
    hid_t loc_id +
    The identifier for the group onto which the + file specified by child_id + is to be mounted. +
    const char *name +
    The name of the group onto which the + file specified by child_id + is to be mounted. +
    hid_t child_id +
    The identifier of the file to be mounted. +
    hid_t plist_id +
    The identifier of the property list to be used. +
    +
    Returns: +
    Returns a non-negative value if successful; + otherwise returns a negative value. +
    + + +
    +
    +
    Name: H5Funmount +
    Signature: +
    herr_t H5Funmount(hid_t loc_id, + const char *name + ) +
    Purpose: +
    Unmounts a file. +
    Description: +
    Given a mount point, H5Funmount + dissassociates the mount point's file + from the file mounted there. This function + does not close either file. +

    + The mount point can either be the group in the + parent or the root group of the mounted file + (both groups have the same name). If the mount + point was opened before the mount then it is the + group in the parent; if it was opened after the + mount then it is the root group of the child. +

    Parameters: +
    +
    hid_t loc_id +
    The identifier for the location at which + the specified file is to be unmounted. +
    const char *name +
    The name of the file to be unmounted. +
    +
    Returns: +
    Returns a non-negative value if successful; + otherwise returns a negative value. +
    + + +
    +
    Name: H5Freopen
    Signature:
    hid__t H5Freopen(hid_t file_id @@ -353,7 +441,19 @@ documented below.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -361,6 +461,7 @@ documented below. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -368,17 +469,17 @@ H5F   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5Front.html b/doc/html/RM_H5Front.html index 8f23c56..7a09042 100644 --- a/doc/html/RM_H5Front.html +++ b/doc/html/RM_H5Front.html @@ -1,12 +1,26 @@ -HDF5 Draft API Specification +HDF5 API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 + +
    +

    HDF5: API Specification
    Reference Manual

    - -The HDF5 libraries provide several interfaces, each of which provides the +The HDF5 library provides several interfaces, each of which provides the tools required to meet specific aspects of the HDF5 data-handling requirements. -
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 + +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998     		Copyright   diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html index fce1706..1e899b9 100644 --- a/doc/html/RM_H5G.html +++ b/doc/html/RM_H5G.html @@ -1,13 +1,26 @@ -HDF5/H5G Draft API Specification +HDF5/H5G API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5G Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5G   H5T   H5Z   Tools   - +
    +

    H5G: Group Interface

    @@ -582,14 +596,21 @@ create or access function. - - - - -
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -597,6 +618,7 @@ create or access function. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -604,17 +626,17 @@ H5G   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5I.html b/doc/html/RM_H5I.html index 298eaea..841c859 100644 --- a/doc/html/RM_H5I.html +++ b/doc/html/RM_H5I.html @@ -1,13 +1,26 @@ -HDF5/H5I Draft API Specification +HDF5/H5I API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5I Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5I   H5T   H5Z   Tools   - +
    +

    H5I: Identifier Interface

    @@ -103,34 +117,46 @@ This function provides a tool for working with object identifiers.
    -
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   H5E   H5F   H5G   -H5I   +H5I   +
    H5P   -H5R   +H5R   H5RA   H5S   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html index 8dda42f..f327114 100644 --- a/doc/html/RM_H5P.html +++ b/doc/html/RM_H5P.html @@ -1,13 +1,26 @@ -HDF5/H5P Draft API Specification +HDF5/H5P API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5P Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5P   H5T   H5Z   Tools   - +
    +

    H5P: Property List Interface

    @@ -169,6 +183,11 @@ parallel HDF5 library. See Datasets in the HDF User's Guide for details about raw data transfer properties. +
    H5P_MOUNT +
    Properties for file mounting. + With this parameter, H5Pcreate + creates and returns a new mount property list + initialized with default values.
    Parameters:
    @@ -2059,7 +2078,19 @@ parallel HDF5 library.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -2067,6 +2098,7 @@ parallel HDF5 library. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -2074,9 +2106,8 @@ H5P   H5T   H5Z   Tools   - +
    @@ -2085,7 +2116,7 @@ H5P   HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5R.html b/doc/html/RM_H5R.html index 5af6fad..b558e81 100644 --- a/doc/html/RM_H5R.html +++ b/doc/html/RM_H5R.html @@ -1,13 +1,26 @@ -HDF5/H5R Draft API Specification +HDF5/H5R API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5R Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5R   H5T   H5Z   Tools   - +
    +

    H5R: Reference Interface

    @@ -180,9 +194,20 @@ is an object reference pointing to a dataset.
    -
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -190,6 +215,7 @@ is an object reference pointing to a dataset. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -197,17 +223,17 @@ H5R   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5RA.html b/doc/html/RM_H5RA.html index bb7bca4..90c51a8 100644 --- a/doc/html/RM_H5RA.html +++ b/doc/html/RM_H5RA.html @@ -1,13 +1,26 @@ -HDF5/H5RA Draft API Specification +HDF5/H5RA Experimental API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5RA Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5RA   H5T   H5Z   Tools   - +
    +

    H5RA: Ragged Array Interface

    @@ -308,7 +322,19 @@ name of the ragged array.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -316,6 +342,7 @@ name of the ragged array. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -323,17 +350,17 @@ H5RA   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5S.html b/doc/html/RM_H5S.html index 5d34684..5a7e33e 100644 --- a/doc/html/RM_H5S.html +++ b/doc/html/RM_H5S.html @@ -1,13 +1,26 @@ -HDF5/H5S Draft API Specification +HDF5/H5S API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5S Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ H5S   H5T   H5Z   Tools   - +
    +

    H5S: Dataspace Interface

    @@ -724,7 +738,19 @@ I/O is performed.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -732,6 +758,7 @@ I/O is performed. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -739,17 +766,17 @@ H5S   H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5T.html b/doc/html/RM_H5T.html index 672ec32..8752446 100644 --- a/doc/html/RM_H5T.html +++ b/doc/html/RM_H5T.html @@ -1,13 +1,26 @@ -HDF5/H5T Draft API Specification +HDF5/H5T API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5T Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ HDF5/H5T Draft API Specification H5T   H5Z   Tools   - +
    +

    H5T: Datatype Interface

    @@ -1744,7 +1758,19 @@ zero.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -1752,6 +1778,7 @@ zero. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -1759,17 +1786,17 @@ zero. H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/RM_H5Z.html b/doc/html/RM_H5Z.html index 337552e..a773a29 100644 --- a/doc/html/RM_H5Z.html +++ b/doc/html/RM_H5Z.html @@ -1,13 +1,26 @@ -HDF5/H5Z Draft API Specification +HDF5/H5Z API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/H5Z Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ HDF5/H5Z Draft API Specification H5T   H5Z   Tools   - +
    +

    H5Z: Compression Interface

    @@ -104,7 +118,19 @@ See Compression in the
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -112,6 +138,7 @@ See Compression in the H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -119,17 +146,17 @@ See Compression in the H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/Ragged.html b/doc/html/Ragged.html index fa3b61e..53d9f04 100644 --- a/doc/html/Ragged.html +++ b/doc/html/Ragged.html @@ -4,8 +4,70 @@ Ragged Arrays - -

    Ragged Arrays

    + + + +
    +
    + + + +
    + Introduction to HDF5 
    + HDF5 Reference Manual 
    + Other HDF5 documents and links 
    + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    +
    +
    + + +

    The Ragged Array Interface (H5RA)

    +
    @@ -140,6 +202,66 @@ Do not create any archives using this interface! the entire row. This function returns negative for failures with buf containing the original input values. + + +
    +
    + + + +
    + Introduction to HDF5 
    + HDF5 Reference Manual 
    + Other HDF5 documents and links 
    + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    +
    + + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    + +
    + + +

    The Reference Interface (H5R) and
    the Indentifier Interface (H5I)

    1. Introduction

    @@ -215,7 +277,7 @@ of its raw data and write the dataset to the file. } /* end for */ /* Write the data to the dataset using default transfer properties. */ - H5Dwrite(dataset, H5T_POINTER_OBJECT, H5S_ALL, H5S_ALL, H5P_DEFAULT, data); + H5Dwrite(dataset, H5T_STD_REF_OBJ, H5S_ALL, H5S_ALL, H5P_DEFAULT, data); /* Close everything */ H5Sclose(dataspace); @@ -398,13 +460,8 @@ read in those links. -
    -
    -HDF Help Desk -
    - -Last modified: 28 October 1998 + + +
    +
    + + + +
    + Introduction to HDF5 
    + HDF5 Reference Manual 
    + Other HDF5 documents and links 
    + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    +
    + + +
    +
    +HDF Help Desk +
    + +Last modified: 30 October 1998 + diff --git a/doc/html/Tools.html b/doc/html/Tools.html index d41f05e..b850862 100644 --- a/doc/html/Tools.html +++ b/doc/html/Tools.html @@ -1,13 +1,26 @@ -HDF5/Tools Draft API Specification +HDF5/Tools API Specification - + +
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -15,6 +28,7 @@ HDF5/Tools Draft API Specification H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -22,12 +36,12 @@ HDF5/Tools Draft API Specification H5T   H5Z   Tools   - +
    +

    HDF5 Tools

    @@ -259,7 +273,19 @@ These tools enable the user to examine HDF5 files interactively.
    -HDF5 Reference Manual  + + + +
    +Introduction to HDF5 
    +HDF5 User Guide 
    +Other HDF5 documents and links 
    + +    		 +And in this document, the +HDF5 Reference Manual   +
    H5   H5A   H5D   @@ -267,6 +293,7 @@ These tools enable the user to examine HDF5 files interactively. H5F   H5G   H5I   +
    H5P   H5R   H5RA   @@ -274,17 +301,17 @@ These tools enable the user to examine HDF5 files interactively. H5T   H5Z   Tools   - +
    +
    HDF Help Desk
    -Last modified: 27 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/ddl.html b/doc/html/ddl.html index fcce13e..8405c77 100644 --- a/doc/html/ddl.html +++ b/doc/html/ddl.html @@ -4,7 +4,69 @@ DDL for HDF5 - + + + +
    +
    + + + +
    + Introduction to HDF5 
    + HDF5 Reference Manual 
    + Other HDF5 documents and links 
    + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    +
    +
    + +

    DDL in BNF for HDF5

    @@ -197,12 +259,72 @@ GROUP "/" { + +
    +
    + + + +
    + Introduction to HDF5 
    + HDF5 Reference Manual 
    + Other HDF5 documents and links 
    + +    		 + And in this document, the + HDF5 User's Guide:     + Files   +
    + Datasets   + Data Types   + Dataspaces   + Groups   + References   +
    + Attributes   + Property Lists   + Error Handling   + Filters   + Caching   +
    + Chunking   + Debugging   + Environment   + DDL   + Ragged Arrays   + +
    +
    + +
    HDF Help Desk
    -Last modified: 28 October 1998 +Last modified: 30 October 1998 diff --git a/doc/html/hdf2.jpg b/doc/html/hdf2.jpg new file mode 100644 index 0000000..92b53c9 Binary files /dev/null and b/doc/html/hdf2.jpg differ diff --git a/doc/html/index.html b/doc/html/index.html index 45652ad..0ad8191 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -9,73 +9,90 @@ -NCSA

    + + +

    +
    +

    HDF Logo HDF5 - A New Generation of HDF
    The Hierarchical Data Format

    +
    -

    What is HDF? -HDF5 - A New Generation of HDF

    -
    +
    - - [ Home ] - [ Index ] - [ Products ] - [ Newsletters ] - [ Documentation ] - -
    -
    + + +
    +

    HDF Links at NCSA

    +
    +
    HDF Help Desk +
    Email to HDF Technical Support +

    +

    HDF Home Page + +

    +

    HDF Newsletters +
    News about HDF and HDF5 +

    +

    HDF5 FTP Archives +
    HDF5 source code archives +
    +    		 + +

    HDF5 Documentation

    + +
    +
    An Introduction to HDF5 +
    An introduction to HDF5 programming and an overview of + the design goals behind the HDF5 library and file format +
    HDF5 User's Guide +
    A collection of chapters on the main HDF5 APIs and + other supporting information +
    HDF5 Reference Manual +
    A complete reference manual for the HDF5 API +
    HDF5 Format Specification +
    The complete specification of the HDF5 file format +
    +
    + +
    +
    Parallel HDF5 Design +
    The design specification of the parallel HDF5 API and + an example program +
    Parallel HDF5 Implementation +
    The current status of implmentation of the parallel HDF5 API +
    +
    +
    (Internet links)
    +    		 + +
    (Local links)
    +
    + - -

    +

    - NCSA
    +     + NCSA Logo
    The National Center for Supercomputing Applications
    University of Illinois - at Urbana-Champaign
    -
    + at Urbana-Champaign - +

    HDF Help Desk Last modified: 16 Sept 1998 + + -- cgit v0.12