diff --git a/docs/doxygen/dox/H5.format.4.0.dox b/docs/doxygen/dox/H5.format.4.0.dox index e2bd2c85a88..8639e3dab9a 100644 --- a/docs/doxygen/dox/H5.format.4.0.dox +++ b/docs/doxygen/dox/H5.format.4.0.dox @@ -7584,29 +7584,32 @@ another datatype) and the dataspace for a dataset describes the location of the byte byte - + Version Dimensionality Layout Class Reserved (zero) - + Reserved (zero) - +
Data AddressO (optional)

- + Dimension 0 Size - + Dimension 1 Size - + ... - Dataset Element Size (optional) + Dimension \#(n - 1) Size + + + Dataset Element Size Compact Data Size (optional) @@ -7652,8 +7655,10 @@ another datatype) and the dataspace for a dataset describes the location of the Dimensionality An array has a fixed dimensionality. This field specifies the number of dimension size fields later - in the message. The value stored for chunked storage is 1 greater than the number of dimensions in - the dataset’s dataspace. For example, 2 is stored for a 1 dimensional dataset. + in the message. +
For chunked storage, the value stored is one greater than the dataset’s actual number of + dimensions. For example, a 1-dimensional dataset stores a value of 2. + This increment accounts for the dataset element size which occupies the final dimension entry. Layout Class @@ -7688,19 +7693,28 @@ another datatype) and the dataspace for a dataset describes the location of the Dimension \#n Size - For contiguous and compact storage the dimensions define the entire size of the array while for chunked storage - they define the size of a single chunk. In all cases, they are in units of array elements (not bytes). The - first dimension stored in the list of dimensions is the slowest changing dimension and the last dimension - stored is the fastest changing dimension. + For contiguous and compact storage the dimensions define the entire size of the array. + They are in units of array elements (not bytes). + The first dimension stored in the list of dimensions is the slowest changing dimension and the last dimension + stored is the fastest changing dimension. +
For chunked storage, the dimensions define the size of a single chunk. They are in + units of array elements (not bytes). + The first dimension stored in the list of dimensions is the slowest changing dimension and the + (n - 1) dimension stored is the fastest changing dimension. + The last dimension stored is the dataset element size. Dataset Element Size - The size of a dataset element, in bytes. This field is only present for chunked storage. + The size of a dataset element, in bytes. + This field is only present for chunked data storage + and is stored as the last dimension entry in the array of dimensions. + See previous field description. Compact Data Size This field is only present for compact data storage. It contains the size of the raw data for the dataset array, in bytes. + Compact Data This field is only present for compact data storage. It contains the raw data for the dataset @@ -7879,7 +7893,7 @@ Class-specific information for chunked storage (layout class 2): ... - Dimension \#n Size + Dimension \#(n - 1) Size Dataset Element Size @@ -7896,8 +7910,11 @@ Class-specific information for chunked storage (layout class 2): Dimensionality - >A chunk has a fixed dimensionality. This field specifies the number of dimension size fields - later in the message. + A chunk has a fixed dimensionality. + This field specifies the number of dimension size fields + later in the message. The value stored is 1 greater than the dataset’s actual + number of dimensions. For example, a 1-dimensional dataset stores a value of 2. + This increment accounts for the dataset element size which occupies the final dimension entry. Address @@ -7910,11 +7927,15 @@ Class-specific information for chunked storage (layout class 2): Dimension \#n Size These values define the dimension size of a single chunk, in units of array elements (not bytes). The first dimension stored in the list of dimensions is the slowest changing dimension and the - last dimension stored is the fastest changing dimension. + (n - 1) dimension stored is the fastest changing dimension. + The final dimension stored is the dataset element size. Dataset Element Size - The size of a dataset element, in bytes. + The size of a dataset element, in bytes. + This field is only present for chunked data storage + and is stored as the last dimension entry in the array of dimensions. + See previous field description. @@ -8046,7 +8067,10 @@ information for the virtual layout class as well as indexing information for the
...

-
Dimension \#n Size (variable size)

+
Dimension \#(n - 1) Size (variable size)

+ + +
Dataset Element Size (variable size)

Chunk Indexing Type @@ -8088,8 +8112,14 @@ information for the virtual layout class as well as indexing information for the Dimensionality - A chunk has fixed dimension. This field specifies the number of Dimension Size fields - later in the message. + A chunk has a fixed dimensionality. + This field specifies the number of dimension size fields + later in the message. + The value stored is 1 greater than the dataset’s actual + number of dimensions. For example, a 1-dimensional dataset stores a value of 2. + This increment accounts for the dataset element size which occupies the final dimension entry. + + Dimension Size Encoded Length @@ -8099,7 +8129,15 @@ information for the virtual layout class as well as indexing information for the Dimension \#n Size These values define the dimension size of a single chunk, in units of array elements (not bytes). The first dimension stored in the list of dimensions is the slowest changing dimension and the - last dimension stored is the fastest changing dimension. + (n - 1) dimension stored is the fastest changing dimension. + The final dimension stored is the dataset element size. + + + Dataset Element Size + The size of a dataset element, in bytes. + This field is only present for chunked data storage + and is stored as the last dimension entry in the array of dimensions. + See previous field description. Chunk Indexing Type