public interface IHDF5LongReader
long
values from HDF5 files.
Obtain an object implementing this interface by calling IHDF5Reader.int64()
or IHDF5Reader.uint64()
.
Note: This interface supports block access and sliced access (which is a special cases of block access) to arrays. The performance of this block access can vary greatly depending on how the data are layed out in the HDF5 file. For best performance, the block (or slice) dimension should be chosen to be equal to the chunk dimensions of the array, as in this case the block written / read are stored as consecutive value in the HDF5 file and one write / read access will suffice.
Note: If the values read are unsigned, use the methods in UnsignedIntUtils
to convert
to a larger Java integer type that can hold all values as unsigned.
Modifier and Type | Method and Description |
---|---|
long[] |
getArrayAttr(java.lang.String objectPath,
java.lang.String attributeName)
Reads a
long[] attribute named attributeName from the data set
objectPath. |
java.lang.Iterable<HDF5DataBlock<long[]>> |
getArrayNaturalBlocks(java.lang.String dataSetPath)
Provides all natural blocks of this one-dimensional data set to iterate over.
|
long |
getAttr(java.lang.String objectPath,
java.lang.String attributeName)
Reads a
long attribute named attributeName from the data set
objectPath. |
long[][] |
getMatrixAttr(java.lang.String objectPath,
java.lang.String attributeName)
Reads a
long matrix attribute named attributeName
from the data set objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
getMDArrayAttr(java.lang.String objectPath,
java.lang.String attributeName)
Reads a multi-dimensional array
long attribute named attributeName
from the data set objectPath. |
java.lang.Iterable<HDF5MDDataBlock<ch.systemsx.cisd.base.mdarray.MDLongArray>> |
getMDArrayNaturalBlocks(java.lang.String dataSetPath)
Provides all natural blocks of this multi-dimensional data set to iterate over.
|
long |
read(java.lang.String objectPath)
Reads a
long value from the data set objectPath. |
long[] |
readArray(java.lang.String objectPath)
Reads a
long array (of rank 1) from the data set objectPath. |
long[] |
readArrayBlock(HDF5DataSet dataSet,
int blockSize,
long blockNumber)
Reads a block from a
int array (of rank 1) from the dataSet. |
long[] |
readArrayBlock(java.lang.String objectPath,
int blockSize,
long blockNumber)
Reads a block from a
long array (of rank 1) from the data set
objectPath. |
long[] |
readArrayBlockWithOffset(HDF5DataSet dataSet,
int blockSize,
long offset)
Reads a block from
int array (of rank 1) from the dataSet. |
long[] |
readArrayBlockWithOffset(java.lang.String objectPath,
int blockSize,
long offset)
Reads a block from
long array (of rank 1) from the data set
objectPath. |
long[][] |
readMatrix(java.lang.String objectPath)
Reads a
long matrix (array of arrays) from the data set
objectPath. |
long[][] |
readMatrixBlock(java.lang.String objectPath,
int blockSizeX,
int blockSizeY,
long blockNumberX,
long blockNumberY)
Reads a
long matrix (array of arrays) from the data set
objectPath. |
long[][] |
readMatrixBlockWithOffset(java.lang.String objectPath,
int blockSizeX,
int blockSizeY,
long offsetX,
long offsetY)
Reads a
long matrix (array of arrays) from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArray(HDF5DataSet dataSet,
HDF5ArrayBlockParams params)
Reads part or all of a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArray(java.lang.String objectPath)
Reads a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArray(java.lang.String objectPath,
HDF5ArrayBlockParams params)
Reads part or all of a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArrayBlock(HDF5DataSet dataSet,
int[] blockDimensions,
long[] blockNumber)
Reads a block from a multi-dimensional
long array from the data set
dataSet. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArrayBlock(java.lang.String objectPath,
int[] blockDimensions,
long[] blockNumber)
Reads a block from a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArrayBlockWithOffset(HDF5DataSet dataSet,
int[] blockDimensions,
long[] offset)
Reads a block from a multi-dimensional
long array from the data set
dataSet. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArrayBlockWithOffset(java.lang.String objectPath,
int[] blockDimensions,
long[] offset)
Reads a block from a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArraySlice(HDF5DataSet dataSet,
IndexMap boundIndices)
Reads a slice of a multi-dimensional
long array from the data set
dataSet. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArraySlice(HDF5DataSet dataSet,
long[] boundIndices)
Reads a slice of a multi-dimensional
long array from the data set
dataSet. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArraySlice(java.lang.String objectPath,
IndexMap boundIndices)
Reads a slice of a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readMDArraySlice(java.lang.String objectPath,
long[] boundIndices)
Reads a slice of a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlock(HDF5DataSet dataSet,
int[] blockDimensions,
long[] blockNumber,
IndexMap boundIndices)
Reads a sliced block from a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlock(HDF5DataSet dataSet,
int[] blockDimensions,
long[] blockNumber,
long[] boundIndices)
Reads a sliced block from a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlock(java.lang.String objectPath,
int[] blockDimensions,
long[] blockNumber,
IndexMap boundIndices)
Reads a sliced block from a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlock(java.lang.String objectPath,
int[] blockDimensions,
long[] blockNumber,
long[] boundIndices)
Reads a sliced block from a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlockWithOffset(HDF5DataSet dataSet,
int[] blockDimensions,
long[] offset,
IndexMap boundIndices)
Reads a sliced block of a multi-dimensional
long array from the data set
dataSet. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlockWithOffset(HDF5DataSet dataSet,
int[] blockDimensions,
long[] offset,
long[] boundIndices)
Reads a sliced block of a multi-dimensional
long array from the data set
dataSet. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlockWithOffset(java.lang.String objectPath,
int[] blockDimensions,
long[] offset,
IndexMap boundIndices)
Reads a sliced block of a multi-dimensional
long array from the data set
objectPath. |
ch.systemsx.cisd.base.mdarray.MDLongArray |
readSlicedMDArrayBlockWithOffset(java.lang.String objectPath,
int[] blockDimensions,
long[] offset,
long[] boundIndices)
Reads a sliced block of a multi-dimensional
long array from the data set
objectPath. |
int[] |
readToMDArrayBlockWithOffset(HDF5DataSet dataSet,
ch.systemsx.cisd.base.mdarray.MDLongArray array,
int[] blockDimensions,
long[] offset,
int[] memoryOffset)
Reads a block of the multi-dimensional
long array data set
objectPath into a given array in memory. |
int[] |
readToMDArrayBlockWithOffset(java.lang.String objectPath,
ch.systemsx.cisd.base.mdarray.MDLongArray array,
int[] blockDimensions,
long[] offset,
int[] memoryOffset)
Reads a block of the multi-dimensional
long array data set
objectPath into a given array in memory. |
int[] |
readToMDArrayWithOffset(HDF5DataSet dataSet,
ch.systemsx.cisd.base.mdarray.MDLongArray array,
int[] memoryOffset)
Reads a multi-dimensional
long array data set objectPath
into a given array in memory. |
int[] |
readToMDArrayWithOffset(java.lang.String objectPath,
ch.systemsx.cisd.base.mdarray.MDLongArray array,
int[] memoryOffset)
Reads a multi-dimensional
long array data set objectPath
into a given array in memory. |
long getAttr(java.lang.String objectPath, java.lang.String attributeName)
long
attribute named attributeName from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.attributeName
- The name of the attribute to read.long[] getArrayAttr(java.lang.String objectPath, java.lang.String attributeName)
long[]
attribute named attributeName from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.attributeName
- The name of the attribute to read.ch.systemsx.cisd.base.mdarray.MDLongArray getMDArrayAttr(java.lang.String objectPath, java.lang.String attributeName)
long
attribute named attributeName
from the data set objectPath.objectPath
- The name (including path information) of the data set object in the file.attributeName
- The name of the attribute to read.long[][] getMatrixAttr(java.lang.String objectPath, java.lang.String attributeName) throws HDF5JavaException
long
matrix attribute named attributeName
from the data set objectPath.objectPath
- The name (including path information) of the data set object in the file.attributeName
- The name of the attribute to read.HDF5JavaException
long read(java.lang.String objectPath)
long
value from the data set objectPath. This method
doesn't check the data space but simply reads the first value.objectPath
- The name (including path information) of the data set object in the file.long[] readArray(java.lang.String objectPath)
long
array (of rank 1) from the data set objectPath.objectPath
- The name (including path information) of the data set object in the file.int[] readToMDArrayWithOffset(java.lang.String objectPath, ch.systemsx.cisd.base.mdarray.MDLongArray array, int[] memoryOffset)
long
array data set objectPath
into a given array in memory.objectPath
- The name (including path information) of the data set object in the file.array
- The array to read the data into.memoryOffset
- The offset in the array to write the data to.int[] readToMDArrayWithOffset(HDF5DataSet dataSet, ch.systemsx.cisd.base.mdarray.MDLongArray array, int[] memoryOffset)
long
array data set objectPath
into a given array in memory.dataSet
- The data set to read from.array
- The array to read the data into.memoryOffset
- The offset in the array to write the data to.int[] readToMDArrayBlockWithOffset(java.lang.String objectPath, ch.systemsx.cisd.base.mdarray.MDLongArray array, int[] blockDimensions, long[] offset, int[] memoryOffset)
long
array data set
objectPath into a given array in memory.objectPath
- The name (including path information) of the data set object in the file.array
- The array to read the data into.blockDimensions
- The size of the block to read along each axis.offset
- The offset of the block in the data set.memoryOffset
- The offset of the block in the array to write the data to.int[] readToMDArrayBlockWithOffset(HDF5DataSet dataSet, ch.systemsx.cisd.base.mdarray.MDLongArray array, int[] blockDimensions, long[] offset, int[] memoryOffset)
long
array data set
objectPath into a given array in memory.dataSet
- The data set to read from.array
- The array to read the data into.blockDimensions
- The size of the block to read along each axis.offset
- The offset of the block in the data set.memoryOffset
- The offset of the block in the array to write the data to.long[] readArrayBlock(java.lang.String objectPath, int blockSize, long blockNumber)
long
array (of rank 1) from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.blockSize
- The block size (this will be the length of the long[]
returned
if the data set is long enough).blockNumber
- The number of the block to read (starting with 0, offset: multiply with
blockSize).long[] readArrayBlock(HDF5DataSet dataSet, int blockSize, long blockNumber)
int
array (of rank 1) from the dataSet.
This method is faster than readArrayBlock(String, int, long)
when called many times on the same data set.
dataSet
- The data set to read from.blockSize
- The block size (this will be the length of the int[]
returned
if the data set is long enough).blockNumber
- The number of the block to read (starting with 0, offset: multiply with
blockSize).long[] readArrayBlockWithOffset(java.lang.String objectPath, int blockSize, long offset)
long
array (of rank 1) from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.blockSize
- The block size (this will be the length of the long[]
returned).offset
- The offset of the block in the data set to start reading from (starting with 0).long[] readArrayBlockWithOffset(HDF5DataSet dataSet, int blockSize, long offset)
int
array (of rank 1) from the dataSet.
This method is faster than readArrayBlockWithOffset(String, int, long)
when called many times on the same data set.
dataSet
- The data set to read from.blockSize
- The block size (this will be the length of the int[]
returned).offset
- The offset of the block in the data set to start reading from (starting with 0).long[][] readMatrix(java.lang.String objectPath) throws HDF5JavaException
long
matrix (array of arrays) from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.HDF5JavaException
- If the data set objectPath is not of rank 2.long[][] readMatrixBlock(java.lang.String objectPath, int blockSizeX, int blockSizeY, long blockNumberX, long blockNumberY) throws HDF5JavaException
long
matrix (array of arrays) from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.blockSizeX
- The size of the block in the x dimension.blockSizeY
- The size of the block in the y dimension.blockNumberX
- The block number in the x dimension (offset: multiply with
blockSizeX
).blockNumberY
- The block number in the y dimension (offset: multiply with
blockSizeY
).HDF5JavaException
- If the data set objectPath is not of rank 2.long[][] readMatrixBlockWithOffset(java.lang.String objectPath, int blockSizeX, int blockSizeY, long offsetX, long offsetY) throws HDF5JavaException
long
matrix (array of arrays) from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.blockSizeX
- The size of the block in the x dimension.blockSizeY
- The size of the block in the y dimension.offsetX
- The offset in x dimension in the data set to start reading from.offsetY
- The offset in y dimension in the data set to start reading from.HDF5JavaException
- If the data set objectPath is not of rank 2.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArray(java.lang.String objectPath)
long
array from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArray(java.lang.String objectPath, HDF5ArrayBlockParams params)
long
array from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.params
- The parameter block specifying the block or slice to read from the array.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArray(HDF5DataSet dataSet, HDF5ArrayBlockParams params)
long
array from the data set
objectPath.dataSet
- The data set to read from.params
- The parameter block specifying the block or slice to read from the array.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArraySlice(java.lang.String objectPath, IndexMap boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.objectPath
- The name (including path information) of the data set object in the file.boundIndices
- The mapping of indices to index values which should be bound. For example
a map of new IndexMap().mapTo(2, 5).mapTo(4, 7)
has 2 and 4 as bound
indices and binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArraySlice(HDF5DataSet dataSet, IndexMap boundIndices)
long
array from the data set
dataSet. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.dataSet
- The data set to read from.boundIndices
- The mapping of indices to index values which should be bound. For example
a map of new IndexMap().mapTo(2, 5).mapTo(4, 7)
has 2 and 4 as bound
indices and binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArraySlice(java.lang.String objectPath, long[] boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.objectPath
- The name (including path information) of the data set object in the file.boundIndices
- The array containing the values of the bound indices at the respective
index positions, and -1 at the free index positions. For example an array of
new long[] { -1, -1, 5, -1, 7, -1 }
has 2 and 4 as bound indices and
binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArraySlice(HDF5DataSet dataSet, long[] boundIndices)
long
array from the data set
dataSet. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.dataSet
- The data set to read from.boundIndices
- The array containing the values of the bound indices at the respective
index positions, and -1 at the free index positions. For example an array of
new long[] { -1, -1, 5, -1, 7, -1 }
has 2 and 4 as bound indices and
binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArrayBlock(java.lang.String objectPath, int[] blockDimensions, long[] blockNumber)
long
array from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.blockDimensions
- The extent of the block in each dimension.blockNumber
- The block number in each dimension (offset: multiply with the
blockDimensions in the according dimension).ch.systemsx.cisd.base.mdarray.MDLongArray readMDArrayBlock(HDF5DataSet dataSet, int[] blockDimensions, long[] blockNumber)
long
array from the data set
dataSet.dataSet
- The data set to read from.blockDimensions
- The extent of the block in each dimension.blockNumber
- The block number in each dimension (offset: multiply with the
blockDimensions in the according dimension).ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlock(java.lang.String objectPath, int[] blockDimensions, long[] blockNumber, IndexMap boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.objectPath
- The name (including path information) of the data set object in the file.blockDimensions
- The extent of the block in each dimension.blockNumber
- The block number in each dimension (offset: multiply with the
blockDimensions in the according dimension).boundIndices
- The mapping of indices to index values which should be bound. For example
a map of new IndexMap().mapTo(2, 5).mapTo(4, 7)
has 2 and 4 as bound
indices and binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlock(HDF5DataSet dataSet, int[] blockDimensions, long[] blockNumber, IndexMap boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.dataSet
- The data set to read from.blockDimensions
- The extent of the block in each dimension.blockNumber
- The block number in each dimension (offset: multiply with the
blockDimensions in the according dimension).boundIndices
- The mapping of indices to index values which should be bound. For example
a map of new IndexMap().mapTo(2, 5).mapTo(4, 7)
has 2 and 4 as bound
indices and binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlock(java.lang.String objectPath, int[] blockDimensions, long[] blockNumber, long[] boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.objectPath
- The name (including path information) of the data set object in the file.blockDimensions
- The extent of the block in each dimension.blockNumber
- The block number in each dimension (offset: multiply with the
blockDimensions in the according dimension).boundIndices
- The array containing the values of the bound indices at the respective
index positions, and -1 at the free index positions. For example an array of
new long[] { -1, -1, 5, -1, 7, -1 }
has 2 and 4 as bound indices and
binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlock(HDF5DataSet dataSet, int[] blockDimensions, long[] blockNumber, long[] boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.dataSet
- The data set to read from.blockDimensions
- The extent of the block in each dimension.blockNumber
- The block number in each dimension (offset: multiply with the
blockDimensions in the according dimension).boundIndices
- The array containing the values of the bound indices at the respective
index positions, and -1 at the free index positions. For example an array of
new long[] { -1, -1, 5, -1, 7, -1 }
has 2 and 4 as bound indices and
binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArrayBlockWithOffset(java.lang.String objectPath, int[] blockDimensions, long[] offset)
long
array from the data set
objectPath.objectPath
- The name (including path information) of the data set object in the file.blockDimensions
- The extent of the block in each dimension.offset
- The offset in the data set to start reading from in each dimension.ch.systemsx.cisd.base.mdarray.MDLongArray readMDArrayBlockWithOffset(HDF5DataSet dataSet, int[] blockDimensions, long[] offset)
long
array from the data set
dataSet.dataSet
- The data set to read from.blockDimensions
- The extent of the block in each dimension.offset
- The offset in the data set to start reading from in each dimension.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlockWithOffset(java.lang.String objectPath, int[] blockDimensions, long[] offset, IndexMap boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.objectPath
- The name (including path information) of the data set object in the file.blockDimensions
- The extent of the block in each dimension.offset
- The offset in the data set to start reading from in each dimension.boundIndices
- The mapping of indices to index values which should be bound. For example
a map of new IndexMap().mapTo(2, 5).mapTo(4, 7)
has 2 and 4 as bound
indices and binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlockWithOffset(HDF5DataSet dataSet, int[] blockDimensions, long[] offset, IndexMap boundIndices)
long
array from the data set
dataSet. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.dataSet
- The data set to read from.blockDimensions
- The extent of the block in each dimension.offset
- The offset in the data set to start reading from in each dimension.boundIndices
- The mapping of indices to index values which should be bound. For example
a map of new IndexMap().mapTo(2, 5).mapTo(4, 7)
has 2 and 4 as bound
indices and binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlockWithOffset(java.lang.String objectPath, int[] blockDimensions, long[] offset, long[] boundIndices)
long
array from the data set
objectPath. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.objectPath
- The name (including path information) of the data set object in the file.blockDimensions
- The extent of the block in each dimension.offset
- The offset in the data set to start reading from in each dimension.boundIndices
- The array containing the values of the bound indices at the respective
index positions, and -1 at the free index positions. For example an array of
new long[] { -1, -1, 5, -1, 7, -1 }
has 2 and 4 as bound indices and
binds them to the values 5 and 7, respectively.ch.systemsx.cisd.base.mdarray.MDLongArray readSlicedMDArrayBlockWithOffset(HDF5DataSet dataSet, int[] blockDimensions, long[] offset, long[] boundIndices)
long
array from the data set
dataSet. The slice is defined by "bound indices", each of which is fixed to a
given value. The returned data block only contains the free (i.e. non-fixed) indices.dataSet
- The data set to read from.blockDimensions
- The extent of the block in each dimension.offset
- The offset in the data set to start reading from in each dimension.boundIndices
- The array containing the values of the bound indices at the respective
index positions, and -1 at the free index positions. For example an array of
new long[] { -1, -1, 5, -1, 7, -1 }
has 2 and 4 as bound indices and
binds them to the values 5 and 7, respectively.java.lang.Iterable<HDF5DataBlock<long[]>> getArrayNaturalBlocks(java.lang.String dataSetPath) throws HDF5JavaException
HDF5JavaException
- If the data set is not of rank 1.HDF5DataBlock
java.lang.Iterable<HDF5MDDataBlock<ch.systemsx.cisd.base.mdarray.MDLongArray>> getMDArrayNaturalBlocks(java.lang.String dataSetPath)
HDF5MDDataBlock