diff options
author | Robb Matzke <matzke@llnl.gov> | 1998-09-08 19:15:44 (GMT) |
---|---|---|
committer | Robb Matzke <matzke@llnl.gov> | 1998-09-08 19:15:44 (GMT) |
commit | b5e2752ad6d942a5dcee5f9fd4fad0a2e89c4a67 (patch) | |
tree | 790770464529c19e146112e5b48c77218132d8b7 /doc/html | |
parent | 72a58073cd51996f34906f992a2377073df5bbc0 (diff) | |
download | hdf5-b5e2752ad6d942a5dcee5f9fd4fad0a2e89c4a67.zip hdf5-b5e2752ad6d942a5dcee5f9fd4fad0a2e89c4a67.tar.gz hdf5-b5e2752ad6d942a5dcee5f9fd4fad0a2e89c4a67.tar.bz2 |
[svn-r673] Changes since 19980908
----------------------
./COPYING
Reformatted as text instead of C. Removed zlib crew from the
list of contributors since no zlib code is actually in the
hdf5 library.
./INSTALL
./INSTALL.ascired
./MANIFEST
Minor updates for Beta release including version number
change.
./INSTALL_MAINT
Added information about making a release.
./RELEASE
Updated function list based on public header files.
./bin/checkposix
Got rid of complaints about some obvious things.
./doc/html/H5.api.html
./doc/html/RM_H5F.html
./src/H5F.c
./src/H5Fpublic.h
./test/tfile.c
Changed H5Fget_create_template() and H5Fget_access_template()
to H5Fget_create_plist() and H5Fget_access_plist() since that
conforms better to lots of other names.
./doc/html/Datatypes.html
./doc/html/ExternalFiles.html
./doc/html/Files.html
./doc/html/H5.api.html
./doc/html/H5.sample_code.html
./doc/html/RM_H5F.html
./doc/html/RM_H5Front.html
Changed `template' to `property list', etc.
./doc/html/Ragged.html [NEW]
Documentation for ragged arrays.
./src/H5Iprivate.h
./src/H5Ipublic.h
./src/H5I.c
Changed the scope of some symbols to be more local.
./src/H5.c
./src/H5AC.c
./src/H5D.c
./src/H5E.c
./src/H5F.c
./src/H5Ffamily.c
./src/H5Fistore.c
./src/H5Flow.c
./src/H5Fsec2.c
./src/H5Fsplit.c
./src/H5Fstdio.c
./src/H5G.c
./src/H5Gnode.c
./src/H5HG.c
./src/H5I.c
./src/H5O.c
./src/H5Ocomp.c
./src/H5Odtype.c
./src/H5Oefl.c
./src/H5Omtime.c
./src/H5Oname.c
./src/H5P.c
./src/H5S.c
./src/H5Shyper.c
./src/H5Tbit.c
./src/H5Tconv.c
./src/H5V.c
./src/H5Z.c
./src/H5private.h
Fixed some violations of our naming scheme by adding HD to the
beginning of all Posix functions.
Diffstat (limited to 'doc/html')
-rw-r--r-- | doc/html/Datatypes.html | 4 | ||||
-rw-r--r-- | doc/html/ExternalFiles.html | 26 | ||||
-rw-r--r-- | doc/html/Files.html | 26 | ||||
-rw-r--r-- | doc/html/H5.api.html | 486 | ||||
-rw-r--r-- | doc/html/H5.sample_code.html | 2 | ||||
-rw-r--r-- | doc/html/RM_H5F.html | 26 | ||||
-rw-r--r-- | doc/html/RM_H5Front.html | 2 | ||||
-rw-r--r-- | doc/html/Ragged.html | 138 |
8 files changed, 430 insertions, 280 deletions
diff --git a/doc/html/Datatypes.html b/doc/html/Datatypes.html index 50e0ab7..4c57359 100644 --- a/doc/html/Datatypes.html +++ b/doc/html/Datatypes.html @@ -1157,7 +1157,7 @@ typedef herr_t (*H5T_conv_t)(hid_t <em>src_type</em>, initialized. This is useful for those functions requiring some extra buffer space as the buffer can probably be allocated more efficiently by the library (the application can supply - the buffer as part of the dataset transfer template). + the buffer as part of the dataset transfer property list). <br><br> <dt><code>H5T_BKG_YES</code> @@ -1388,7 +1388,7 @@ H5Tregister_soft ("cus2be", H5T_INTEGER, H5T_INTEGER, cray_ushort2be); <address><a href="mailto:koziol@ncsa.uiuc.edu">Quincey Koziol</a></address> <!-- Created: Thu Dec 4 14:57:32 EST 1997 --> <!-- hhmts start --> -Last modified: Fri Aug 7 10:24:52 EDT 1998 +Last modified: Tue Sep 8 14:43:32 EDT 1998 <!-- hhmts end --> </body> </html> diff --git a/doc/html/ExternalFiles.html b/doc/html/ExternalFiles.html index 39ebd2b..91b72c7 100644 --- a/doc/html/ExternalFiles.html +++ b/doc/html/ExternalFiles.html @@ -110,16 +110,16 @@ Currently, the default low-level file driver is used for all family members (H5F_LOW_DFLT, usually set to be Section 2 I/O or Section 3 stdio), but we'll probably eventually want to pass - that as a parameter of the file access template, which hasn't - been implemented yet. When creating a family, a default family - member size is used (defined at the top H5Ffamily.c, currently - 64MB) but that also should be settable in the file access - template. When opening an existing family, the size of the first - member is used to determine the member size (flushing/closing a - family ensures that the first member is the correct size) but - the other family members don't have to be that large (the local - address space, however, is logically the same size for all - members). + that as a parameter of the file access property list, which + hasn't been implemented yet. When creating a family, a default + family member size is used (defined at the top H5Ffamily.c, + currently 64MB) but that also should be settable in the file + access property list. When opening an existing family, the size + of the first member is used to determine the member size + (flushing/closing a family ensures that the first member is the + correct size) but the other family members don't have to be that + large (the local address space, however, is logically the same + size for all members). <p>I haven't implemented a split meta/raw family yet but am rather curious to see how it would perform. I was planning to use the @@ -130,7 +130,7 @@ then we'll chose the split family and use the default low level driver for each of the two family members. Eventually we'll want to pass these kinds of things through the file access - template instead of relying on naming convention. + property list instead of relying on naming convention. <h3>External Raw Data</h3> @@ -199,7 +199,7 @@ struct H5F_mount_t { <p>The <code>H5Fmount</code> function takes the ID of an open file, the name of a to-be-mounted file, the name of the mount - point, and a file access template (like <code>H5Fopen</code>). + point, and a file access property list (like <code>H5Fopen</code>). It opens the new file and adds a record to the parent's mount table. The <code>H5Funmount</code> function takes the parent file ID and the name of the mount point and closes the file @@ -272,7 +272,7 @@ struct H5F_mount_t { <address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address> <!-- Created: Sat Nov 8 18:08:52 EST 1997 --> <!-- hhmts start --> -Last modified: Wed Nov 12 15:01:14 EST 1997 +Last modified: Tue Sep 8 14:43:32 EDT 1998 <!-- hhmts end --> </body> </html> diff --git a/doc/html/Files.html b/doc/html/Files.html index d620b75..36512f7 100644 --- a/doc/html/Files.html +++ b/doc/html/Files.html @@ -61,7 +61,7 @@ set. The <em>access_properties</em> is a file access property list ID or <code>H5P_DEFAULT</code> for the default I/O access parameters. Creating and changing the parameters for access - templates is documented further below. Files which are opened + property lists is documented further below. Files which are opened more than once return a unique identifier for each <code>H5Fopen()</code> call and can be accessed through all file IDs. The return value is an ID for the open file and it @@ -200,40 +200,40 @@ an address which is a multiple of some number. </dl> </ul> - <h2>5. Examples of using file templates</h2> + <h2>5. Examples of using file property lists</h2> - <h3>5.1. Example of using file creation templates</h3> + <h3>5.1. Example of using file creation property lists</h3> <p>This following example shows how to create a file with 64-bit object offsets and lengths:<br> <pre> - hid_t create_template; + hid_t create_plist; hid_t file_id; - create_template = H5Pcreate(H5P_FILE_CREATE); - H5Pset_sizes(create_template, 8, 8); + create_plist = H5Pcreate(H5P_FILE_CREATE); + H5Pset_sizes(create_plist, 8, 8); file_id = H5Fcreate("test.h5", H5F_ACC_TRUNC, - create_template, H5P_DEFAULT); + create_plist, H5P_DEFAULT); . . . H5Fclose(file_id); </pre> - <h3>5.2. Example of using file creation templates</h3> + <h3>5.2. Example of using file creation plist</h3> <p>This following example shows how to open an existing file for independent datasets access by MPI parallel I/O:<br> <pre> - hid_t access_template; + hid_t access_plist; hid_t file_id; - access_template = H5Pcreate(H5P_FILE_ACCESS); - H5Pset_mpi(access_template, MPI_COMM_WORLD, MPI_INFO_NULL); + access_plist = H5Pcreate(H5P_FILE_ACCESS); + H5Pset_mpi(access_plist, MPI_COMM_WORLD, MPI_INFO_NULL); /* H5Fopen must be called collectively */ - file_id = H5Fopen("test.h5", H5F_ACC_RDWR, access_template); + file_id = H5Fopen("test.h5", H5F_ACC_RDWR, access_plist); . . . @@ -532,7 +532,7 @@ <address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address> <!-- Created: Tue Jan 27 09:11:27 EST 1998 --> <!-- hhmts start --> -Last modified: Thu Aug 6 16:17:08 EDT 1998 +Last modified: Tue Sep 8 14:43:31 EDT 1998 <!-- hhmts end --> </body> </html> diff --git a/doc/html/H5.api.html b/doc/html/H5.api.html index b2402a5..5f3cf78 100644 --- a/doc/html/H5.api.html +++ b/doc/html/H5.api.html @@ -19,33 +19,33 @@ HDF5 Draft API Specification <li><a href="#File-Open">H5Fopen</a> <li><a href="#File-Create">H5Fcreate</a> <li><a href="#File-IsHDF5">H5Fis_hdf5</a> - <li><a href="#File-GetCreateTemplate">H5Fget_create_template</a> + <li><a href="#File-GetCreatePlist">H5Fget_create_plist</a> <li><a href="#File-Close">H5Fclose</a> </ol> -<li><a href="#Template">Template</a> - H5P<name> - API for manipulating object templates +<li><a href="#Plist">Property list</a> - H5P<name> - API for manipulating object property lists <ol type=A> - <li><a href="#Template-Create">H5Pcreate</a> - <li><a href="#Template-GetClass">H5Pget_class</a> - <li><a href="#Template-Copy">H5Pcopy</a> - <li><a href="#Template-Close">H5Pclose</a> - <li><a href="#Template-GetVersion">H5Pget_version</a> - <li><a href="#Template-SetUserblock">H5Pset_userblock</a> - <li><a href="#Template-GetUserblock">H5Pget_userblock</a> - <li><a href="#Template-SetSizes">H5Pset_sizes</a> - <li><a href="#Template-GetSizes">H5Pget_sizes</a> - <li><a href="#Template-SetMPI">H5Pset_mpi</a> - <li><a href="#Template-GetMPI">H5Pget_mpi</a> - <li><a href="#Template-SetXfer">H5Pset_xfer</a> - <li><a href="#Template-GetXfer">H5Pget_xfer</a> - <li><a href="#Template-SetSymK">H5Pset_sym_k</a> - <li><a href="#Template-GetSymK">H5Pget_sym_k</a> - <li><a href="#Template-SetIstoreK">H5Pset_istore_k</a> - <li><a href="#Template-GetIstoreK">H5Pget_istore_k</a> - <li><a href="#Template-SetLayout">H5Pset_layout</a> - <li><a href="#Template-GetLayout">H5Pget_layout</a> - <li><a href="#Template-SetChunk">H5Pset_chunk</a> - <li><a href="#Template-GetChunk">H5Pget_chunk</a> + <li><a href="#Plist-Create">H5Pcreate</a> + <li><a href="#Plist-GetClass">H5Pget_class</a> + <li><a href="#Plist-Copy">H5Pcopy</a> + <li><a href="#Plist-Close">H5Pclose</a> + <li><a href="#Plist-GetVersion">H5Pget_version</a> + <li><a href="#Plist-SetUserblock">H5Pset_userblock</a> + <li><a href="#Plist-GetUserblock">H5Pget_userblock</a> + <li><a href="#Plist-SetSizes">H5Pset_sizes</a> + <li><a href="#Plist-GetSizes">H5Pget_sizes</a> + <li><a href="#Plist-SetMPI">H5Pset_mpi</a> + <li><a href="#Plist-GetMPI">H5Pget_mpi</a> + <li><a href="#Plist-SetXfer">H5Pset_xfer</a> + <li><a href="#Plist-GetXfer">H5Pget_xfer</a> + <li><a href="#Plist-SetSymK">H5Pset_sym_k</a> + <li><a href="#Plist-GetSymK">H5Pget_sym_k</a> + <li><a href="#Plist-SetIstoreK">H5Pset_istore_k</a> + <li><a href="#Plist-GetIstoreK">H5Pget_istore_k</a> + <li><a href="#Plist-SetLayout">H5Pset_layout</a> + <li><a href="#Plist-GetLayout">H5Pget_layout</a> + <li><a href="#Plist-SetChunk">H5Pset_chunk</a> + <li><a href="#Plist-GetChunk">H5Pget_chunk</a> </ol> <!-- @@ -253,19 +253,20 @@ documented below. <dt><strong>Signature:</strong> <dd><em>hid_t </em><code>H5Fopen</code>(<em>const char *</em><code>name</code>, <em>uintn</em> <code>flags</code>, - <em>hid_t</em> <code>access_template</code> + <em>hid_t</em> <code>access_plist</code> ) <dt><strong>Description:</strong> <dd>This is the primary function for opening existing HDF5 files. - The <code>flags</code> parameter determines the file access mode. - There is no read flag, all open files are implicitily opened for - read access. - All flags may be combined with the '|' (boolean OR operator) to - change the behavior of the file open call. - The <code>access_template</code> parameter is a template containing - additional information required for specific methods of access, - parallel I/O for example. The paramters for access templates are - described in the H5P API documentation. + The <code>flags</code> parameter determines the file + access mode. There is no read flag, all open files are + implicitily opened for read access. All flags may be + combined with the '|' (boolean OR operator) to change the + behavior of the file open call. The + <code>access_plist</code> parameter is a property list + containing additional information required for specific + methods of access, parallel I/O for example. The + paramters for access property lists are described in the + H5P API documentation. <dt><strong>Parameters:</strong> <dl> <dt><em>const char *</em><code>name</code> @@ -276,11 +277,11 @@ documented below. <dt>H5F_ACC_RDWR <dd>Allow read and write access to file. </dl></ul> - <dt><em>hid_t</em><code>access_template</code> - <dd>Template indicating the file access properties. + <dt><em>hid_t</em><code>access_plist</code> + <dd>Property list indicating the file access properties. If parallel file access is desired, this is a collective call according to the communicator stored in the - access_template. Use 0 for default access template. + access_plist. Use 0 for default access properties. </dl> <dt><strong>Returns:</strong> <dd>An ID (of type <em>hid_t</em>) for the file upon success, @@ -293,22 +294,23 @@ documented below. <dt><strong>Signature:</strong> <dd><em>hid_t </em><code>H5Fcreate</code>(<em>const char *</em><code>name</code>, <em>uintn</em> <code>flags</code>, - <em>hid_t</em> <code>create_template</code>, - <em>hid_t</em> <code>access_template</code> + <em>hid_t</em> <code>create_plist</code>, + <em>hid_t</em> <code>access_plist</code> ) <dt><strong>Description:</strong> <dd>This is the primary function for opening and creating HDF5 files. - The <code>flags</code> parameter determines whether an existing - file will be overwritten or not. All newly created files are opened - for both reading and writing. - All flags may be combined with the '|' (boolean OR operator) to - change the behavior of the file open call. - The <code>create_template</code> and <code>access_template</code> - parameters are templates containing additional information required - for specific methods of access or particular aspects of the file - to set when creating a file. - The parameters for creation and access templates are - described in the H5P API documentation. + The <code>flags</code> parameter determines whether an + existing file will be overwritten or not. All newly + created files are opened for both reading and writing. + All flags may be combined with the '|' (boolean OR + operator) to change the behavior of the file open call. + The <code>create_plist</code> and + <code>access_plist</code> parameters are property lists + containing additional information required for specific + methods of access or particular aspects of the file to set + when creating a file. The parameters for creation and + access property lists are described in the H5P API + documentation. <dt><strong>Parameters:</strong> <dl> <dt><em>const char *</em><code>name</code> @@ -321,13 +323,14 @@ documented below. be truncated, erasing all data previously stored in the file. </dl></ul> - <dt><em>hid_t</em><code>create_template</code> - <dd>File creation template ID, used when modifying default file meta-data - <dt><em>hid_t</em><code>access_template</code> - <dd>Template indicating the file access properties. + <dt><em>hid_t</em><code>create_plist</code> + <dd>File creation property list ID, used when modifying + default file meta-data. + <dt><em>hid_t</em><code>access_plist</code> + <dd>Property list indicating the file access properties. If parallel file access is desired, this is a collective call according to the communicator stored in the - access_template. Use 0 for default access template. + access_plist. Use 0 for default access properties. </dl> <dt><strong>Returns:</strong> <dd>An ID (of type <em>hid_t</em>) for the file upon success, @@ -353,18 +356,18 @@ documented below. <hr> <dl> -<dt><strong>Name:</strong> <a name="File-GetCreateTemplate">H5Fget_create_template</a> +<dt><strong>Name:</strong> <a name="File-GetCreatePlist">H5Fget_create_plist</a> <dt><strong>Signature:</strong> - <dd><em>hid_t </em><code>H5Fget_create_template</code>(<em>hid_t</em> <code>file_id</code> + <dd><em>hid_t </em><code>H5Fget_create_plist</code>(<em>hid_t</em> <code>file_id</code> ) <dt><strong>Description:</strong> - <dd>This function returns an template ID with a copy of the parameters - used to create this file. Useful for duplicating the parameters - when creating another file. + <dd>This function returns a property list ID with a copy of + the parameters used to create this file. Useful for + duplicating the parameters when creating another file. <dt><strong>Parameters:</strong> <dl> <dt><em>hid_t</em> <code>file_id</code> - <dd>File ID to get creation template of + <dd>File ID for which to get creation property list. </dl> <dt><strong>Returns:</strong> <dd>zero/negative @@ -390,24 +393,24 @@ documented below. </dl> <hr> -<h2><a name="Template">Template API Functions</a></h2> -<P>These functions manipulate template objects to allow objects which require +<h2><a name="Plist">Property List API Functions</a></h2> +<P>These functions manipulate property lists to allow objects which require many different parameters to be easily manipulated. <br> <br> <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-Create">H5Pcreate</a> +<dt><strong>Name:</strong> <a name="Plist-Create">H5Pcreate</a> <dt><strong>Signature:</strong> <dd><em>hid_t </em><code>H5Pcreate</code>(<em>H5P_class_t</em> <code>type</code> ) <dt><strong>Description:</strong> - <dd>This function returns a template ID for a copy of the default - template of a given type. + <dd>This function returns a property list ID for a copy of the default + property list of a given type. <br> <dl> - <dt>Template Types and Uses: + <dt>Property List Types and Uses: <ul><dl> <dt>H5P_FILE_CREATE <dd>Used to set the metadata information about a file during @@ -425,7 +428,7 @@ many different parameters to be easily manipulated. <dt><strong>Parameters:</strong> <dl> <dt><em>H5P_class_t</em> <code>type</code> - <dd>The type of template to create. + <dd>The type of property list to create. </dl> <dt><strong>Returns:</strong> <dd>Valid ID on success, negative on failure @@ -433,16 +436,16 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-Close">H5Pclose</a> +<dt><strong>Name:</strong> <a name="Plist-Close">H5Pclose</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pclose</code>(<em>hid_t</em> <code>template_id</code> + <dd><em>herr_t </em><code>H5Pclose</code>(<em>hid_t</em> <code>plist_id</code> ) <dt><strong>Description:</strong> - <dd>This function terminates access to a template. + <dd>This function terminates access to a property list. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to terminate access to. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to terminate access to. </dl> <dt><strong>Returns:</strong> <dd>zero/negative @@ -450,43 +453,43 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetClass">H5Pget_class</a> +<dt><strong>Name:</strong> <a name="Plist-GetClass">H5Pget_class</a> <dt><strong>Signature:</strong> - <dd><em>H5P_class_t </em><code>H5Pget_class</code>(<em>hid_t</em> <code>template_id</code> + <dd><em>H5P_class_t </em><code>H5Pget_class</code>(<em>hid_t</em> <code>plist_id</code> ) <dt><strong>Description:</strong> - <dd>This function queries the class of a template ID. + <dd>This function queries the class of a property list ID. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. </dl> <dt><strong>Returns:</strong> - <dd>Template class code on success, negative on failure + <dd>Property list class code on success, negative on failure </dl> <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-Copy">H5Pcopy</a> +<dt><strong>Name:</strong> <a name="Plist-Copy">H5Pcopy</a> <dt><strong>Signature:</strong> - <dd><em>hid_t </em><code>H5Pcopy</code>(<em>hid_t</em> <code>template_id</code> + <dd><em>hid_t </em><code>H5Pcopy</code>(<em>hid_t</em> <code>plist_id</code> ) <dt><strong>Description:</strong> - <dd>This function makes a copy of a template ID. + <dd>This function makes a copy of a property list ID. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to duplicate. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to duplicate. </dl> <dt><strong>Returns:</strong> - <dd>Template ID on success, negative on failure + <dd>Property list ID on success, negative on failure </dl> <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetVersion">H5Pget_version</a> +<dt><strong>Name:</strong> <a name="Plist-GetVersion">H5Pget_version</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_version</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_version</code>(<em>hid_t</em> <code>plist_id</code>, <em>int *</em> <code>boot</code>, <em>int *</em> <code>freelist</code>, <em>int *</em> <code>stab</code>, @@ -494,12 +497,12 @@ many different parameters to be easily manipulated. ) <dt><strong>Description:</strong> <dd>This function queries the version information of various objects - for a file creation template. Any pointer parameters which are - passed as NULL are not queried. + for a file creation property list. Any pointer parameters + which are passed as NULL are not queried. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>int *</em> <code>boot</code> <dd>Pointer to location to return boot block version number. <dt><em>int *</em> <code>freelist</code> @@ -515,21 +518,21 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetUserblock">H5Pset_userblock</a> +<dt><strong>Name:</strong> <a name="Plist-SetUserblock">H5Pset_userblock</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pset_userblock</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pset_userblock</code>(<em>hid_t</em> <code>plist_id</code>, <em>hsize_t</em> <code>size</code> ) <dt><strong>Description:</strong> <dd>This function sets the size of the user-block located at the beginning of an HDF5 file. This function is only valid for - file creation templates. The default user-block size is 0. + file creation property lists. The default user-block size is 0. Only values which are powers of 2 larger equal to 512 or larger may be used as a valid user-block size. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template to modify. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list to modify. <dt><em>hsize_t</em> <code>size</code> <dd>Size of the user-block in bytes. </dl> @@ -539,19 +542,19 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetUserblock">H5Pget_userblock</a> +<dt><strong>Name:</strong> <a name="Plist-GetUserblock">H5Pget_userblock</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_userblock</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_userblock</code>(<em>hid_t</em> <code>plist_id</code>, <em>hsize_t *</em> <code>size</code> ) <dt><strong>Description:</strong> <dd>This function retrieves the size of the user-block located at the beginning of an HDF5 file. This function is only valid for - file creation templates. + file creation property lists. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>hsize_t *</em> <code>size</code> <dd>Pointer to location to return user-block size. </dl> @@ -561,23 +564,23 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetSizes">H5Pset_sizes</a> +<dt><strong>Name:</strong> <a name="Plist-SetSizes">H5Pset_sizes</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pset_sizes</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pset_sizes</code>(<em>hid_t</em> <code>plist_id</code>, <em>size_t</em> <code>sizeof_addr</code>, <em>size_t</em> <code>sizeof_size</code> ) <dt><strong>Description:</strong> <dd>This function sets the byte size of the offsets and lengths used to - address objects in an HDF5 file. This function is only valid for - file creation templates. 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 - 16. + 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 16. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template to modify. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list to modify. <dt><em>size_t</em> <code>sizeof_addr</code> <dd>Size of an object offset in bytes. <dt><em>size_t</em> <code>sizeof_size</code> @@ -589,20 +592,20 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetSizes">H5Pget_sizes</a> +<dt><strong>Name:</strong> <a name="Plist-GetSizes">H5Pget_sizes</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_sizes</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_sizes</code>(<em>hid_t</em> <code>plist_id</code>, <em>size_t *</em> <code>sizeof_addr</code>, <em>size_t *</em> <code>sizeof_size</code> ) <dt><strong>Description:</strong> <dd>This function retrieves the size of the offsets and lengths used in an HDF5 file. This function is only valid for file creation - templates. + property lists. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>size_t *</em> <code>size</code> <dd>Pointer to location to return offset size in bytes. <dt><em>size_t *</em> <code>size</code> @@ -614,7 +617,7 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetMPI">H5Pset_mpi</a> +<dt><strong>Name:</strong> <a name="Plist-SetMPI">H5Pset_mpi</a> <dt><strong>Signature:</strong> <dd><em>herr_t </em><code>H5Pset_mpi</code>(<em>hid_t</em> <code>tid</code>, <em>MPI_Comm</em> <code>comm</code>, @@ -622,29 +625,29 @@ many different parameters to be easily manipulated. ) <dt><strong>Description:</strong> <dd>Store the access mode for parallel I/O call and the user supplied - communicator and info in the access template which can then + communicator and info in the access property list which can then be used to open file. This function is available only in the parallel HDF5 library. <dt><strong>Parameters:</strong> <dl> <dt><em>hid_t</em> <code>tid</code> - <dd>ID of template to modify + <dd>ID of property list to modify <dt><em>MPI_Comm</em> <code>comm</code> <dd> MPI communicator to be used for file open as defined in MPI_FILE_OPEN of MPI-2. This function does not make a duplicated communicator. Any modification to comm after this function call returns may have undetermined effect - to the access template. Users should call this function - again to setup the template. + to the access property list. Users should call this function + again to setup the property list. <dt><em>MPI_Info</em> <code>info</code> <dd> MPI info object to be used for file open as defined in MPI_FILE_OPEN of MPI-2. This function does not make a duplicated info. Any modification to info after this function call returns may have undetermined effect - to the access template. Users should call this function - again to setup the template. + to the access property list. Users should call this function + again to setup the property list. </dl> <dt><strong>Returns:</strong> <dd>zero/negative @@ -652,7 +655,7 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetMPI">H5Pget_mpi</a> +<dt><strong>Name:</strong> <a name="Plist-GetMPI">H5Pget_mpi</a> <dt><strong>Signature:</strong> <dd><em>herr_t </em><code>H5Pget_mpi</code>(<em>hid_t</em> <code>tid</code>, <em>MPI_Comm</em> <code>*comm</code>, @@ -678,7 +681,7 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetXfer">H5Pset_xfer</a> +<dt><strong>Name:</strong> <a name="Plist-SetXfer">H5Pset_xfer</a> <dt><strong>Signature:</strong> <dd><em>herr_t </em><code>H5Pset_xfer</code>(<em>hid_t</em> <code>tid</code>, <em>H5D_transfer_t</em> <code>data_xfer_mode</code> @@ -707,7 +710,7 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetXfer">H5Pget_xfer</a> +<dt><strong>Name:</strong> <a name="Plist-GetXfer">H5Pget_xfer</a> <dt><strong>Signature:</strong> <dd><em>herr_t </em><code>H5Pget_xfer</code>(<em>hid_t</em> <code>tid</code>, <em>H5D_transfer_t *</em> <code>data_xfer_mode</code> @@ -729,31 +732,32 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetSymK">H5Pset_sym_k</a> +<dt><strong>Name:</strong> <a name="Plist-SetSymK">H5Pset_sym_k</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pset_sym_k</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pset_sym_k</code>(<em>hid_t</em> <code>plist_id</code>, <em>size_t</em> <code>ik</code>, <em>size_t</em> <code>lk</code> ) <dt><strong>Description:</strong> <dd>This function sets the size of parameters used to control the - symbol table nodes. This function is only valid for - file creation templates. Passing in a value of 0 for one of the - parameters retains the current value. - <code>ik</code> is one half the rank of a tree that stores a symbol - table for a group. Internal nodes of the symbol table are on - average 75% full. That is, the average rank of the tree is - 1.5 times the value of <code>ik</code>. - <code>lk</code> is one half of the number of symbols that can be stored in - a symbol table node. A symbol table node is the leaf of a - symbol table tree which is used to store a group. When - symbols are inserted randomly into a group, the group's - symbol table nodes are 75% full on average. That is, they - contain 1.5 times the number of symbols specified by <code>lk</code>. -<dt><strong>Parameters:</strong> - <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + symbol table nodes. This function is only valid for file + creation property lists. Passing in a value of 0 for one + of the parameters retains the current value. + <code>ik</code> is one half the rank of a tree that stores + a symbol table for a group. Internal nodes of the symbol + table are on average 75% full. That is, the average rank + of the tree is 1.5 times the value of + <code>ik</code>. <code>lk</code> is one half of the number + of symbols that can be stored in a symbol table node. A + symbol table node is the leaf of a symbol table tree which + is used to store a group. When symbols are inserted + randomly into a group, the group's symbol table nodes are + 75% full on average. That is, they contain 1.5 times the + number of symbols specified by <code>lk</code>. +<dt><strong>Parameters:</strong> + <dl> + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>size_t</em> <code>ik</code> <dd>Symbol table tree rank. <dt><em>size_t</em> <code>lk</code> @@ -765,23 +769,23 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetSymK">H5Pget_sym_k</a> +<dt><strong>Name:</strong> <a name="Plist-GetSymK">H5Pget_sym_k</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_sym_k</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_sym_k</code>(<em>hid_t</em> <code>plist_id</code>, <em>size_t *</em> <code>ik</code>, <em>size_t *</em> <code>lk</code> ) <dt><strong>Description:</strong> <dd>This function retrieves the size of the symbol table's B-tree 1/2 rank and the symbol table's leaf node 1/2 size. See - information for <a href="#Template-SetSymK">H5Pset_sym_k</a> for - more information. This function is only valid for file creation - templates. If a parameter valued is set to NULL, that parameter is - not retrieved. + information for <a href="#Plist-SetSymK">H5Pset_sym_k</a> + for more information. This function is only valid for file + creation property lists. If a parameter valued is set to + NULL, that parameter is not retrieved. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>size_t *</em> <code>ik</code> <dd>Pointer to location to return the symbol table's B-tree 1/2 rank. <dt><em>size_t *</em> <code>size</code> @@ -793,23 +797,24 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetIstoreK">H5Pset_istore_k</a> +<dt><strong>Name:</strong> <a name="Plist-SetIstoreK">H5Pset_istore_k</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pset_istore_k</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pset_istore_k</code>(<em>hid_t</em> <code>plist_id</code>, <em>size_t</em> <code>ik</code> ) <dt><strong>Description:</strong> <dd>This function sets the size of the parameter used to control the - B-trees for indexing chunked datasets. This function is only valid for - file creation templates. Passing in a value of 0 for one of the - parameters retains the current value. - <code>ik</code> is one half the rank of a tree that stores chunked raw - data. On average, such a tree will be 75% full, or have an - average rank of 1.5 times the value of <code>ik</code>. + B-trees for indexing chunked datasets. This function is + only valid for file creation property lists. Passing in a + value of 0 for one of the parameters retains the current + value. <code>ik</code> is one half the rank of a tree + that stores chunked raw data. On average, such a tree + will be 75% full, or have an average rank of 1.5 times the + value of <code>ik</code>. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>size_t</em> <code>ik</code> <dd>1/2 rank of chunked storage B-tree. </dl> @@ -819,20 +824,20 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetIstoreK">H5Pget_istore_k</a> +<dt><strong>Name:</strong> <a name="Plist-GetIstoreK">H5Pget_istore_k</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_istore_k</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_istore_k</code>(<em>hid_t</em> <code>plist_id</code>, <em>size_t *</em> <code>ik</code> ) <dt><strong>Description:</strong> <dd>Queries the 1/2 rank of an indexed storage B-tree. See - <a href="#Template-SetIstoreK">H5Pset_istore_k</a> for details. + <a href="#Plist-SetIstoreK">H5Pset_istore_k</a> for details. The argument <code>ik</code> may be the null pointer. This - function is only valid for file creation templates. + function is only valid for file creation property lists. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>size_t *</em> <code>ik</code> <dd>Pointer to location to return the chunked storage B-tree 1/2 rank. </dl> @@ -842,15 +847,16 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetLayout">H5Pset_layout</a> +<dt><strong>Name:</strong> <a name="Plist-SetLayout">H5Pset_layout</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pset_layout</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pset_layout</code>(<em>hid_t</em> <code>plist_id</code>, <em>H5D_layout_t</em> <code>layout</code> ) <dt><strong>Description:</strong> <dd>This function sets the type of storage used store the raw data for - a dataset. This function is only valid for dataset creation templates. - Valid parameter for <code>layout</code> are: + a dataset. This function is only valid for dataset + creation property lists. Valid parameter for + <code>layout</code> are: <ul> <dl> <dt>H5D_COMPACT <dd>Store raw data and object header contiguously in file. @@ -866,8 +872,8 @@ many different parameters to be easily manipulated. </dl> </ul> <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>H5D_layout_t</em> <code>layout</code> <dd>Type of storage layout for raw data. </dl> @@ -877,14 +883,14 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetLayout">H5Pget_layout</a> +<dt><strong>Name:</strong> <a name="Plist-GetLayout">H5Pget_layout</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_layout</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_layout</code>(<em>hid_t</em> <code>plist_id</code>, <em>H5D_layout_t *</em> <code>layout</code> ) <dt><strong>Description:</strong> <dd>Queries the layout of the raw data for a dataset. - This function is only valid for dataset creation templates. + This function is only valid for dataset creation property lists. Valid types for <code>layout</code> are: <ul> <dl> <dt>H5D_COMPACT @@ -898,8 +904,8 @@ many different parameters to be easily manipulated. </dl> </ul> <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>H5D_layout_t *</em> <code>layout</code> <dd>Pointer to location to return the storage layout. </dl> @@ -909,24 +915,25 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-SetChunk">H5Pset_chunk</a> +<dt><strong>Name:</strong> <a name="Plist-SetChunk">H5Pset_chunk</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pset_chunk</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pset_chunk</code>(<em>hid_t</em> <code>plist_id</code>, <em>int</em> <code>ndims</code>, <em>const hsize_t *</em> <code>dim</code> ) <dt><strong>Description:</strong> <dd>This function sets the size of the chunks used to store a chunked - layout dataset. This function is only valid for dataset creation - templates. The <code>ndims</code> parameter currently must be the - same size as the rank of the dataset. The values of the - <code>dim</code> array define the size of the chunks to store the - dataset's raw data. As a side-effect, the layout of the dataset is - changed to H5D_CHUNKED, if it isn't already. + layout dataset. This function is only valid for dataset + creation property lists. The <code>ndims</code> parameter + currently must be the same size as the rank of the + dataset. The values of the <code>dim</code> array define + the size of the chunks to store the dataset's raw data. + As a side-effect, the layout of the dataset is changed to + H5D_CHUNKED, if it isn't already. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>int</em> <code>ndims</code> <dd>The number of dimensions of each chunk. <dt><em>const hsize_t *</em> <code>dim</code> @@ -938,20 +945,20 @@ many different parameters to be easily manipulated. <hr> <dl> -<dt><strong>Name:</strong> <a name="Template-GetChunk">H5Pget_chunk</a> +<dt><strong>Name:</strong> <a name="Plist-GetChunk">H5Pget_chunk</a> <dt><strong>Signature:</strong> - <dd><em>herr_t </em><code>H5Pget_chunk</code>(<em>hid_t</em> <code>template_id</code>, + <dd><em>herr_t </em><code>H5Pget_chunk</code>(<em>hid_t</em> <code>plist_id</code>, <em>int</em> <code>max_ndims</code> <em>hsize_t *</em> <code>dims</code> ) <dt><strong>Description:</strong> <dd>Queries the size of chunks for the raw data of a chunked layout dataset. This function is only valid for dataset creation - templates. + property lists. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>template_id</code> - <dd>Template ID to query. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>Property list ID to query. <dt><em>int</em> <code>max_ndims</code> <dd>Size of the <code>dims</code> array. <dt><em>hsize_t *</em> <code>dims</code> @@ -1100,19 +1107,20 @@ be constructed from a datatype and a dataspace. <em>const char *</em><code>name</code>, <em>hid_t</em><code>type_id</code>, <em>hid_t</em><code>space_id</code>, - <em>hid_t</em><code>template_id</code> + <em>hid_t</em><code>plist_id</code> ) <dt><strong>Description:</strong> <dd>This function creates a new dataset in the file specified with the - <code>file_id</code>. The <code>type_id</code> and <code>space_id</code> - are the IDs of the datatype and dataspace used to construct the - framework of the dataset. The datatype and dataspace parameters - describe the dataset as it will exist in the file, which is not - necessarily the same as it exists in memory. The <code>template_id</code> - contains either the default template (H5P_DEFAULT) or a template_id - with particular constant properties used to create the dataset. The - <code>name</code> is used to identify the dataset in a group and must - be unique within that group. + <code>file_id</code>. The <code>type_id</code> and + <code>space_id</code> are the IDs of the datatype and + dataspace used to construct the framework of the dataset. The + datatype and dataspace parameters describe the dataset as it + will exist in the file, which is not necessarily the same as + it exists in memory. The <code>plist_id</code> contains + either the default property lists (H5P_DEFAULT) or a plist_id + with particular constant properties used to create the + dataset. The <code>name</code> is used to identify the + dataset in a group and must be unique within that group. <dt><strong>Parameters:</strong> <dl> <dt><em>hid_t</em> <code>file_id</code> @@ -1123,8 +1131,8 @@ be constructed from a datatype and a dataspace. <dd>ID of the datatype to use when creating the dataset. <dt><em>hid_t</em> <code>space_id</code> <dd>ID of the dataspace to use when creating the dataset. - <dt><em>hid_t</em> <code>template_id</code> - <dd>ID of the dataset creation template. + <dt><em>hid_t</em> <code>plist_id</code> + <dd>ID of the dataset creation property list. </dl> <dt><strong>Returns:</strong> <dd>Dataset ID on success, negative on failure. @@ -1195,15 +1203,16 @@ be constructed from a datatype and a dataspace. <dd><em>hid_t </em><code>H5Dget_create_plist</code>(<em>hid_t </em><code>dataset_id</code> ) <dt><strong>Description:</strong> - <dd>This function returns a copy of the dataset creation template for a - dataset. The template should be released with the H5Pclose() function. + <dd>This function returns a copy of the dataset creation property + list for a dataset. The property list should be released with the + H5Pclose() function. <dt><strong>Parameters:</strong> <dl> <dt><em>hid_t</em> <code>dataset_id</code> <dd>ID of the dataset to query. </dl> <dt><strong>Returns:</strong> - <dd>Dataset creation template ID on success, negative on failure. + <dd>Dataset creation property list ID on success, negative on failure. </dl> <hr> @@ -1214,22 +1223,24 @@ be constructed from a datatype and a dataspace. <em>hid_t</em> <code>mem_type_id</code>, <em>hid_t</em> <code>mem_space_id</code>, <em>hid_t</em> <code>file_space_id</code>, - <em>hid_t</em> <code>transfer_template_id</code>, + <em>hid_t</em> <code>transfer_plist_id</code>, <em>void *</em> <code>buf</code> ) <dt><strong>Description:</strong> <dd>This function reads raw data from the specified dataset into <code>buf</code>, - converting from the file datatype of the dataset into the memory - datatype specified in <code>mem_type_id</code>. The portion of the - dataset to read from disk is specified with the <code>file_spaceid</code> - which can contain a dataspace with a hyperslab selected or the constant - H5S_ALL, which indicates the entire dataset is to be read. The portion - of the dataset read into the memory buffer is specified with the - <code>mem_space_id</code> which can also be a hyperslab of the same - size or the H5S_ALL parameter to store the entire dataset. The - <code>transfer_template_id</code> is a dataset transfer template ID which - is used to provide addition parameters for the I/O operation or can - be H5P_DEFAULT for the default library behavior. + converting from the file datatype of the dataset into the + memory datatype specified in <code>mem_type_id</code>. The + portion of the dataset to read from disk is specified with the + <code>file_spaceid</code> which can contain a dataspace with a + hyperslab selected or the constant H5S_ALL, which indicates + the entire dataset is to be read. The portion of the dataset + read into the memory buffer is specified with the + <code>mem_space_id</code> which can also be a hyperslab of the + same size or the H5S_ALL parameter to store the entire + dataset. The <code>transfer_plist_id</code> is a dataset + transfer property list ID which is used to provide addition + parameters for the I/O operation or can be H5P_DEFAULT for the + default library behavior. <dt><strong>Parameters:</strong> <dl> <dt><em>hid_t</em> <code>dataset_id</code> @@ -1240,8 +1251,8 @@ be constructed from a datatype and a dataspace. <dd>ID of the memory dataspace. <dt><em>hid_t</em> <code>file_space_id</code> <dd>ID of the dataset's dataspace in the file. - <dt><em>hid_t</em> <code>transfer_template_id</code> - <dd>ID of a transfer template for this I/O operation. + <dt><em>hid_t</em> <code>transfer_plist_id</code> + <dd>ID of a transfer property list for this I/O operation. <dt><em>void *</em> <code>buf</code> <dd>Buffer to store information read from the file. </dl> @@ -1257,23 +1268,24 @@ be constructed from a datatype and a dataspace. <em>hid_t</em> <code>mem_type_id</code>, <em>hid_t</em> <code>mem_space_id</code>, <em>hid_t</em> <code>file_space_id</code>, - <em>hid_t</em> <code>transfer_template_id</code>, + <em>hid_t</em> <code>transfer_plist_id</code>, <em>const void *</em> <code>buf</code> ) <dt><strong>Description:</strong> <dd>This function writes raw data from memory into the specified dataset - converting from the memory datatype of the dataset specified in - <code>mem_type_id</code> into the file datatype. - The portion of the - dataset to written to disk is specified with the <code>file_spaceid</code> - which can contain a dataspace with a hyperslab selected or the constant - H5S_ALL, which indicates the entire dataset is to be written. The portion - of the dataset written from the memory buffer is specified with the - <code>mem_space_id</code> which can also be a hyperslab of the same - size or the H5S_ALL parameter to store the entire dataset. The - <code>transfer_template_id</code> is a dataset transfer template ID which - is used to provide addition parameters for the I/O operation or can - be H5P_DEFAULT for the default library behavior. + converting from the memory datatype of the dataset specified + in <code>mem_type_id</code> into the file datatype. The + portion of the dataset to written to disk is specified with + the <code>file_spaceid</code> which can contain a dataspace + with a hyperslab selected or the constant H5S_ALL, which + indicates the entire dataset is to be written. The portion of + the dataset written from the memory buffer is specified with + the <code>mem_space_id</code> which can also be a hyperslab of + the same size or the H5S_ALL parameter to store the entire + dataset. The <code>transfer_plist_id</code> is a dataset + transfer property list ID which is used to provide addition + parameters for the I/O operation or can be H5P_DEFAULT for the + default library behavior. <dt><strong>Parameters:</strong> <dl> <dt><em>hid_t</em> <code>dataset_id</code> @@ -1284,8 +1296,8 @@ be constructed from a datatype and a dataspace. <dd>ID of the memory dataspace. <dt><em>hid_t</em> <code>file_space_id</code> <dd>ID of the dataset's dataspace in the file. - <dt><em>hid_t</em> <code>transfer_template_id</code> - <dd>ID of a transfer template for this I/O operation. + <dt><em>hid_t</em> <code>transfer_plist_id</code> + <dd>ID of a transfer property list for this I/O operation. <dt><em>const void *</em> <code>buf</code> <dd>Buffer to store information to be written to the file. </dl> diff --git a/doc/html/H5.sample_code.html b/doc/html/H5.sample_code.html index b3e5336..3c46205 100644 --- a/doc/html/H5.sample_code.html +++ b/doc/html/H5.sample_code.html @@ -29,7 +29,7 @@ overwrite the previous file's information. <code> <pre> hid_t file_id; - file_id=<A HREF="H5.apiv2.html#File-Create">H5Fcreate</a>("example1.h5",H5F_ACC_EXCL,H5P_DEFAULT_TEMPLATE,H5P_DEFAULT_TEMPLATE); + file_id=<A HREF="H5.apiv2.html#File-Create">H5Fcreate</a>("example1.h5",H5F_ACC_EXCL,H5P_DEFAULT,H5P_DEFAULT); <A HREF="H5.apiv2.html#File-Close">H5Fclose</a>(file_id); diff --git a/doc/html/RM_H5F.html b/doc/html/RM_H5F.html index 926d7ba..cbb0a48 100644 --- a/doc/html/RM_H5F.html +++ b/doc/html/RM_H5F.html @@ -45,8 +45,8 @@ documented below. </ul> </td><td> </td><td valign=top> <ul> - <li><a href="#File-GetCreateTemplate">H5Fget_create_template</a> - <li><a href="#File-GetAccessTemplate">H5Fget_access_template</a> + <li><a href="#File-GetCreatePlist">H5Fget_create_plist</a> + <li><a href="#File-GetAccessPlist">H5Fget_access_plist</a> </ul> </td></tr> </table> @@ -126,8 +126,8 @@ documented below. The more complex behaviors of file creation and access are controlled through the file-creation and file-access property lists. The value of <code>H5P_DEFAULT</code> for - a template value indicates that the library should use - the default values for the appropriate template. Also see + a property list value indicates that the library should use + the default values for the appropriate property list. Also see <code>H5Fpublic.h</code> for the list of supported flags. <dt><strong>Parameters:</strong> <dl> @@ -151,14 +151,14 @@ documented below. <dd>Apply default file access and creation properties. </dl></ul> <dt><em>hid_t</em> <code>create_id</code> - <dd>File creation template identifier, used when modifying + <dd>File creation property list identifier, used when modifying default file meta-data. <dt><em>hid_t</em> <code>access_id</code> <dd>File access property list identifier. If parallel file access is desired, this is a collective call according to the communicator stored in the - <code>access_template</code>. - Use <code>0</code> for default access template. + <code>access_id</code>. + Use <code>0</code> for default access properties. </dl> <dt><strong>Returns:</strong> <dd>Returns a file identifier if successful; @@ -190,14 +190,14 @@ documented below. <hr> <dl> -<dt><strong>Name:</strong> <a name="File-GetCreateTemplate">H5Fget_create_template</a> +<dt><strong>Name:</strong> <a name="File-GetCreatePlist">H5Fget_create_plist</a> <dt><strong>Signature:</strong> - <dd><em>hid_t </em><code>H5Fget_create_template</code>(<em>hid_t</em> <code>file_id</code> + <dd><em>hid_t </em><code>H5Fget_create_plist</code>(<em>hid_t</em> <code>file_id</code> ) <dt><strong>Purpose:</strong> <dd>Returns a file creation property list identifier. <dt><strong>Description:</strong> - <dd><code>H5Fget_create_template</code> returns a file creation + <dd><code>H5Fget_create_plist</code> returns a file creation property list identifier identifying the creation properties used to create this file. This function is useful for duplicating properties when creating another file. @@ -222,13 +222,13 @@ documented below. <hr> <dl> -<dt><strong>Name:</strong> <a name="File-GetAccessTemplate">H5Fget_access_template</a> +<dt><strong>Name:</strong> <a name="File-GetAccessPlist">H5Fget_access_plist</a> <dt><strong>Signature:</strong> - <dd><em>hid_t </em><code>H5Fget_access_template</code>(<em>hid_t</em> <code>file_id</code>) + <dd><em>hid_t </em><code>H5Fget_access_plist</code>(<em>hid_t</em> <code>file_id</code>) <dt><strong>Purpose:</strong> <dd>Returns a file access property list identifier. <dt><strong>Description:</strong> - <dd><code>H5Fget_access_template</code> returns the + <dd><code>H5Fget_access_plist</code> returns the file access property list identifier of the specified file. <p> See "File Access Properties" in diff --git a/doc/html/RM_H5Front.html b/doc/html/RM_H5Front.html index 9c4e1ce..5d8b601 100644 --- a/doc/html/RM_H5Front.html +++ b/doc/html/RM_H5Front.html @@ -32,7 +32,7 @@ tools required to meet specific aspects of the HDF5 data-handling requirements. <li><a href="RM_H5.html">Library Functions</a> -- The general-purpose <strong>H5</strong> functions. <li><a href="RM_H5F.html">File Interface</a> -- The <strong>H5F</strong> API for accessing HDF files. -<li><a href="RM_H5P.html">Property List Interface</a> -- The <strong>H5P</strong> API for manipulating object templates. +<li><a href="RM_H5P.html">Property List Interface</a> -- The <strong>H5P</strong> API for manipulating object property lists. <li><a href="RM_H5D.html">Dataset Interface</a> -- The <strong>H5D</strong> API for manipulating scientific datasets. <li><a href="RM_H5T.html">Datatype Interface</a> -- The <strong>H5T</strong> API for defining dataset element information. <li><a href="RM_H5S.html">Dataspace Interface</a> -- The <strong>H5S</strong> API for defining dataset dataspace. diff --git a/doc/html/Ragged.html b/doc/html/Ragged.html new file mode 100644 index 0000000..aaa653b --- /dev/null +++ b/doc/html/Ragged.html @@ -0,0 +1,138 @@ +<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> +<html> + <head> + <title>Ragged Arrays</title> + </head> + + <body> + <h1>Ragged Arrays</h1> + + <h2>1. Introduction</h2> + + <p><b>Ragged arrays should be considered alpha quality. They were + added to HDF5 to satisfy the needs of the ASCI/DMF vector + bundle project; the interface and storage methods are likely + to change in the future in ways that are not backward + compatible.</b> + + <p>A two-dimensional ragged array has been added to the library + and built on top of other existing functionality. A ragged + array is a one-dimensional array of <em>rows</em> where the + length of any row is independent of the lengths of the other + rows. The number of rows and the length of each row can be + changed at any time (the current version does not support + truncating an array by removing rows). All elements of the + ragged array have the same data type and, as with datasets, the + data is type-converted between memory buffers and files. + + <p>The current implementation works best when most of the rows are + approximately the same length since a two dimensional dataset + can be created to hold a nominal number of elements from each + row with the additional elements stored in a separate dataset + which implements a heap. + + <p>A ragged array is a composite object implemented as a group + with three datasets. The name of the group is the name of the + ragged array. The <em>raw</em> dataset is a two-dimensional + array that contains the first <em>N</em> elements of each row + where <em>N</em> is determined by the application when the array + is created. If most rows have fewer than <em>N</em> elements + then internal fragmentation may be quite bad. + + <p>The <em>over</em> dataset is a one-dimensional array that + contains elements from each row that don't fit in the + <em>raw</em> dataset. + + <p>The <em>meta</em> dataset maintains information about each row + such as the number of elements in the row, the location of the + overflow elements in the <em>over</em> dataset (if any), and the + amount of space reserved in <em>over</em> for the row. The + <em>meta</em> dataset has one entry per row and is where most of + the storage overhead is concentrated when rows are relatively + short. + + <h2>2. Opening and Closing</h2> + + <dl> + <dt><code>hid_t H5Rcreate (hid_t <em>location</em>, const char + *<em>name</em>, hid_t <em>type</em>, hid_t + <em>plist</em>)</code> + <dd>This function creates a new ragged array by creating the + group with the specified name and populating it with the + component datasets (which should not be accessed + independently). The dataset creation property list + <em>plist</em> defines the width of the <em>raw</em> dataset; + a nominal row is considered to be the width of a chunk. The + <em>type</em> argument defines the data type which will be + stored in the file. A negative value is returned if the array + cannot be created. + + <br><br> + <dt><code>hid_t H5Ropen (hid_t <em>location</em>, const char + *<em>name</em>)</code> + <dd>This function opens a ragged array by opening the specified + group and the component datasets (which should not be accessed + indepently). A negative value is returned if the array cannot + be opened. + + <br><br> + <dt><code>herr_t H5Rclose (hid_t <em>array</em>)</code> + <dd>All ragged arrays should be closed by calling this + function. The group and component datasets will be closed + automatically by the library. + </dl> + + <h2>3. Reading and Writing</h2> + + <p>In order to be as efficient as possible the ragged array layer + operates on sets of contiguous rows and it is to the + application's advantage to perform I/O on as many rows at a time + as possible. These functions take a starting row number and the + number of rows on which to operate. + + <dl> + <dt><code>herr_t H5Rwrite (hid_t <em>array_id</em>, hssize_t + <em>start_row</em>, hsize_t <em>nrows</em>, hid_t + <em>type</em>, hsize_t <em>size</em>[], void + *<em>buf</em>[])</code> + <dd>A set of ragged array rows beginning at <em>start_row</em> + and continuing for <em>nrows</em> is written to the file, + converting the memory data type <em>type</em> to the file data + type which was defined when the array was created. The number + of elements to write from each row is specified in the + <em>size</em> array and the data for each row is pointed to + from the <em>buf</em> array. The <em>size</em> and + <em>buf</em> are indexed so their first element corresponds to + the first row on which to operate. + + <br><br> + <dt><code>herr_t H5Rread (hid_t <em>array_id</em>, hssize_t + <em>start_row</em>, hsize_t <em>nrows</em>, hid_t + <em>type</em>, hsize_t <em>size</em>[], void + *<em>buf</em>[])</code> + <dd>A set of ragged array rows beginning at <em>start_row</em> + and continuing for <em>nrows</em> is read from the file, + converting from the file data type which was defined when the + array was created to the memory data type <em>type</em>. The + number of elements to read from each row is specified in the + <em>size</em> array and the buffers in which to place the + results are pointed to by the <em>buf</em> array. On return, + the <em>size</em> array will contain the actual size of the + row which may be different than the requested size. When the + request size is smaller than the actual size the row will be + truncated; otherwise the remainder of the output buffer will + be zero filled. If a pointer in the <em>buf</em> array is + null then the library will ignore the corresponding + <em>size</em> value and allocate a buffer large enough to hold + the entire row. This function returns negative for failures + with <em>buf</em> containing the original input values. + </dl> + + <hr> + <address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address> +<!-- Created: Wed Aug 26 14:10:32 EDT 1998 --> +<!-- hhmts start --> +Last modified: Fri Aug 28 14:27:19 EDT 1998 +<!-- hhmts end --> + </body> +</html> |