H5S.select_hyperslab

Select hyperslab region

Syntax

H5S.select_hyperslab(space_id,op,h5_start,h5_stride,h5_count,h5_block)

Description

H5S.select_hyperslab(space_id,op,h5_start,h5_stride,h5_count,h5_block) selects a hyperslab region to add to the current selected region for the data space specified by space_id. The op argument determines how the new selection is to be combined with the previously existing selection for the data space. Specify op as one of these character vectors or string scalars: 'H5S_SELECT_SET', 'H5S_SELECT_OR', 'H5S_SELECT_AND', 'H5S_SELECT_XOR', 'H5S_SELECT_NOTA', or 'H5S_SELECT_NOTB'.

The h5_start array determines the starting coordinates of the hyperslab to select. The h5_count array determines how many blocks to select from the data space, in each dimension. The h5_stride array specifies how many elements to move in each dimension. The h5_block array determines the size of the element block selected from the data space.

If h5_stride is specified as [], then a contiguous hyperslab is selected, as if each value in h5_stride were set to 1. If h5_count is specified as [], the number of blocks selected along each dimension defaults to 1. If h5_block is specified as [], then the block size defaults to a single element in each dimension, as if each value in the block array were set to 1.

Note

The HDF5 library uses C-style ordering for multidimensional arrays, while MATLAB® uses FORTRAN-style ordering. The h5_start, h5_stride, h5_count and h5_block parameters assume C-style ordering. Please consult "Using the MATLAB Low-Level HDF5 Functions" in the MATLAB documentation for more information.

Examples

dims = [100 200];
h5_dims = fliplr(dims);
space_id = H5S.create_simple(2,h5_dims,h5_dims);
start = fliplr([10 20]); block = fliplr([20 30]);
H5S.select_hyperslab(space_id,'H5S_SELECT_SET',start,[],[],block);