org.das2.qds.BDataSet

rank 0,1,2,3 or 4 dataset backed by byte array (1 byte signed numbers). Note access to the array is still done via doubles.

version

addValue

addValue( int i0, double value ) → void

add this value to the current value.

Parameters

i0 - the index
value - the value, which is cast to this internal type.

Returns:

void (returns nothing)

[search for examples] [view on GitHub] [view on old javadoc] [view source]

addValue( int i0, int i1, double value ) → void

capability

capability( java.lang.Class clazz ) → Object

TODO: this is untested, but is left in to demonstrate how the capability method should be implemented. Clients should use this instead of casting the class to the capability class.

Parameters

clazz - the class, such as WritableDataSet.class

Returns:

null or the capability if exists, such as WritableDataSet

[search for examples] [view on GitHub] [view on old javadoc] [view source]

create

create( int[] qube ) → BDataSet

Makes an array from array of dimension sizes. The result will have rank qube.length().

Parameters

qube - array specifying the rank and size of each dimension

Returns:

the array as a QDataSet

[search for examples] [view on GitHub] [view on old javadoc] [view source]

createRank1

createRank1( int len0 ) → BDataSet

create a rank 1 dataset backed by array of bytes.

Parameters

len0 - length of the dimension

Returns:

rank 1 qube dataset of backed by array of bytes.

[search for examples] [view on GitHub] [view on old javadoc] [view source]

createRank2

createRank2( int len0, int len1 ) → BDataSet

create a rank 2 qube dataset backed by array of bytes.

Parameters

len0 - length of the dimension
len1 - length of the dimension

Returns:

rank 2 qube dataset of backed by array of bytes.

[search for examples] [view on GitHub] [view on old javadoc] [view source]

createRank3

createRank3( int len0, int len1, int len2 ) → BDataSet

create a rank 3 qube dataset backed by array of bytes.

Parameters

len0 - length of the dimension
len1 - length of the dimension
len2 - length of the dimension

Returns:

rank 3 qube dataset of backed by array of bytes.

[search for examples] [view on GitHub] [view on old javadoc] [view source]

createRank4

createRank4( int len0, int len1, int len2, int len3 ) → BDataSet

create a rank 4 qube dataset backed by array of bytes.

Parameters

len0 - length of the dimension
len1 - length of the dimension
len2 - length of the dimension
len3 - length of the dimension

Returns:

rank 4 qube dataset of backed by array of bytes.

[search for examples] [view on GitHub] [view on old javadoc] [view source]

putValue

putValue( double value ) → void

Parameters

value - a double

Returns:

void (returns nothing)

[search for examples] [view on GitHub] [view on old javadoc] [view source]

putValue( int i0, double value ) → void
putValue( int i0, int i1, double value ) → void
putValue( int i0, int i1, int i2, double value ) → void
putValue( int i0, int i1, int i2, int i3, double value ) → void

slice

slice( int i ) → QDataSet

the slice operator is better implemented here. Presently, we use System.arraycopy to copy out the data, but this could be re-implemented along with an offset parameter so the original data can be used to back the data.

Parameters

i - the index

Returns:

a rank N-1 slice of the data.

[search for examples] [view on GitHub] [view on old javadoc] [view source]

trim

trim( int start, int end ) → QDataSet

trim operator copies the data into a new dataset.

Parameters

start - the first index
end - the last index, exclusive

Returns:

a shorter dataset of the same rank.

[search for examples] [view on GitHub] [view on old javadoc] [view source]

value

value( ) → double

Returns:

double

[search for examples] [view on GitHub] [view on old javadoc] [view source]

value( int i0 ) → double
value( int i0, int i1 ) → double
value( int i0, int i1, int i2 ) → double
value( int i0, int i1, int i2, int i3 ) → double

wrap

wrap( byte[] data, int[] qube ) → BDataSet

Wraps an array from array of dimension sizes. The result will have rank qube.length(). For rank 0, data is 1-element array.

Parameters

data - array containing the data, with the last dimension contiguous in memory.
qube - array specifying the rank and size of each dimension

Returns:

the array as a QDataSet

[search for examples] [view on GitHub] [view on old javadoc] [view source]

wrap( byte[] back, int rank, int len0, int len1, int len2 ) → BDataSet
wrap( byte[] back ) → BDataSet
wrap( byte[] back, int nx, int ny ) → BDataSet
wrap( byte[] back, int nx, int ny, int nz ) → BDataSet