H5S_SELECT_ELEMENTS

The H5S_SELECT_ELEMENTS procedure selects array elements to be included in the selection for a dataspace.

Note: Because of a bug in the underlying HDF5 library (from The HDF Group), you must specify the RESET keyword when using H5S_SELECT_ELEMENTS. Currently, there is no way to add to an existing selection, you can only replace the selection. If you do not specify /RESET then IDL will throw an error. This was done so that in a future IDL version when the HDF5 bug is fixed, your code will work as expected and you will not accidentally add to an existing selection instead of replacing the selection.

Syntax

H5S_SELECT_ELEMENTS, Dataspace_id, Coordinates, /RESET

Arguments

Dataspace_id

An integer representing the dataspace’s identifier on which to set the selection.

Coordinates

An m-element vector, or an (m x n) array, where m is the number of dimensions (or rank) of the dataspace, and n is the number of selected points. Each row contains the coordinates for an element selection point.

Keywords

RESET

Set this keyword to replace the existing selection with the new Coordinates. The default is RESET=0 which adds the new selection to the existing selection.

Note: As noted above, you must set the RESET keyword for the H5S_SELECT_ELEMENTS routine to work properly.

Version History

5.6	Introduced
8.3	Add clarifying note about RESET keyword