From cd3b1059977b1a80e320334c68630f88867341c8 Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Thu, 29 Oct 1998 17:13:17 -0500 Subject: [svn-r830] ====== Intro ====== H5.intro.html Major rewrite to Groups section. New Example 7 (groups). Added TOC and requisite links. Numbered sections. Labelled figures and centered those that were not. Fixed table formatting. =========== User Guide =========== H5.user.html Linked in Chunking.html. Linked in References.html. Linked in DDL.html. Chunking.html Minor edits. DDL.html References.html New documents. Datatypes.html Added "R Reference" to base name description and "H5T_STD_ROBJ -- Reference to an entire object in a file" to list of datatype names. Files.html H5Fflush Added scope parameter. Groups.html Removed references to "current working group." Removed H5Gpush, H5Gpop, and H5Gset functions. Removed note that H5Glink and H5Gunlink were not implemented. ================= Reference Manual ================= RM_*.html and Tools.html Updated Reference Manual internal cross-linking (the link banner at the top and bottom of each page). Changed Returns SUCCEED (0) if successful; otherwise FAIL (-1). to read Returns a non-negative value if successful; otherwise returns a negative value. and several derived changes where circumstances differred only slightly. Minor copy edits throughout. RM_H5.html Corrected H5open "Purpose" statement. RM_H5A.html Changed H5Aget_name return type to hssize_t. RM_H5F.html H5Fflush Added scope parameter. Added H5Freopen. RM_H5Front.html Reordered listing of interfaces to alphabetical order (H5, H5A, H5D, ...) Added H5I, H5R, and H5RA. RM_H5G.html H5Gopen Edited "Description." H5Gget_objinfo Added named datatype to list of valid values for loc_id. RM_H5I.html Identifier Interface New section. RM_H5P.html Added H5Pset_fill_value and H5Pget_fill_value. Several minor copy edits. RM_H5R.html Reference Interface New section. H5RA.html Essentially a new section. It was in the tree previously, but it did not actually have content. RM_H5S.html Changed H5Sget_select_npoints return type to hssize_t. Tools.html Updated h5dump documentation. --- doc/html/Chunking.html | 17 +- doc/html/Dataspaces.html | 6 +- doc/html/Datatypes.html | 12 +- doc/html/Files.html | 6 +- doc/html/Groups.html | 64 +----- doc/html/H5.intro.html | 572 ++++++++++++++++++++++++++++++++++------------- doc/html/H5.user.html | 8 +- doc/html/RM_H5.html | 28 ++- doc/html/RM_H5A.html | 42 ++-- doc/html/RM_H5D.html | 34 +-- doc/html/RM_H5E.html | 32 +-- doc/html/RM_H5F.html | 72 +++++- doc/html/RM_H5Front.html | 26 +-- doc/html/RM_H5G.html | 74 +++--- doc/html/RM_H5P.html | 302 ++++++++++++++++--------- doc/html/RM_H5RA.html | 225 +++++++++++++------ doc/html/RM_H5S.html | 60 ++--- doc/html/RM_H5T.html | 124 +++++----- doc/html/RM_H5Z.html | 12 +- doc/html/Ragged.html | 2 +- doc/html/Tools.html | 103 +++++---- 21 files changed, 1184 insertions(+), 637 deletions(-) diff --git a/doc/html/Chunking.html b/doc/html/Chunking.html index ccf4f9e..3267783 100644 --- a/doc/html/Chunking.html +++ b/doc/html/Chunking.html @@ -1,11 +1,11 @@ - Dataset Chunking Pitfalls + Dataset Chunking Issues -

Dataset Chunking Pitfalls

Dataset Chunking Issues

@@ -183,11 +183,24 @@ + + + +

+HDF Help Desk + +
+Last modified: 26 October 1998 + + diff --git a/doc/html/Dataspaces.html b/doc/html/Dataspaces.html index 3136dd2..1004d3b 100644 --- a/doc/html/Dataspaces.html +++ b/doc/html/Dataspaces.html @@ -565,9 +565,9 @@ is returned.
--> -Last + @@ -576,7 +576,7 @@ modified: Thu May 28 15:12:04 EST 1998 HDF Help Desk
-Last modified: 3 September 1998 +Last modified: 26 October 1998 diff --git a/doc/html/Datatypes.html b/doc/html/Datatypes.html index 248966c..473d4cb 100644 --- a/doc/html/Datatypes.html +++ b/doc/html/Datatypes.html @@ -531,7 +531,9 @@ H5Tinsert()) and cannot be subsequently modified. This makes it imposible to define recursive data structures. +

5. Predefined Atomic Data Types

The library predefines a modest number of data types having names like H5T_arch_base where @@ -641,6 +643,10 @@ Signed integer + R + References + + S Character string @@ -711,6 +717,10 @@ H5T_CRAY_F64 Eight-byte Cray floating point + + H5T_STD_ROBJ + Reference to an entire object in a file + @@ -1425,7 +1435,7 @@ Last modified: Tue Sep 8 14:43:32 EDT 1998 HDF Help Desk

-Last modified: 9 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/Files.html b/doc/html/Files.html index 07ecead..ecec10b 100644 --- a/doc/html/Files.html +++ b/doc/html/Files.html @@ -76,11 +76,13 @@ function returns zero for success or a negative value for failure.

-

herr_t H5Fflush (hid_t object_id) +

herr_t H5Fflush (hid_t object_id, 
+          H5F_scope_t scope)

This function will cause all buffers associated with a file to be immediately flushed to the file. The object_id can be any object which is associated with a file, including - the file itself. + the file itself. scope specifies whether the flushing + action is to be global or local.

4. File Property Lists

diff --git a/doc/html/Groups.html b/doc/html/Groups.html index a313f6c..d6999d9 100644 --- a/doc/html/Groups.html +++ b/doc/html/Groups.html @@ -51,7 +51,7 @@ name which begins with a slash is an absolute name which is looked up beginning at the root group of the file while all other relative names are looked up beginning at the - current working group (described below) or a specified group. + specified group. Multiple consecutive slashes in a full name are treated as single slashes and trailing slashes are not significant. A special case is the name "/" (or equivalent) which refers to the @@ -104,9 +104,7 @@ File ID foo/bar The object bar in group foo - in the current working group of the specified file. The - initial current working group is the root group of the - file as described below. + in the specified group. @@ -119,7 +117,7 @@ File ID . - The current working group of the specified file. + The specified file. @@ -181,51 +179,7 @@ returns zero for success or a negative value for failure. -

4. Current Working Group

- -

Each file handle (hid_t file_id) has a - current working group, initially the root group of the file. - Names which do not begin with a slash are relative to the - specified group or to the current working group as described - above. For instance, the name "/Foo/Bar/Baz" is resolved by - first looking up "Foo" in the root group. But the name - "Foo/Bar/Baz" is resolved by first looking up "Foo" in the - current working group. - -

herr_t H5Gset (hid_t location_id, const char - *name) -: The group with the specified name is made the current - working group for the file which contains it. The - location_id can be a file handle or a group handle - and the name is resolved as described above. Each file handle - has it's own current working group and if the - location_id is a group handle then the file handle is - derived from the group handle. This function returns zero for - success or negative for failure. - -

-
herr_t H5Gpush (hid_t location_id, const char - *name) -: Each file handle has a stack of groups and the top group on - that stack is the current working group. The stack initially - contains only the root group. This function pushes a new - group onto the stack and returns zero for success or negative - for failure. - -

-
herr_t H5Gpop (hid_t location_id) -: This function pops one group off the group stack for the - specified file (if the location_id is a group then - the file is derived from that group), changing the current - working group to the new top-of-stack group. The function - returns zero for success or negative for failure (failure - includes attempting to pop from an empty stack). If the last - item is popped from the stack then the current working group - is set to the root group. -

- -

5. Objects with Multiple Names

4. Objects with Multiple Names

An object (including a group) can have more than one name. Creating the object gives it the first name, and then @@ -263,8 +217,7 @@ H5T_LINK_SOFT a soft link is created which is an alias for the current_name. When creating a soft link the object need not exist. This function returns zero - for success or negative for failure. This function is not - part of the prototype API. + for success or negative for failure.

herr_t H5Gunlink (hid_t file_id, const char
@@ -274,11 +227,10 @@
 	to the object and when the hard link count reaches zero the
 	object can be removed from the file (but objects which are
 	open are not removed until all handles to the object are
-	closed).  This function is not part of the prototype
-	API.
+	closed).  
     
 
-    6. Comments
+    5. Comments
 
     Objects can have a comment associated with them.  The comment
       is set and queried with these two functions:
@@ -320,7 +272,7 @@ Last modified: Wed Jul 22 14:24:34 EDT 1998
 HDF Help Desk
 
 
-Last modified:  9 September 1998
+Last modified:  29 October 1998
 
   
 
diff --git a/doc/html/H5.intro.html b/doc/html/H5.intro.html
index d00552f..f13ad13 100644
--- a/doc/html/H5.intro.html
+++ b/doc/html/H5.intro.html
@@ -16,7 +16,8 @@
 -->
 
 
-
Introduction to HDF5 1.0 Beta
+
+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:
 
@@ -30,10 +31,104 @@
 
The directory hdf5/examples contains the examples used in this document.

The directory hdf5/test contains the development tests used by the HDF5 developers.  Since these codes are intended to fully exercise the system, they provide more diverse and sophisticated examples of what HDF5 can do.
 
-What is HDF5?
+
+
+
+
+
+
+Table of Contents

+    Introduction to HDF5 Release 1.0
+    1. What Is HDF5?

+        
+            Why HDF5?

+            Limitations of the 
+              Current Release

+            Changes in the 
+              Current Release

+        
+    2. HDF5 File Organization and Data Model

+        
+            HDF5 Groups

+            HDF5 Datasets

+            HDF5 Attributes

+        
+    3. The HDF5 API

+        
+            Naming 
+              Conventions

+            Include Files

+            Programming 
+              Models

+                    
+              Creating an HDF5 file

+                    
+              Discarding objects

+                    
+              Writing a dataset to a 
+              new file

+                    
+              Getting information about 
+              a dataset

+
+    
+
+    3. The HDF5 API (continued)

+        
+            Programming 
+              Models (continued)

+                    
+              Reading/writing a portion of 
+              a dataset

+                    
+              Selecting hyperslabs

+                    
+              Selecting of independent 
+              points

+                    
+              Creating compound 
+              datatypes

+                    
+              Creating/writing 
+              extendible datasets

+                    
+              Working with groups

+                    
+              Working with attributes

+        
+    4. Example Codes

+        
+                    
+              1: Creating and writing a
+              dataset

+                    
+              2. Reading a hyperslab

+                    
+              3. Writing selected data

+                    
+              4. Working with compound datatypes

+                    
+              5. Creating and writing an 
+              extendible dataset

+                    
+              6. Reading data

+                    
+              7. Creating groups

+                    
+              8. Writing and reading 
+              attributes

+        
+
+
+
+
+

+1. What Is HDF5?
 HDF5 is a new, experimental version of HDF that is designed to address some of the limitations of the current version of HDF (HDF4.x) and to address current and anticipated requirements of modern systems and applications. 
 
We urge you to look at this new version of HDF and give us feedback on what you like or do not like about it, and what features you would like to see added to it.
-
Why HDF5? The development of HDF5 is motivated by a number of limitations in the current HDF format, as well as limitations in the library. Some of these limitations are:
+
+
Why HDF5?
+The development of HDF5 is motivated by a number of limitations in the current HDF format, as well as limitations in the library. Some of these limitations are:
 
 
 A single file cannot store more than 20,000 complex objects, and a single file cannot be larger than 2 gigabytes.
@@ -47,7 +142,7 @@
 
A simpler, more comprehensive data model that includes only two basic structures: a multidimensional array of record structures, and a grouping structure. 
 
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
+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: 
 
 
@@ -57,7 +152,7 @@
 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.
 
-Changes in the current release
+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:
 
 

@@ -68,7 +163,9 @@
 All number type conversions have been  implemented except conversions between integer and floating point.
 
New performance-enhancing features have been implemented.
 
-HDF5 file organization and data model
+(Return to TOC)
+

+2. HDF5 File Organization and Data Model
 HDF5 files are organized in a hierarchical structure, with two primary structures: groups and datasets.
 
 
@@ -82,14 +179,14 @@
 /foo/zoo signifies a member of the group foo, which in turn is a member of the root group.
 
 Any HDF5 group or dataset may have an associated attribute list. An HDF5 attribute is a user-defined HDF5 structure that provides extra information about an HDF5 object. Attributes are described in more detail below. 
-
HDF5 Groups
+HDF5 Groups
 An HDF5 group is a structure containing zero or more HDF5 objects. A group has two parts:
 
 
 A group header, which contains a group name and a list of group attributes. 
 
A group symbol table, which is a list of the HDF5 objects that belong to the group.
 
-HDF5 Datasets
+HDF5 Datasets
 A dataset is stored in a file in two parts: a header and a data array. 
 
The header contains information that is needed to interpret the array portion of the dataset, as well as metadata (or pointers to metadata) that describes or annotates the dataset. Header information includes the name of the object, its dimensionality, its number-type, information about how the data itself is stored on disk, and other information used by the library to speed up access to the dataset or maintain the file's integrity.
 
There are four essential classes of information in any header: name, datatype, dataspace, and storage layout:
@@ -108,97 +205,101 @@
 
 

 NATIVE datatypes.  Although it is possible to describe nearly any kind of atomic data type, most applications will use predefined datatypes that are supported by their compiler.  In HDF5 these are called native datatypes. NATIVE datatypes are C-like datatypes that are generally supported by the hardware of the machine on which the library was compiled. In order to be portable, applications should almost always use the NATIVE designation to describe data values in memory.
-
The NATIVE architecture has base names which do not follow the same rules as the others.  Instead, native type names are similar to the C type names.  Here are some examples:
-

+The NATIVE architecture has base names which do not follow the same rules as the others.  Instead, native type names are similar to the C type names.  The following figure shows several examples.
+

+
+

+Examples of Native Data Types and Corresponding C Types

+
+H5T_NATIVE_CHAR
+signed char
+H5T_NATIVE_UCHAR
+unsigned char
+H5T_NATIVE_SHORT
+short
+H5T_NATIVE_USHORT
+unsigned short
+H5T_NATIVE_INT
+int
+H5T_NATIVE_UINT
+unsigned
+H5T_NATIVE_LONG
+long
+H5T_NATIVE_ULONG
+unsigned long
+H5T_NATIVE_LLONG
+long long
+H5T_NATIVE_ULLONG
+unsigned long long
+H5T_NATIVE_FLOAT
+float
+H5T_NATIVE_DOUBLE
+double
+H5T_NATIVE_LDOUBLE
+long double
+H5T_NATIVE_HSIZE
+hsize_t
+H5T_NATIVE_HSSIZE
+hssize_t
+H5T_NATIVE_HERR
+herr_t
+H5T_NATIVE_HBOOL
+hbool_t
 
 Example
 
 Corresponding C Type
 
 
-H5T_NATIVE_CHAR
 
-signed char
 
 
-H5T_NATIVE_UCHAR
 
-unsigned char
 
 
-H5T_NATIVE_SHORT
 
-short
 
 
-H5T_NATIVE_USHORT
 
-unsigned short
 
 
-H5T_NATIVE_INT
 
-int
 
 
-H5T_NATIVE_UINT
 
-unsigned
 
 
-H5T_NATIVE_LONG
 
-long
 
 
-H5T_NATIVE_ULONG
 
-unsigned long
 
 
-H5T_NATIVE_LLONG
 
-long long
 
 
-H5T_NATIVE_ULLONG
 
-unsigned long long
 
 
-H5T_NATIVE_FLOAT
 
-float
 
 
-H5T_NATIVE_DOUBLE
 
-double
 
 
-H5T_NATIVE_LDOUBLE
 
-long double
 
 
-H5T_NATIVE_HSIZE
 
-hsize_t
 
 
-H5T_NATIVE_HSSIZE
 
-hssize_t
 
 
-H5T_NATIVE_HERR
 
-herr_t
 
 
-H5T_NATIVE_HBOOL
 
-hbool_t
 
 
 
@@ -231,14 +332,17 @@ See Datatypes at http://hdf.ncsa.uiuc.edu/HDF5/Datasets.html in the HDF User’s Guide for further information.
-HDF5 Attributes
+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.
-
The HDF5 Applications Programming Interface (API)
+
+(Return to TOC)
+

+3. The HDF5 Applications Programming Interface (API)
 The current HDF5 API is implemented only in C. The API provides routines for creating HDF5 files, creating and writing groups, datasets, and their attributes to HDF5 files, and reading groups, datasets and their attributes from HDF5 files.
-
Naming conventions
+Naming conventions
 All C routines in the HDF 5 library begin with a prefix of the form H5*, where * is a single letter indicating the object on which the operation is to be performed:
 
 

@@ -261,11 +365,11 @@ Example: H5Zregister, which registers new compression and uncompres
 H5E: Error handling routines. 

 Example: H5Eprint, which prints the current error stack.
 
-Include files 
+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.
 
 
-
Programming models
+Programming Models
 In this section we describe how to program some basic operations on files, including how to
 
 

@@ -281,7 +385,7 @@ Example: H5Eprint, which prints the current error stack.
 Work with attributes. 

 
 
-How to create an HDF5 file
+How to create an HDF5 file
 This programming model shows how to create a file and also how to close the file.

Table of Contents
+ Introduction to HDF5 Release 1.0 + 1. What Is HDF5? + + Why HDF5? + Limitations of the + Current Release + Changes in the + Current Release + + 2. HDF5 File Organization and Data Model + + HDF5 Groups + HDF5 Datasets + HDF5 Attributes + + 3. The HDF5 API + + Naming + Conventions + Include Files + Programming + Models + + Creating an HDF5 file + + Discarding objects + + Writing a dataset to a + new file + + Getting information about + a dataset + +		+ + 3. The HDF5 API (continued) + + Programming + Models (continued) + + Reading/writing a portion of + a dataset + + Selecting hyperslabs + + Selecting of independent + points + + Creating compound + datatypes + + Creating/writing + extendible datasets + + Working with groups + + Working with attributes + + 4. Example Codes + + + 1: Creating and writing a + dataset + + 2. Reading a hyperslab + + 3. Writing selected data + + 4. Working with compound datatypes + + 5. Creating and writing an + extendible dataset + + 6. Reading data + + 7. Creating groups + + 8. Writing and reading + attributes + +


 
@@ -303,7 +407,7 @@ status = H5Fclose(file);

How to create and initialize the essential components of a dataset for writing to a file

Recall that datatypes and dimensionality (dataspace) are independent objects, which are created separately from any dataset that they might be attached to. Because of this the creation of a dataset requires, at a minimum, separate definitions of datatype, dimensionality, and dataset. Hence, to create a dataset the following steps need to be taken:

Create and initialize a dataspace for the dataset to be written. @@ -335,12 +439,12 @@ status = H5Tset_order(datatype, H5T_ORDER_LE); * to little endian is not needed. */ dataset = H5Dcreate(file, DATASETNAME, datatype, dataspace, H5P_DEFAULT); -
How to discard objects when they are no longer needed
+
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.
H5Tclose(datatype);
H5Dclose(dataset);
H5Sclose(dataspace); -
How to write a dataset to a new file
+
How to write a dataset to a new file

Having defined the datatype, dataset, and dataspace parameters, you write out the data with a call to H5Dwrite.
/* * Write the data to the dataset using default transfer @@ -351,7 +455,7 @@ status = H5Dwrite(dataset, H5T_NATIVE_INT, H5S_ALL, H5S_ALL,
The third and fourth parameters of H5Dwrite in the example describe the dataspaces in memory and in the file, respectively. They are set to the value H5S_ALL to indicate that an entire dataset is to be written. In a later section we look at how we would access a portion of a dataset.
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
+
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:
/* * Get datatype and dataspace identifiers and then query @@ -371,7 +475,7 @@ dataspace = H5Dget_space(dataset); /* dataspace identifier */ 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
+
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.
@@ -392,8 +496,12 @@ printf("rank %d, dimensions %d x %d \n", rank, dims_out[0], dims_out[1]);
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.
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
+
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. +
+ +
+Hyperslab selection

@@ -548,6 +656,7 @@ printf("rank %d, dimensions %d x %d \n", rank, dims_out[0], dims_out[1]);

+
Four parameters are required to describe a completely general hyperslab. Each parameter is an array whose rank is the same as that of the dataspace: @@ -599,6 +708,10 @@ status = H5Sselect_hyperslab(memspace, H5S_SELECT_SET, offset_out, NULL, count_o /*

Example 2 contains a complete program that performs these operations.
Example with strides and blocks. Consider the 8x12 dataspace described above, in which we selected eight 3x2 blocks. Suppose we wish to fill these eight blocks. +
+ +
+Hyperslab selection

@@ -753,9 +866,14 @@ status = H5Sselect_hyperslab(memspace, H5S_SELECT_SET, offset_out, NULL, count_o

+
This hyperslab has the following parameters: start=(0,1), stride=(4,3), count=(2,4), block=(3,2).
Suppose that the source dataspace in memory is this 50-element one dimensional array called vector: +
+ +
+A 50-element one dimensional array
@@ -783,6 +901,7 @@ status = H5Sselect_hyperslab(memspace, H5S_SELECT_SET, offset_out, NULL, count_o
-1

-1

+
The following code will write 48 elements from vector to our file dataset, starting with the second element in vector.
@@ -817,6 +936,10 @@ ret = H5Sselect_hyperslab(mid1, H5S_SELECT_SET, start, stride, count, block); ret = H5Dwrite(dataset, H5T_NATIVE_INT, midd1, fid, H5P_DEFAULT, vector)

After these operations, the file dataspace will have the following values. +
+ +
+Hyperslab selection with assigned values

@@ -971,10 +1094,11 @@ ret = H5Dwrite(dataset, H5T_NATIVE_INT, midd1, fid, H5P_DEFAULT, vector)

+
Notice that the values are inserted in the file dataset in row-major order.
Example 3 includes this code and other example code illustrating the use of hyperslab selection. -
Selecting a list of independent points
+
Selecting a list of independent points
A hyperslab specifies a regular pattern of elements in a dataset. It is also possible to specify a list of independent elements to read or write using the function H5Sselect_elements. Suppose, for example, that we wish to write the values 53, 59, 61, 67 to the following elements of the 8x12 array used in the previous example: (0,0), (3,3), (3,5), and (5,6). The following code selects the points and writes them to the dataset:
#define FSPACE_RANK 2 /* Dataset rank as it is stored in the file */ @@ -1014,7 +1138,10 @@ ret = H5Dwrite(dataset, H5T_NATIVE_INT, mid2, fid, H5P_DEFAULT, values);

After these operations, the file dataspace will have the following values: +
+
+Hyperslab selection with an overlay of independent points
@@ -1583,7 +1710,7 @@ the previous selection example. -
Creating compound datatypes
+
Creating compound datatypes
Properties of compound datatypes. A compound datatype is similar to a struct in C or a common block in Fortran. It is a collection of one or more atomic types or small arrays of such types. To create and use of a compound datatype you need to refer to various properties of the data compound datatype:
@@ -1615,7 +1742,7 @@ H5Tinsert (complex_id, "real", HOFFSET(tmp,re), H5Tinsert (complex_id, "imaginary", HOFFSET(tmp,im), H5T_NATIVE_DOUBLE);
Example 4 shows how to create a compound data type, write an array that has the compound data type to the file, and read back subsets of the members. -
Creating and writing extendible datasets
+
Creating and writing extendible datasets

An extendible dataset is one whose dimensions can grow. In HDF5, it is possible to define a dataset to have certain initial dimensions, then later to increase the size of any of the initial dimensions.
For example, you can create and store the following 3x3 HDF5 dataset:
1 1 1 @@ -1691,43 +1818,131 @@ status = H5Dextend (dataset, size);

Example 5 shows how to create a 3x3 extendible dataset, write the dataset, extend the dataset to 10x3, write the dataset again, extend it again to 10x5, write the dataset again.
Example 6 shows how to read the data written by Example 5. -
Working with groups in a file
+
Working with groups in a file

Groups provide a mechanism for organizing meaningful and extendible sets of datasets within an HDF5 file. The H5G API contains routines for working with groups. -
Creating a group. To create a group, use H5Gcreate. For example, the following code creates two groups that are members of the root group. They are called /IntData and /FloatData. The return value dir is the group identifier. -
/* -* Create two groups in a file. -*/ -dir = H5Gcreate(file, "/IntData", 0); -status = H5Gclose(dir); -dir = H5Gcreate(file,"/FloatData", 0); -status = H5Gclose(dir);
-
The third parameter in H5Gcreate optionally specifies how much file space to reserve to store the names that will appear in this group. If a non-positive value is supplied then a default size is chosen. -
H5Gclose closes the group and releases the group identifier. -
-
Creating an object in a particular group. Except for single-object HDF5 files, every object in an HDF5 file must belong to a group, and hence has a path name. Hence, we put an object in a particular group by giving its path name when we create it. For example, the following code creates a dataset IntArray in the group /IntData: -
/* - * Create dataset in the /IntData group by specifying full path. - */ -dims[0] = 2; -dims[1] = 3; -dataspace = H5Pcreate_simple(2, dims, NULL); -dataset = H5Dcreate(file, "/IntData/IntArray", H5T_NATIVE_INT, dataspace, H5C_DEFAULT);
-
Changing the current group. The HDF5 Group API supports the idea of a current group. This is analogous to the current working directory idea in UNIX. You can set the current group in HDF5 with the routine H5Gset. The following code shows how to set a current group, then create a certain dataset, FloatData, in that group. -
/* - * Set current group to /FloatData. - */ -status = H5Gset (file, "/FloatData"); +Creating a group. To create a group, use +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); + +A group may be created in another group by providing the +absolute name of the group to the H5Gcreate +function or by specifying its location. For example, +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); + +or ++ /* + * 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 +when the relative name is provided. + +The third parameter in H5Gcreate optionally +specifies how much file space to reserve to store the names +that will appear in this group. If a non-positive +value is supplied, then a default size is chosen. + +H5Gclose closes the group and releases the +group identifier. + -/* - * Create two datasets - */ +Creating a dataset in a particular group. +As with groups, a dataset can be created in a particular +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); + +A relative dataset name may also be used when a dataset is +created. First obtain the identifier of the group in which +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"); + + /* + * 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); + + + +Accessing an object in a group. +Any object in a group can be accessed by its absolute or +relative name. The following lines of code show how to use +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"); + +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"); + + /* + * Access the "Compressed_Data" dataset in the group. + */ + dataset = H5Dopen(grp, "Compressed_Data"); + -dims[0] = 5; -dims[1] = 10; -dataspace = H5Screate_simple(2, dims, NULL); -dataset = H5Dcreate(file, "FloatArray", H5T_NATIVE_FLOAT, dataspace, H5P_DEFAULT);
-
Example 7 shows how to create an HDF5 file with two group, and to place some datasets within those groups. -
Working with attributes
+
+Example 7 shows +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. + + +
Working with attributes

Think of an attribute as a small datasets that is attached to a normal dataset or group. The H5A API contains routines for working with attributes. Since attributes share many of the characteristics of datasets, the programming model for working with attributes is analogous in many ways to the model for working with datasets. The primary differences are that an attribute must be attached to a dataset or a group, and subsetting operations cannot be performed on attributes.
To create an attribute belonging to a particular dataset or group, first create a dataspace for the attribute with the call to H5Screate, then create the attribute using H5Acreate. For example, the following code creates an attribute called Integer_attribute that is a member of a dataset whose identifier is dataset. The attribute identifier is attr2. H5Awrite then sets the value of the attribute of that of the integer variable point. H5Aclose then releases the attribute identifier. @@ -1787,13 +2002,14 @@ printf("The value of the attribute with the index 2 is %s \n", string_out); Example 8 illustrates the use of the H5Aiterate function, as well as the other attribute examples described above. +
(Return to TOC)
-
Example code
+
4. Example Codes
-
Example 1: How to create a homogeneous multi-dimensional dataset and write it to a file.
+
Example 1: How to create a homogeneous multi-dimensional dataset and write it to a file.

This example creates a 2-dimensional HDF 5 dataset of little endian 32-bit integers.
@@ -2785,30 +3001,40 @@ main (void)
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 groups within the file and - * datasets within the file and groups. + * This example creates a group in the file and dataset in the group. + * Hard link to the group object is created and the dataset is accessed + * under different names. + * Iterator function is used to find the object names in the root group. */ #include "hdf5.h" -#define FILE "DIR.h5" +#define FILE "group.h5" #define RANK 2 + +herr_t file_info(hid_t loc_id, const char *name, void *opdata); + /* Operator function */ int main(void) { - hid_t file, dir; + hid_t file; + hid_t grp; hid_t dataset, dataspace; + hid_t plist; herr_t status; hsize_t dims[2]; - hsize_t size[1]; + hsize_t cdims[2]; + + int idx; /* * Create a file. @@ -2816,95 +3042,118 @@ main(void) file = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); /* - * Create two groups in a file. + * Create a group in the file. */ - dir = H5Gcreate(file, "/IntData", 0); - status = H5Gclose(dir); - - dir = H5Gcreate(file,"/FloatData", 0); - status = H5Gclose(dir); + grp = H5Gcreate(file, "/Data", 0); + /* + * Create dataset "Compressed Data" in the group using absolute + * name. 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 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 dataspace for the character string + * Close the dataset and the file. */ - size[0] = 80; - dataspace = H5Screate_simple(1, size, NULL); + H5Sclose(dataspace); + H5Dclose(dataset); + H5Fclose(file); /* - * Create dataset "String" in the root group. + * Now reopen the file and group in the file. */ - dataset = H5Dcreate(file, "String", H5T_NATIVE_CHAR, dataspace, - H5P_DEFAULT); - H5Dclose(dataset); + file = H5Fopen(FILE, H5F_ACC_RDWR, H5P_DEFAULT); + grp = H5Gopen(file, "Data"); - /* - * Create dataset "String" in the /IntData group. + /* + * Access "Compressed_Data" dataset in the group. */ - dataset = H5Dcreate(file, "/IntData/String", H5T_NATIVE_CHAR, dataspace, - H5P_DEFAULT); - H5Dclose(dataset); + dataset = H5Dopen(grp, "Compressed_Data"); + if( dataset < 0) printf(" Dataset is not found. \n"); + printf("\"/Data/Compressed_Data\" dataset is open \n"); /* - * Create dataset "String" in the /FloatData group. + * Close the dataset. */ - dataset = H5Dcreate(file, "/FloatData/String", H5T_NATIVE_CHAR, dataspace, - H5P_DEFAULT); - H5Sclose(dataspace); - H5Dclose(dataset); + status = H5Dclose(dataset); /* - * Create IntArray dataset in the /IntData group by specifying full path. + * Create hard link to the Data group. */ - dims[0] = 2; - dims[1] = 3; - dataspace = H5Screate_simple(RANK, dims, NULL); - dataset = H5Dcreate(file, "/IntData/IntArray", H5T_NATIVE_INT, dataspace, - H5P_DEFAULT); - H5Sclose(dataspace); - H5Dclose(dataset); + status = H5Glink(file, H5G_LINK_HARD, "Data", "Data_new"); - /* - * Set current group to /IntData and attach to the dataset String. + /* + * We can access "Compressed_Data" dataset using created + * hard link "Data_new". */ - status = H5Gset (file, "/IntData"); - dataset = H5Dopen(file, "String"); - if (dataset > 0) printf("String dataset in /IntData group is found\n"); - H5Dclose(dataset); + dataset = H5Dopen(file, "/Data_new/Compressed_Data"); + if( dataset < 0) printf(" Dataset is not found. \n"); + printf("\"/Data_new/Compressed_Data\" dataset is open \n"); /* - * Set current group to /FloatData. + * Close the dataset. */ - status = H5Gset (file, "/FloatData"); + status = H5Dclose(dataset); /* - * Create two datasets FlatArray and DoubleArray. + * Use iterator to see the names of the objects in the file + * root directory. */ - dims[0] = 5; - dims[1] = 10; - dataspace = H5Screate_simple(RANK, dims, NULL); - dataset = H5Dcreate(file, "FloatArray", H5T_NATIVE_FLOAT, dataspace, - H5P_DEFAULT); - H5Sclose(dataspace); - H5Dclose(dataset); + idx = H5Giterate(file, "/", NULL, file_info, NULL); - dims[0] = 4; - dims[1] = 6; - dataspace = H5Screate_simple(RANK, dims, NULL); - dataset = H5Dcreate(file, "DoubleArray", H5T_NATIVE_DOUBLE, dataspace, - H5P_DEFAULT); - H5Sclose(dataspace); - H5Dclose(dataset); + /* + * Unlink name "Data" and use iterator to see the names + * of the objects in the file root direvtory. + */ + if (H5Gunlink(file, "Data") < 0) + printf(" H5Gunlink failed \n"); + else + printf("\"Data\" is unlinked \n"); - /* - * Attach to /FloatData/String dataset. + idx = H5Giterate(file, "/", NULL, file_info, NULL); + + + /* + * Close the file. */ - dataset = H5Dopen(file, "/FloatData/String"); - if (dataset > 0) printf("/FloatData/String dataset is found\n"); - H5Dclose(dataset); - H5Fclose(file); + + status = H5Fclose(file); return 0; } +/* + * Operator function. + */ +herr_t +file_info(hid_t loc_id, const char *name, void *opdata) +{ + hid_t grp; + /* + * Open the group using its name. + */ + grp = H5Gopen(loc_id, name); + + /* + * Display group name. + */ + printf("\n"); + printf("Name : "); + puts(name); + + H5Gclose(grp); + return 0; + }
@@ -3184,13 +3433,14 @@ attr_info(hid_t loc_id, const char *name, void *opdata)
+
(Return to TOC)

53

HDF Help Desk
-Last modified: 20 October 1998 +Last modified: 28 October 1998 Copyright   diff --git a/doc/html/H5.user.html b/doc/html/H5.user.html index 6863ccb..b3fb1b3 100644 --- a/doc/html/H5.user.html +++ b/doc/html/H5.user.html @@ -22,6 +22,8 @@ A guide to the H5S interface.
Groups - A guide to the H5G interface. +
References and Identifiers - + A guide to the H5R and H5I interfaces.
Attributes - A guide to the H5A interface.
Property Lists - @@ -32,11 +34,15 @@ A guide to the H5Z interface.
Caching - A guide for meta and raw data caching. +
Dataset Chunking - + A guide to the issues and pitfalls of dataset chunking.
Debugging - A guide to debugging HDF5 API calls.
Environment Variables and Configuration Parameters - A list of HDF5 environment variables and configuration parameters. +
DDL for HDF5 - + A DDL in BNF for HDF5.
Ragged Arrays - A guide to the H5RA interface.   (Experimental) @@ -85,7 +91,7 @@ Last modified: Wed Aug 19 15:29:11 PDT 1998
HDF Help Desk
-Last modified: 9 September 1998 +Last modified: 27 October 1998 Copyright   diff --git a/doc/html/RM_H5.html b/doc/html/RM_H5.html index ad2cb8d..8e4c174 100644 --- a/doc/html/RM_H5.html +++ b/doc/html/RM_H5.html @@ -14,7 +14,10 @@ H5   H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -57,7 +60,7 @@ and it users.
Signature:
herr_t H5open(void)
Purpose: -
Flushes all data to disk, closes file identifiers, and cleans up memory. +
Initializes the HDF5 library.
Description:
H5open initialize the library. This function is normally called automatically, but if you find that an @@ -68,8 +71,8 @@ and it users.
None.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -92,8 +95,8 @@ and it users.
None.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -123,8 +126,8 @@ and it users.
None.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -152,8 +155,8 @@ and it users.
The release number of the library.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -188,7 +191,7 @@ and it users.
The patch number of the library.
Returns: -
Returns SUCCEED (0) if successful. +
Returns a non-negative value if successful. Upon failure, this function causes the application to abort. @@ -202,7 +205,10 @@ H5   H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -217,7 +223,7 @@ H5   HDF Help Desk
-Last modified: 2 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5A.html b/doc/html/RM_H5A.html index bda4333..e53a6d4 100644 --- a/doc/html/RM_H5A.html +++ b/doc/html/RM_H5A.html @@ -14,7 +14,10 @@ H5A   H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -122,7 +125,7 @@ See Attributes in the
Returns:
Returns an attribute identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -154,7 +157,7 @@ See Attributes in the
Returns:
Returns attribute identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -187,7 +190,7 @@ See Attributes in the
Returns:
Returns attribute identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -224,8 +227,8 @@ See Attributes in the
IN: Data to be written.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -262,8 +265,8 @@ See Attributes in the
IN: Buffer for data to be read.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -286,7 +289,7 @@ See Attributes in the
Returns:
Returns attribute dataspace identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -315,7 +318,7 @@ See Attributes in the
Returns:
Returns a datatype identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -323,7 +326,7 @@ See Attributes in the

Name: H5Aget_name
Signature: -
size_t H5Aget_name(hid_t attr_id, +
hssize_t H5Aget_name(hid_t attr_id, char *buf, size_t buf_size ) @@ -349,7 +352,7 @@ See Attributes in the
Returns:
Returns the length of the attribute's name, which may be longer than buf_size, if successful. - Otherwise returns FAIL (-1). + Otherwise returns a negative value.
@@ -372,7 +375,7 @@ See Attributes in the
Returns:
Returns the number of attributes if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -436,7 +439,7 @@ See Attributes in the
Returns:
If successful, returns the return value of the last operator if it was non-zero, or zero if all attributes were processed. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -465,8 +468,8 @@ See Attributes in the
IN: Name of the attribute to delete.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -488,8 +491,8 @@ See Attributes in the
IN: Attribute to release access to.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -502,7 +505,10 @@ H5A   H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -517,7 +523,7 @@ H5A   HDF Help Desk
-Last modified: 1 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5D.html b/doc/html/RM_H5D.html index bb2c4dc..22b096c 100644 --- a/doc/html/RM_H5D.html +++ b/doc/html/RM_H5D.html @@ -14,7 +14,10 @@ H5D   H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -103,7 +106,7 @@ and set and retrieve their constant or persistent properties.
Returns:
Returns a dataset identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -130,7 +133,7 @@ and set and retrieve their constant or persistent properties.
Returns:
Returns a dataset identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -154,7 +157,7 @@ and set and retrieve their constant or persistent properties.
Returns:
Returns a dataspace identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -182,7 +185,7 @@ and set and retrieve their constant or persistent properties.
Returns:
Returns a datatype identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -207,7 +210,7 @@ and set and retrieve their constant or persistent properties.
Returns:
Returns a dataset creation property list identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -274,8 +277,8 @@ and set and retrieve their constant or persistent properties.
Buffer to store data read from the file.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -344,8 +347,8 @@ and set and retrieve their constant or persistent properties.
Buffer with data to be written to the file.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -372,8 +375,8 @@ and set and retrieve their constant or persistent properties.
Array containing the new magnitude of each dimension.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -396,8 +399,8 @@ and set and retrieve their constant or persistent properties.
Identifier of the dataset to finish access to.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -410,7 +413,10 @@ H5D   H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -425,7 +431,7 @@ H5D   HDF Help Desk
-Last modified: 12 August 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5E.html b/doc/html/RM_H5E.html index d29380e..8efe624 100644 --- a/doc/html/RM_H5E.html +++ b/doc/html/RM_H5E.html @@ -14,7 +14,10 @@ HDF5/H5E Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -112,8 +115,8 @@ errors within the H5E package.
Data passed to the error function.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -141,8 +144,8 @@ errors within the H5E package.
Current setting for the data passed to the error function.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -166,8 +169,8 @@ errors within the H5E package.
None
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -194,8 +197,8 @@ errors within the H5E package.
File pointer, or stderr if NULL.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -240,8 +243,8 @@ errors within the H5E package.
Data to be passed with func.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -288,8 +291,8 @@ errors within the H5E package.
A file pointer, or stderr if null.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -346,7 +349,10 @@ errors within the H5E package. H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -361,7 +367,7 @@ H5E   HDF Help Desk
-Last modified: 14 July 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5F.html b/doc/html/RM_H5F.html index a242e2a..220a307 100644 --- a/doc/html/RM_H5F.html +++ b/doc/html/RM_H5F.html @@ -14,7 +14,10 @@ HDF5/H5F Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -46,6 +49,7 @@ documented below.

H5Fflush
H5Fclose +
H5Freopen


@@ -102,7 +106,7 @@ documented below.
Returns:
Returns a file identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -166,7 +170,7 @@ documented below.
Returns:
Returns a file identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -174,7 +178,8 @@ documented below.

Name: H5Fflush
Signature: -
herr_t H5Fflush(hid_t object_id +
herr_t H5Fflush(hid_t object_id, + H5F_scope_t scope )
Purpose:
Flushes all buffers associated with a file to disk. @@ -186,14 +191,29 @@ documented below. 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. +
+ scope specifies whether the scope of the flushing + action is global or local. Valid values are +
+ + + + + + + +
H5F_SCOPE_GLOBAL      Flushes the entire virtual file.
H5F_SCOPE_LOCAL Flushes only the specified file.
+
Parameters:

const char *object_id
Identifier of object used to identify the file. +
H5F_scope_t scope +
Specifies the scope of the flushing action.

Returns: -
Returns SUCCEED (0) if successful; - otherwise returns FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value.
@@ -215,7 +235,7 @@ documented below.
Returns:
Returns TRUE or FALSE if successful. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -247,7 +267,7 @@ documented below.
Returns:
Returns a file creation property list identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -276,7 +296,7 @@ documented below.
Returns:
Returns a file access property list identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -299,8 +319,35 @@ documented below.
Identifier of a file to terminate access to.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. + + + +
+
+
Name: H5Freopen +
Signature: +
hid__t H5Freopen(hid_t file_id + ) +
Purpose: +
Reopens an HDF5 file. +
Description: +
H5Freopen reopens an HDF5 file. The new + file identifier which is returned points to the same file + as the specified file idetifier, file_id. + Both identifiers share caches and other information. + The only difference between the identifiers is that the + new identifier is not mounted anywhere and no files are + mounted on it. +
Parameters: +
+
hid_t file_id +
Identifier of a file to terminate access to. +
+
Returns: +
Returns a new file identifier if successful; + otherwise returns a negative value.
@@ -313,7 +360,10 @@ documented below. H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -328,7 +378,7 @@ H5F   HDF Help Desk
-Last modified: 14 August 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5Front.html b/doc/html/RM_H5Front.html index e0e6397..8f23c56 100644 --- a/doc/html/RM_H5Front.html +++ b/doc/html/RM_H5Front.html @@ -13,10 +13,10 @@ HDF5 Reference Manual H5E   H5F   H5G   +H5I   H5P   - H5S   H5T   H5Z   @@ -37,23 +37,23 @@ tools required to meet specific aspects of the HDF5 data-handling requirements.

Library Functions -- The general-purpose H5 functions. +
Annotation Interface -- The H5A API for annotations. +
Dataset Interface -- The H5D API for manipulating scientific datasets. +
Error Interface -- The H5E API for error handling.
File Interface -- The H5F API for accessing HDF files. +
Group Interface -- The H5G API for creating physical groups of objects on disk. +
Identifier Interface -- The H5I API for working with object identifiers.
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. +
Reference Interface -- The H5R API for references.
Dataspace Interface -- The H5S API for defining dataset dataspace. -
Group Interface -- The H5G API for creating physical groups of objects on disk. -
Error Interface -- The H5E API for error handling. +
Datatype Interface -- The H5T API for defining dataset element information.
Compression Interface -- The H5Z API for compression. -
Annotation Interface -- The H5A API for annotations.
Tools -- Interactive tools for the examination of existing HDF5 files. -
@@ -67,10 +67,10 @@ HDF5 Reference Manual H5E   H5F   H5G   +H5I   H5P   - H5S   H5T   H5Z   @@ -86,7 +86,7 @@ HDF5 Reference Manual
HDF Help Desk
-Last modified: 8 September 1998 +Last modified: 27 October 1998 Copyright   diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html index 1e79039..fce1706 100644 --- a/doc/html/RM_H5G.html +++ b/doc/html/RM_H5G.html @@ -14,7 +14,10 @@ HDF5/H5G Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -31,8 +34,8 @@ H5G
Group Object API Functions
-The Group interface functions create and manipulate physical groups -of objects on disk. +The Group interface functions create and manipulate groups +of objects in an HDF5 file. +

@@ -77,7 +80,7 @@ object is located by looking for the first component in the root object, then looking for the second component in the first object, etc., until the entire name is traversed. A relative name does not begin with a slash and the traversal begins at the location specified by the -calling function. +create or access function.
@@ -105,7 +108,7 @@ calling function. is usually adequate since the library is able to dynamically resize the name heap, but a correct hint may result in better performance. - If a non-positive value is supplied for size_hint, + If a non-positive value is supplied for size_hint, then a default size is chosen.
The return value is a group identifier for the open group. @@ -128,7 +131,7 @@ calling function.
Returns:
Returns a valid group identifier for the open group if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -143,12 +146,14 @@ calling function.
Opens an existing group for modification and returns a group identifier for that group.
Description: -
H5Gopen opens an existing group with the specified name at - the specified location, loc_id. - The location is identified by a file or - group identifier, and returns a group identifier for the group. - The obtained group identifier should be released by calling - H5Gclose() when it is no longer needed. +
H5Gopen opens an existing group with the specified + name at the specified location, loc_id. +
+ The location is identified by a file or group identifier +
+ H5Gopen returns a group identifier for the group + that was opened. This group identifier should be released by + calling H5Gclose() when it is no longer needed.
Parameters:

hid_t loc_id @@ -158,7 +163,7 @@ calling function.

Returns:
Returns a valid group identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -181,8 +186,8 @@ calling function.
Group identifier to release.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -203,7 +208,8 @@ calling function. name, possibly one of many names it currently has.
If link_type is H5G_LINK_HARD, then - current_name must name an existing object and both + current_name must specify the name of an + existing object and both names are interpreted relative to loc_id, which is either a file identifier or a group identifier.
@@ -229,8 +235,8 @@ calling function.
New name for the object.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -263,8 +269,8 @@ calling function.
Name of the object to unlink.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -334,7 +340,7 @@ calling function.
Returns:
Returns the return value of the last operator if it was non-zero, or zero if all group members were processed. - Otherwise, returns FAIL (-1). + Otherwise returns a negative value. @@ -365,8 +371,8 @@ calling function.
Object's new name.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -384,7 +390,8 @@ calling function.
Description:
H5Gget_objinfo returns information about the specified object through the statbuf argument. - loc_id (a file, group, or dataset identifier) and + loc_id (a file, group, dataset, or + named datatype identifier) and name together determine the object. If the object is a symbolic link and follow_link is zero (0), then the information returned is that for the link itself; @@ -441,9 +448,9 @@ calling function.
OUT: Buffer in which to return information about the object.
Returns: -
Returns SUCCEED (0) with the fields of statbuf - (if non-null) initialized. - Otherwise returns FAIL (-1). +
Returns a non-negative value if successful, with the fields of + statbuf (if non-null) initialized. + Otherwise returns a negative value. @@ -484,9 +491,9 @@ calling function.
OUT: Link value.
Returns: -
Returns SUCCEED (0), with the link value in value, +
Returns a non-negative value, with the link value in value, if successful. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -528,8 +535,8 @@ calling function.
IN: The new comment.
Returns: -
Returns SUCCEED (0) if successful; - otherwise returns FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -571,7 +578,7 @@ calling function.
Returns the number of characters in the comment, counting the null terminator, if successful; the value returned may be larger than bufsize. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -589,7 +596,10 @@ calling function. H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -604,7 +614,7 @@ H5G   HDF Help Desk
-Last modified: 2 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html index d9f1191..8dda42f 100644 --- a/doc/html/RM_H5P.html +++ b/doc/html/RM_H5P.html @@ -14,7 +14,10 @@ HDF5/H5P Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -57,6 +60,11 @@ many different parameters to be easily manipulated.
H5Pset_istore_k
H5Pget_istore_k +
+
+||   Available only in the +
     +parallel HDF5 library.
       @@ -95,6 +103,8 @@ many different parameters to be easily manipulated.
H5Pset_compression
H5Pget_compression --> +
H5Pset_fill_value +
H5Pget_fill_value
H5Pset_filter
H5Pget_nfilters
H5Pget_filter @@ -115,10 +125,12 @@ many different parameters to be easily manipulated.

IN: Identifier of the property list to terminate access to.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -202,7 +214,7 @@ many different parameters to be easily manipulated.
Returns the property list class for a property list.
Description:
H5Pget_class returns the property list class for the - property list identied by the plist parameter. + property list identified by the plist parameter. Valid property list classes are defined in the description of H5Pcreate().
Parameters: @@ -236,7 +248,7 @@ many different parameters to be easily manipulated.
Returns:
Returns a property list identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -271,8 +283,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return shared object header version number.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -298,8 +310,8 @@ many different parameters to be easily manipulated.
IN: Size of the user-block in bytes.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -323,8 +335,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return user-block size.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -344,7 +356,7 @@ many different parameters to be easily manipulated. address objects in an HDF5 file. This function is only valid for file creation property lists. Passing in a value of 0 for one of the sizeof parameters retains the current value. The default value - for both values is 4 bytes. Valid values currenly are 2, 4, 8 and + for both values is 4 bytes. Valid values currently are 2, 4, 8 and 16.
Parameters:
@@ -356,8 +368,8 @@ many different parameters to be easily manipulated.
IN: Size of an object length in bytes.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -385,8 +397,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return length size in bytes.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -426,8 +438,8 @@ many different parameters to be easily manipulated. again to setup the property list.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -457,8 +469,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return the info object.
Returns: -
Returns SUCCEED (0) if the file access property list is set to the MPI. - Otherwise returns FAIL (-1). +
Returns a non-negative value if the file access property list is set to the MPI. + Otherwise returns a negative value. @@ -495,8 +507,8 @@ many different parameters to be easily manipulated.
IN: Data transfer mode.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -522,8 +534,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return the data transfer mode.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -565,8 +577,8 @@ many different parameters to be easily manipulated.
IN: Symbol table node size.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -599,8 +611,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return the symbol table's leaf node 1/2 size.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -633,8 +645,8 @@ many different parameters to be easily manipulated.
IN: 1/2 rank of chunked storage B-tree.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -662,8 +674,8 @@ many different parameters to be easily manipulated.
OUT: Pointer to location to return the chunked storage B-tree 1/2 rank.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -687,12 +699,12 @@ many different parameters to be easily manipulated. This should only be used for very small amounts of raw data (suggested less than 1KB).
H5D_CONTIGUOUS -
Store raw data seperately from object header in one +
Store raw data separately from object header in one large chunk in the file.
H5D_CHUNKED -
Store raw data seperately from object header in one +
Store raw data separately from object header in one large chunk in the file and store chunks of the raw - data in seperate locations in the file. + data in separate locations in the file.
Parameters:
@@ -702,8 +714,8 @@ many different parameters to be easily manipulated.
IN: Type of storage layout for raw data.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -722,11 +734,11 @@ many different parameters to be easily manipulated.
H5D_COMPACT
Raw data and object header stored contiguously in file.
H5D_CONTIGUOUS -
Raw data stored seperately from object header in one +
Raw data stored separately from object header in one large chunk in the file.
H5D_CHUNKED -
Raw data stored seperately from object header in - chunks in seperate locations in the file. +
Raw data stored separately from object header in + chunks in separate locations in the file.
Parameters:
@@ -769,8 +781,8 @@ many different parameters to be easily manipulated.
IN: An array containing the size of each chunk.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -802,7 +814,7 @@ many different parameters to be easily manipulated.
Returns:
Returns chunk dimensionality successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -836,13 +848,13 @@ many different parameters to be easily manipulated.
hid_t plist
IN: Identifier for a file access property list.
hsize_t threshold -
IN: Threshhold value. +
IN: Threshold value.
hsize_t alignment
IN: Alignment value.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -867,13 +879,13 @@ many different parameters to be easily manipulated.
hid_t plist
IN: Identifier of a file access property list.
hsize_t *threshold -
OUT: Pointer to location of return threshhold value. +
OUT: Pointer to location of return threshold value.
hsize_t *alignment
OUT: Pointer to location of return alignment value.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -911,8 +923,8 @@ many different parameters to be easily manipulated.
IN: Number of bytes reserved in the file for the data.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -934,7 +946,7 @@ many different parameters to be easily manipulated.
Returns:
Returns the number of external files if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -982,11 +994,92 @@ many different parameters to be easily manipulated. external file data.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. + + +
+
+
Name: H5Pset_fill_value +
Signature: +
herr_t H5Pset_fill_value(hid_t plist_id, + hid_t type_id, + const void *value + ) +
Purpose: +
Sets a dataset fill value. +
Description: +
H5Pset_fill_value sets the fill value for a + dataset creation property list. +
+ The value is interpreted as being of type + type_id. This need not be the same type + as the dataset, but the library must be able to convert + value to the dataset type when the dataset + is created. +
Notes: +
If a fill value is set for a dataset (even if the + fill value is all zeros), the fill value will be written + to the file. If no fill value is set, then HDF5 relies on + the underlying file driver (usually a Unix file system) + to initialize unwritten parts of the file to zeros. +
+ Creating a contiguous dataset with a fill value can be a + very expensive operation since the optimization has not + yet been implemented that would delay the writing of the + fill values until after some data has been written. +
Parameters: +
+
hid_t plist_id +
IN: Property list identifier. +
hid_t type_id, +
IN: The datatype identifier of value. +
const void *value +
IN: The fill value. +
+
Returns: +
Returns a non-negative value if successful; + otherwise returns a negative value. + + +
+
+
Name: H5Pget_fill_value +
Signature: +
herr_t H5Pget_fill_value(hid_t plist_id, + hid_t type_id, + void *value + ) +
Purpose: +
Retrieves a dataset fill value. +
Description: +
H5Pget_fill_value queries the + fill value property of a dataset creation property list. +
+ The fill value is returned through the value + pointer. +
+ Memory is allocated by the caller. +
+ The fill value will be converted from its current + data type to the type specified by type_id. +
Parameters: +
+
hid_t plist_id +
IN: Property list identifier. +
hid_t type_id, +
IN: The datatype identifier of value. +
const void *value +
IN: The fill value. +
+
Returns: +
Returns a non-negative value if successful; + otherwise returns a negative value.
+ +

Name: H5Pset_filter @@ -1055,8 +1148,8 @@ many different parameters to be easily manipulated.
IN: Auxiliary data for the filter.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value.
@@ -1092,7 +1185,7 @@ many different parameters to be easily manipulated.
Returns:
Returns the number of filters in the pipeline if successful; - otherwise returns FAIL (-1). + otherwise returns a negative value. @@ -1129,8 +1222,8 @@ many different parameters to be easily manipulated. 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. + The function will return a negative value 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 @@ -1218,8 +1311,8 @@ many different parameters to be easily manipulated.
IN: Identifier of a file access property list.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1242,9 +1335,9 @@ many different parameters to be easily manipulated.
IN: Identifier of a file access property list.
Returns: -
Returns SUCCEED (0) if the file access propety list is set +
Returns a non-negative value if the file access property list is set to the stdio driver. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -1267,8 +1360,8 @@ many different parameters to be easily manipulated.
IN: Identifier of a file access property list.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1278,7 +1371,7 @@ many different parameters to be easily manipulated.
Signature:
returntype H5Pget_sec2(hid_t plist)
Purpose: -
Checks whether the file access propety list is set +
Checks whether the file access property list is set to the sec2 driver.
Description:
H5Pget_sec2 checks to determine whether the @@ -1291,9 +1384,9 @@ many different parameters to be easily manipulated.
IN: Identifier of a file access property list.
Returns: -
Returns SUCCEED (0) if the file access propety list is set +
Returns a non-negative value if the file access property list is set to the sec2 driver. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -1323,8 +1416,8 @@ many different parameters to be easily manipulated.
IN: File block size in bytes.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1353,9 +1446,9 @@ many different parameters to be easily manipulated.
OUT: Pointer to a location to return the file block size (in bytes).
Returns: -
Returns SUCCEED (0) if the file access propety list is set +
Returns a non-negative value if the file access property list is set to the core driver. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -1399,8 +1492,8 @@ many different parameters to be easily manipulated.
IN: Identifier of the raw file access property list.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1458,9 +1551,9 @@ many different parameters to be easily manipulated.
OUT: Pointer to a copy of the raw file access property list.
Returns: -
Returns SUCCEED (0) if the file access propety list is set +
Returns a non-negative value if the file access property list is set to the split driver. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -1491,7 +1584,7 @@ many different parameters to be easily manipulated. 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 + inaccessible. Additional parameters may be added to this function in the future.
Parameters:
@@ -1504,8 +1597,8 @@ many different parameters to be easily manipulated. for each member of the family.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1526,7 +1619,7 @@ many different parameters to be easily manipulated. 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 + in the HDF5 User's Guide for a discussion of file families.
Each member of the file family will use memb_plist @@ -1543,7 +1636,7 @@ many different parameters to be easily manipulated. 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. + inaccessible.
Additional parameters may be added to this function in the future. @@ -1558,8 +1651,8 @@ many different parameters to be easily manipulated. for each member of the family.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1596,9 +1689,9 @@ many different parameters to be easily manipulated. for each member of the family.
Returns: -
Returns SUCCEED (0) if the file access propety list is set +
Returns a non-negative value if the file access property list is set to the family driver. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -1645,8 +1738,8 @@ many different parameters to be easily manipulated.
IN: Preemption policy.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1660,7 +1753,7 @@ many different parameters to be easily manipulated. double *rdcc_w0 )
Purpose: -
Retrieves maximun sizes of meta data cache and RDCC_WO. +
Retrieves maximum sizes of meta data cache and RDCC_WO.
Description:
Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the @@ -1679,8 +1772,8 @@ many different parameters to be easily manipulated.
IN/OUT: Preemption policy.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1701,7 +1794,7 @@ many different parameters to be easily manipulated. for the type conversion buffer and background buffer and optionally supply pointers to application-allocated buffers. If the buffer size is smaller than the entire amount of data - being transfered between application and file, and a type + being transferred between application and file, and a type conversion buffer or background buffer is required then strip mining will be used. However, certain restrictions apply for the size of buffer which can be used for strip @@ -1725,8 +1818,8 @@ many different parameters to be easily manipulated.
IN: Pointer to application-allocated background buffer.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1787,8 +1880,8 @@ many different parameters to be easily manipulated. (TRUE/FALSE).
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1809,7 +1902,7 @@ many different parameters to be easily manipulated.
Returns:
Returns TRUE or FALSE if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -1830,7 +1923,7 @@ many different parameters to be easily manipulated.
Description:
H5Pset_compression sets the compression method in a dataset creation property list. This is a catch-all - function for defining compresion methods + function for defining compression methods and is intended to be called from a wrapper such as H5Pset_deflate(). The dataset creation property list plist is adjusted to use the specified @@ -1861,8 +1954,8 @@ many different parameters to be easily manipulated.
IN: Client data byte array passed to the compression method.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. --> @@ -1902,7 +1995,7 @@ many different parameters to be easily manipulated.
Returns:
Returns compression method if successful; - otherwise FAIL (-1). + otherwise returns a negative value. --> @@ -1932,8 +2025,8 @@ many different parameters to be easily manipulated.
IN: Compression level.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1958,7 +2051,7 @@ many different parameters to be easily manipulated.
Returns:
Returns compression level, a value between 0 and 9, if successful. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. --> @@ -1973,7 +2066,10 @@ many different parameters to be easily manipulated. H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -1989,7 +2085,7 @@ H5P   HDF Help Desk
-Last modified: 25 August 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5RA.html b/doc/html/RM_H5RA.html index 2b2d80e..bb7bca4 100644 --- a/doc/html/RM_H5RA.html +++ b/doc/html/RM_H5RA.html @@ -14,7 +14,9 @@ HDF5/H5RA Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   H5RA   H5S   H5T   @@ -46,11 +48,13 @@ Do not create any archives using this interface!
These functions enable the user to store and retrieve data in ragged arrays. -

H5RAcreate +
+        +

H5RAopen
H5RAclose
@@ -63,6 +67,21 @@ These functions enable the user to store and retrieve data in ragged arrays.

+This version of the Ragged Array interface implements a +two-dimensional array where each row of the array is a different length. +It is intended for applications where the distribution of row lengths +is such that most rows are near an average length with only a few rows +that are significantly shorter or longer. The raw data is split among +two datasets, raw and over: the raw +dataset is a two-dimensional chunked dataset whose width is large enough +to hold most of the rows while the over dataset is a heap +that stores the ends of rows that overflow the first dataset. +A third dataset, called meta, contains one record for each +row and describes what elements, if any, overflow the raw +dataset and where they are stored in the over dataset. +All three datasets are contained in a single group whose name is the +name of the ragged array. +
@@ -70,26 +89,49 @@ These functions enable the user to store and retrieve data in ragged arrays.

Name: H5RAcreate
Signature: -
H5RAcreate( , - , - +
hid_t H5RAcreate(hid_t loc_id, + const char *name, + hid_t type_id, + hid_t plist_id )
Purpose: -
+
Creates a ragged array.
Description: -
H5RAcreate +
H5RAcreate creates a new ragged array with the + name specified in name. A ragged array is + implemented as a group containing three datasets. + The dataset raw is a fixed width dataset + which will hold the majority of the data. + The dataset over is a one dimensional heap + which will hold the end of rows which are too long to fit + in raw + Finally, the meta dataset contains information + about the over array. All elements of the + ragged array are stored with the same data type. +
+ The property list plist_id should contain + information about chunking. The chunk width will determine + the width of the raw dataset while the chunk + length should be such that the total chunk size is + reasonably large since I/O will be performed in units + of chunks). If the plist_id does not have + a chunk size defined (e.g., H5P_DEFAULT) + then this function will fail.
Parameters:
-
-
-
-
-
-
+
hid_t loc_id +
Location identifier of the dataset. +
const char *name +
The assigned name of the data set to be stored in the + ragged array. +
hid_t type_id +
Data type identifier for the ragged array data. +
hid_t plist_id +
Property list of the dataset.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a ragged array identifier if successful; + otherwise returns a negative value.
@@ -97,26 +139,27 @@ These functions enable the user to store and retrieve data in ragged arrays.

Name: H5RAopen
Signature: -
H5RAopen( , - , - +
hid_t H5RAopen(hid_t loc_id, + const char *name )
Purpose: -
+
Opens a ragged array.
Description: -
H5RAopen +
H5RAopen opens an existing ragged array. +
+ The name of the array, name, should be the same + that was used when the array was created, i.e., the name of + the group which implements the array.
Parameters:
-
-
-
-
-
-
+
hid_t loc_id +
The location identifier of the dataset. +
const char *name +
The name of the ragged array.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a ragged array identifier if successful; + otherwise returns a negative value.
@@ -124,26 +167,20 @@ These functions enable the user to store and retrieve data in ragged arrays.

Name: H5RAclose
Signature: -
H5RAclose( , - , - - ) +
herr_t H5RAclose(hid_t array_id)
Purpose: -
+
Closes a ragged array.
Description: -
H5RAclose +
H5RAclose closes the ragged array specified + with the array identifier array_id.
Parameters:
-
-
-
-
-
-
+
hid_t array_id +
The array identifier for the ragged array to be closed.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value.
@@ -151,14 +188,23 @@ These functions enable the user to store and retrieve data in ragged arrays.

Name: H5RAwrite
Signature: -
H5RAwrite( , - , - +
herr_t H5RAwrite(hid_t array_id, + hssize_t start_row, + hsize_t nrows, + hid_t type_id, + hsize_t size[/*nrows*/], + void *buf[/*nrows*/] )
Purpose: -
+
Writes to a ragged array.
Description: -
H5RAwrite +
H5RAwrite writes a contiguous set of rows to a + ragged array beginning at row number start_row + and continuing for nrows rows. +
+ Each row of the ragged array contains size[] + elements of type type_id and each row is stored + in a buffer pointed to by buf[].
Datatype conversion takes place at the time of a read or write and is automatic. See the @@ -169,16 +215,22 @@ These functions enable the user to store and retrieve data in ragged arrays. supported by the HDF5 libraries.
Parameters:
-
-
-
-
-
-
+
hid_t array_id +
Array identifier for the ragged array to be written to. +
hssize_t start_row +
Row at which the write will start. +
hsize_t nrows +
Number of rows to be written +
hid_t type_id +
Data type identifier for the data to be written. +
hsize_t size[/*nrows*/] +
Lengths of the rows to be written. +
void *buf[/*nrows*/] +
Pointers to buffers containing the data to be written.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value.
@@ -186,14 +238,36 @@ These functions enable the user to store and retrieve data in ragged arrays.

Name: H5RAread
Signature: -
H5RAread( , - , - +
herr_t H5RAread(hid_t array_id, + hssize_t start_row, + hsize_t nrows, + hid_t type_id, + hsize_t size[/*nrows*/], + void *buf[/*nrows*/] )
Purpose:

Description: -
H5RAread +
H5RAread reads the contents of one or more rows + of the ragged array pointed to by array_id. +
+ The rows to be read begin at row start_row and + continue for nrows rows. +
+ All raw data is converted to type type_id. +
+ The caller must allocate the size[] and + buf[] arrays. +
+ Memory for the data can be allocated by either the caller or + the library. In the former case, the caller should initialize + the buf[] array with pointers to valid memory and + the size[] array with the lengths of the buffers. + In the latter case, the caller should initialize + buf[] with null pointers (the input value of + size[] is irrelevant in this case) and the + library will allocate memory for each row by calling + malloc().
Datatype conversion takes place at the time of a read or write and is automatic. See the @@ -204,16 +278,31 @@ These functions enable the user to store and retrieve data in ragged arrays. supported by the HDF5 libraries.
Parameters:
-
-
-
-
-
-
+
hid_t array_id +
Array identifier for the ragged array to be read from. +
hssize_t start_row +
Row at which the read will start. +
hsize_t nrows +
Number of rows to be read +
hid_t type_id +
Data type identifier for the data to be read. +
hsize_t size[/*nrows*/] +
Lengths of the rows to be read. +
void *buf[/*nrows*/] +
Pointers to buffers into which the data is to be read.

Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful. + The values of the size[] array will be the + true length of each row. If a row is longer than the + caller-allocated length, then size[] will + contain the true length of the row although not all elements + of that row will be stored in the buffer. +
+ Returns a negative value on failure. The buf[] + array will contain it's original pointers (null or otherwise), + although the caller-supplied buffers may have been modified. + The size[] array may also have been modified.
@@ -226,7 +315,9 @@ These functions enable the user to store and retrieve data in ragged arrays. H5E   H5F   H5G   +H5I   H5P   +H5R   H5RA   H5S   H5T   @@ -242,7 +333,7 @@ H5RA   HDF Help Desk
-Last modified: 1 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5S.html b/doc/html/RM_H5S.html index d0ed17a..5d34684 100644 --- a/doc/html/RM_H5S.html +++ b/doc/html/RM_H5S.html @@ -14,7 +14,10 @@ HDF5/H5S Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -117,7 +120,7 @@ of the HDF5 User's Guide..
Returns:
Returns a dataspace identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -156,7 +159,7 @@ of the HDF5 User's Guide..
Returns:
Returns a dataspace identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -180,7 +183,7 @@ of the HDF5 User's Guide..
Returns:
Returns a dataspace identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -229,8 +232,8 @@ of the HDF5 User's Guide.. elements being selected.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -256,8 +259,8 @@ of the HDF5 User's Guide.. selection is being made.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -278,8 +281,8 @@ of the HDF5 User's Guide.. selection is being reset.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -303,7 +306,7 @@ of the HDF5 User's Guide..
Returns:
Returns TRUE if the selection is contained within the extent and FALSE if it is not. - Returns FAIL (-1) on error conditions + Returns returns a negative value on error conditions such as the selection or extent not being defined. @@ -334,7 +337,7 @@ of the HDF5 User's Guide..

Name: H5Sget_select_npoints
Signature: -
hsize_t H5Sget_select_npoints(hid_t space_id) +
hssize_t H5Sget_select_npoints(hid_t space_id)
Purpose:
Determines the number of elements in a dataspace.
Description: @@ -347,7 +350,7 @@ of the HDF5 User's Guide..

Returns:
Returns the number of elements in the selection if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -368,7 +371,7 @@ of the HDF5 User's Guide..
Returns:
Returns the number of dimensions in the dataspace if successful; - otherwise FAIL (-1) + otherwise returns a negative value. @@ -397,7 +400,7 @@ of the HDF5 User's Guide..
Returns:
Returns the number of dimensions in the dataspace if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -467,7 +470,7 @@ of the HDF5 User's Guide..
Returns:
Returns a dataspace identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -489,7 +492,7 @@ of the HDF5 User's Guide..
Returns:
Returns TRUE or FALSE if Successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -521,8 +524,8 @@ of the HDF5 User's Guide..
IN: The offset at which to position the selection.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -574,8 +577,8 @@ of the HDF5 User's Guide.. the extent is copied.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -596,8 +599,8 @@ of the HDF5 User's Guide.. the extent is to be removed.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -690,8 +693,8 @@ I/O is performed.
IN: Size of block in hyperslab.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -714,8 +717,8 @@ I/O is performed.
Identifier of dataspace to release.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -728,7 +731,10 @@ I/O is performed. H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -743,7 +749,7 @@ H5S   HDF Help Desk
-Last modified: 1 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5T.html b/doc/html/RM_H5T.html index 086b9cc..672ec32 100644 --- a/doc/html/RM_H5T.html +++ b/doc/html/RM_H5T.html @@ -14,7 +14,10 @@ HDF5/H5T Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -151,7 +154,7 @@ in the HDF5 User's Guide for further information, including a compl
Returns:
Returns a named datatype identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -181,8 +184,8 @@ in the HDF5 User's Guide for further information, including a compl
A datatype identifier.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -208,7 +211,7 @@ in the HDF5 User's Guide for further information, including a compl
Returns:
The successful return values are TRUE if committed, else FALSE. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -256,8 +259,8 @@ in the HDF5 User's Guide for further information, including a compl
Identifier of the datatype of the new member.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -334,8 +337,8 @@ in the HDF5 User's Guide for further information, including a compl
Optional background buffer.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -367,8 +370,8 @@ in the HDF5 User's Guide for further information, including a compl
Overflow function.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -424,7 +427,7 @@ H5Tget_overflow ()
Returns:
Returns datatype identifier if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -511,7 +514,7 @@ H5Tget_overflow ()
Returns:
Returns a datatype identifier if successful; - otherwise FAIL (-1) + otherwise returns a negative value @@ -537,7 +540,7 @@ H5Tget_overflow ()
Returns:
When successful, returns TRUE if the datatype identifiers refer to the same datatype, else FALSE. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -562,8 +565,8 @@ H5Tget_overflow ()
Identifier of datatype to lock.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -647,8 +650,8 @@ H5Tget_overflow ()
Size in bytes to modify datatype.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -712,8 +715,8 @@ H5Tget_overflow ()
Byte ordering constant.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -769,8 +772,8 @@ H5Tget_overflow ()
Number of bits of precision for datatype.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -913,8 +916,8 @@ zero.
Offset of first significant bit.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -951,8 +954,8 @@ zero. bit padding type.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -986,8 +989,8 @@ zero.
Padding type for most-significant bits.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1044,8 +1047,8 @@ zero.
Sign type.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1081,8 +1084,8 @@ zero.
OUT: Pointer to location to return size of mantissa in bits.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1120,8 +1123,8 @@ zero.
Size of mantissa in bits.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1165,8 +1168,8 @@ zero.
Exponent bias value.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1228,8 +1231,8 @@ zero.
Mantissa normalization type.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1295,8 +1298,8 @@ zero.
Padding type.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1353,8 +1356,8 @@ zero.
Character set type.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1415,8 +1418,8 @@ zero.
String padding type.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1437,7 +1440,7 @@ zero.
Returns:
Returns number of members datatype has if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -1503,7 +1506,7 @@ zero.
Returns:
Returns the number of dimensions, a number from 0 to 4, if successful. - Otherwise returns FAIL (-1). + Otherwise returns a negative value. @@ -1529,7 +1532,7 @@ zero.
Returns:
Returns the identifier of a copy of the datatype of the field if successful; - otherwise FAIL (-1). + otherwise returns a negative value. @@ -1567,8 +1570,8 @@ zero.
Datatype identifier of the field to insert.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1589,8 +1592,8 @@ zero.
Identifier of datatype to modify.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1638,8 +1641,8 @@ zero.
Function to convert between source and destination datatypes.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1681,8 +1684,8 @@ zero.
Function to convert between source and destination datatypes.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1711,8 +1714,8 @@ zero.
Function to remove from conversion paths.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1734,8 +1737,8 @@ zero.
Identifier of datatype to release.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -1748,7 +1751,10 @@ zero. H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -1763,7 +1769,7 @@ H5T   HDF Help Desk
-Last modified: 2 September 1998 +Last modified: 27 October 1998 diff --git a/doc/html/RM_H5Z.html b/doc/html/RM_H5Z.html index 5cdc5c8..337552e 100644 --- a/doc/html/RM_H5Z.html +++ b/doc/html/RM_H5Z.html @@ -14,7 +14,10 @@ HDF5/H5Z Draft API Specification H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -94,8 +97,8 @@ See Compression in the
Uncompression method.
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). +
Returns a non-negative value if successful; + otherwise returns a negative value. @@ -108,7 +111,10 @@ See Compression in the H5E   H5F   H5G   +H5I   H5P   +H5R   +H5RA   H5S   H5T   H5Z   @@ -123,7 +129,7 @@ H5Z   HDF Help Desk
-Last modified: 14 July 1998 +Last modified: 27 October 1998 diff --git a/doc/html/Ragged.html b/doc/html/Ragged.html index 42e6e0d..fa3b61e 100644 --- a/doc/html/Ragged.html +++ b/doc/html/Ragged.html @@ -157,7 +157,7 @@ Last modified: Fri Aug 28 14:27:19 EDT 1998 HDF Help Desk -Last modified: 8 September 1998 +Last modified: 21 October 1998 diff --git a/doc/html/Tools.html b/doc/html/Tools.html index bf44249..06aa2b7 100644 --- a/doc/html/Tools.html +++ b/doc/html/Tools.html @@ -14,10 +14,10 @@ HDF5/Tools Draft API Specification H5E   H5F   H5G   +H5I   H5P   - H5S   H5T   H5Z   @@ -64,40 +64,56 @@ These tools enable the user to examine HDF5 files interactively. [-a names] [-dnames] [-gnames] - [-lnames] + [-l names] + [-tnames] file
Purpose:
Displays HDF5 file contents.
Description:
h5dump enables the user to interactively examine the contents of an HDF5 file and dump those contents, - in human readable form, to an ASCII file or to other tools. + in human readable form, to an ASCII file.
h5dump displays HDF5 file content on standard output. It may display the content of the whole HDF5 file or selected objects, which can be groups, - datasets, links, or attributes. + datasets, links, attributes, or data types.
The -header option displays object - header information only and must appear before the - -a, -d, -g, or - -l options. + header information only. +
+ Names are the absolute names of the objects. + h5dump displays objects in the order same as the + command order. If a name does not start with a slash, + h5dump begins searching for the specified object + starting at the root group.
- Native data types created in one machine are displayed with native - names when h5dump runs in the same machine type. But when - h5dump runs in a different machine type, it displays the - native data types with standard type names. This will be changed in the - next release to always display with standard type names. + If an object is hard linked with multiple names, + h5dump displays the content of the object in the + first occurrence. Only the link information is displayed in + later occurrences.
- The h5dump output is described in detail in - DDL, the Data Description - Language document. + h5dump assigns a name for any unnamed data type in + the form of #oid1:oid2, + where oid1 and oid2 are the object identifiers + assigned by the library. The unnamed types are displayed within + the root group. +
+ Data types are displayed with standard type names. For example, + if a data set is created with H5T_NATIVE_INT type + and the standard type name for integer on that machine is + H5T_STD_I32BE, h5dump displays + H5T_STD_I32BE as the type of the data set. +
+ The h5dump output is described in detail in the + DDL for HDF5, the + Data Description Language document.
Options and Parameters:

-h -
Print information on this command. +
Prints information on this command.
-bb -
Displays the content of boot block. The default is +
Displays the contents of the boot block. The default is not to display.
-header
Displays header information only; no data is displayed. @@ -106,35 +122,44 @@ These tools enable the user to examine HDF5 files interactively.
-d names
Displays the specified dataset(s).
-g names -
Displays all the objects within the specified group(s). +
Displays the specified group(s) and all the members.
-l names -
Displays the specified link value(s). +
Displays the values of the specified soft link(s). +
-t names +
Displays the specified named data type(s).
file
The file to be examined.

Current Status: -
The current version of h5dump can display the - following types of information: +
The current version of h5dump displays the + following information: +
+
Group
-
Group name -
Attribute name, data type, data space, and data -
Dataset name, data type, data space, and data -
Soft link name, link value +
group attributes +
group member
- -
Limitions in the current implementaion include the - following: +
Dataset +
+
dataset attributes +
data type +
data space +
data +
+
Data type
-
Only one file is displayed at a time (file families are - not supported). -
The whole file content is displayed (none of above - options are supported). -
Compound data types are not yet supported. -
Complex data spaces are not yet supported. +
scalar type +
transient type +
named type +
unnamed type +
+
Simple data space +
Soft link +
Hard link

See Also:
HDF5 Data Description Language syntax - (DDL) + (DDL for HDF5) @@ -241,10 +266,10 @@ These tools enable the user to examine HDF5 files interactively. H5E   H5F   H5G   +H5I   H5P   - H5S   H5T   H5Z   @@ -259,7 +284,7 @@ Tools   HDF Help Desk
-Last modified: 9 September 1998 +Last modified: 27 October 1998 -- cgit v0.12

Example	Corresponding C Type
- H5T_NATIVE_CHAR	- signed char
- H5T_NATIVE_UCHAR	- unsigned char
- H5T_NATIVE_SHORT	- short
- H5T_NATIVE_USHORT	- unsigned short
- H5T_NATIVE_INT	- int
- H5T_NATIVE_UINT	- unsigned
- H5T_NATIVE_LONG	- long
- H5T_NATIVE_ULONG	- unsigned long
- H5T_NATIVE_LLONG	- long long
- H5T_NATIVE_ULLONG	- unsigned long long
- H5T_NATIVE_FLOAT	- float
- H5T_NATIVE_DOUBLE	- double
- H5T_NATIVE_LDOUBLE	- long double
- `H5T_NATIVE_HSIZE`	- `hsize_t`
- `H5T_NATIVE_HSSIZE`	- `hssize_t`
- `H5T_NATIVE_HERR`	- `herr_t`
- `H5T_NATIVE_HBOOL`	- `hbool_t`

Dataset Chunking Pitfalls

Dataset Chunking Issues

Table of Contents

5. Predefined Atomic Data Types

4. File Property Lists

4. Current Working Group

5. Objects with Multiple Names

4. Objects with Multiple Names

6. Comments

5. Comments

Introduction to HDF5 1.0 Beta

Introduction to HDF5 Release 1.0

Example 1: How to create a homogeneous multi-dimensional dataset and write it to a file.

Example 1: How to create a homogeneous multi-dimensional dataset and write it to a file.

Example 7. Creating groups.

Group Object API Functions