Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  IDL Reference  >  I/O - HDF5  >  H5S_SELECT_ELEMENTS

H5S_SELECT_ELEMENTS

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

See Also


H5S_GET_SELECT_ELEM_NPOINTS, H5S_GET_SELECT_ELEM_POINTLIST, H5S_GET_SELECT_NPOINTS, H5S_SELECT_HYPERSLAB



© 2018 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us