org.autoplot.dods

Class DodsVarDataSet

java.lang.Object

org.autoplot.dods.DodsVarDataSet

All Implemented Interfaces:

MutablePropertyDataSet, QDataSet, WritableDataSet

Direct Known Subclasses:

DodsVarDataSet.DoubleArray, DodsVarDataSet.EpochStringArray, DodsVarDataSet.FloatArray, DodsVarDataSet.Int16Array, DodsVarDataSet.Int32Array, DodsVarDataSet.NominalStringArray

public abstract class DodsVarDataSet
extends java.lang.Object
implements WritableDataSet

Adapter from Dods DArray to look like QDataSet.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DodsVarDataSet.DoubleArray
static class	DodsVarDataSet.EpochStringArray
static class	DodsVarDataSet.FloatArray
static class	DodsVarDataSet.Int16Array
static class	DodsVarDataSet.Int32Array
static class	DodsVarDataSet.NominalStringArray

Field Summary

Fields inherited from interface org.das2.qds.QDataSet

AVERAGE_TYPE, BIN_MAX, BIN_MAX_NAME, BIN_MIN, BIN_MIN_NAME, BIN_MINUS, BIN_MINUS_NAME, BIN_PLUS, BIN_PLUS_NAME, BINS_0, BINS_1, BUNDLE_0, BUNDLE_1, BUNDLE_2, BUNDLE_3, CACHE_TAG, CADENCE, CONTEXT_0, CONTEXT_1, COORDINATE_FRAME, DEFAULT_FILL_VALUE, DELTA_MINUS, DELTA_MINUS_NAME, DELTA_PLUS, DELTA_PLUS_NAME, DEPEND_0, DEPEND_1, DEPEND_2, DEPEND_3, DEPENDNAME_0, DEPENDNAME_1, DESCRIPTION, ELEMENT_DIMENSIONS, ELEMENT_LABEL, ELEMENT_NAME, FILL_VALUE, FORMAT, JOIN_0, LABEL, LIMIT_HUGE_DATASET, MAX_HIGH_RANK, MAX_PLANE_COUNT, MAX_RANK, MAX_UNIT_BUNDLE_COUNT, METADATA, METADATA_MODEL, MIN_WAVEFORM_LENGTH, MONOTONIC, NAME, NOTES, PLANE_0, QUBE, RENDER_TYPE, SCALE_TYPE, SOURCE, START_INDEX, TITLE, TYPICAL_MAX, TYPICAL_MIN, UNITS, USER_PROPERTIES, VALID_MAX, VALID_MIN, VALUE_AVERAGE_TYPE_GEOMETRIC, VALUE_AVERAGE_TYPE_LINEAR, VALUE_AVERAGE_TYPE_MOD24, VALUE_AVERAGE_TYPE_MOD360, VALUE_AVERAGE_TYPE_MODPI, VALUE_AVERAGE_TYPE_MODTAU, VALUE_AVERAGE_TYPE_NONE, VALUE_BINS_MIN_MAX, VALUE_COORDINATE_FRAME_COMPLEX_NUMBER, VALUE_METADATA_MODEL_ISTP, VALUE_METADATA_MODEL_SPASE, VALUE_RENDER_TYPE_COMPOSITE_IMAGE, VALUE_RENDER_TYPE_DIGITAL, VALUE_RENDER_TYPE_EVENTS_BAR, VALUE_RENDER_TYPE_NNSPECTROGRAM, VALUE_RENDER_TYPE_SERIES, VALUE_SCALE_TYPE_LINEAR, VALUE_SCALE_TYPE_LOG, VERSION, WEIGHTS

Constructor Summary

Constructors

Constructor and Description
DodsVarDataSet(opendap.dap.DArray array) Creates a new instance of DodsVarDataSet

Method Summary

Modifier and Type	Method and Description
<T> T	capability(java.lang.Class<T> clazz) return null or an object implementing the capability for the given interface For example:
protected void	checkImmutable() here is the one place where we check immutable, and we can make this throw an exception once things look stable.
boolean	isImmutable() return true if the dataset has been made immutable.
int	length() return the length of the first dimension
int	length(int i) return the length of the second dimension, for the ith element of the first dimension.
int	length(int i0, int i1) return the length of the third dimension, for the ith element of the first dimension and jth element of the second dimension.
int	length(int i0, int i1, int i2) return the length of the fourth dimension for the ith, jth and kth elements of the first three dimensions.
void	makeImmutable() mark the dataset as being immutable.
protected static DodsVarDataSet	newDataSet(opendap.dap.DArray z, java.util.Map<java.lang.String,java.lang.Object> properties)
java.lang.Object	property(java.lang.String name) accessor for properties attached to the dataset.
java.lang.Object	property(java.lang.String name, int i) accessor for properties attached to the dataset's first index.
void	putProperty(java.lang.String name, int i, java.lang.Object value) assign the name value to the property at the slice index.
void	putProperty(java.lang.String name, java.lang.Object value) assign the name value to the property.
void	putValue(int i0, int i1, int i2, int i3, double v) put a value into the rank 4 dataset.
int	rank() returns the rank of the dataset, which is the number of indeces used to access data.
QDataSet	slice(int i) return a dataset that is a slice of this dataset, slicing on the zeroth dimension.
java.lang.String	svalue() rank 0 accessor which provides the string value
java.lang.String	toString()
QDataSet	trim(int start, int end) return a dataset that is a subset of this dataset.
abstract double	value(int i) rank 1 accessor.
abstract double	value(int i0, int i1) rank 2 accessor.
abstract double	value(int i0, int i1, int i2) rank 3 accessor.
abstract double	value(int i0, int i1, int i2, int i3) rank 4 accessor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.das2.qds.WritableDataSet

putValue, putValue, putValue, putValue

Methods inherited from interface org.das2.qds.QDataSet

value

Constructor Detail

DodsVarDataSet

public DodsVarDataSet(opendap.dap.DArray array)

Creates a new instance of DodsVarDataSet

Parameters:

array - the openDap array.

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

rank

public int rank()

Description copied from interface: QDataSet

returns the rank of the dataset, which is the number of indeces used to access data. Only rank 0, 1, 2, 3, and 4 datasets are supported in the interface. When a dataset's rank is 5 or greater, it should implement the HighRankDataSet interface which affords a slice operation to reduce rank.

Specified by:

rank in interface QDataSet

Returns:

the rank, or number of indeces used to access data.

svalue

public java.lang.String svalue()

Description copied from interface: QDataSet

rank 0 accessor which provides the string value

Specified by:

svalue in interface QDataSet

Returns:

the value, see the property UNITS to interpret this.

value

public abstract double value(int i)

Description copied from interface: QDataSet

rank 1 accessor.

Specified by:

value in interface QDataSet

Parameters:

i - the index

Returns:

the value, see the property UNITS to interpret this.

value

public abstract double value(int i0,
                             int i1)

Description copied from interface: QDataSet

rank 2 accessor.

Specified by:

value in interface QDataSet

Parameters:

i0 - the index

i1 - the index

Returns:

the value, see the property UNITS to interpret this.

value

public abstract double value(int i0,
                             int i1,
                             int i2)

Description copied from interface: QDataSet

rank 3 accessor.

Specified by:

value in interface QDataSet

Parameters:

i0 - the index

i1 - the index

i2 - the index

Returns:

the value, see the property UNITS to interpret this.

value

public abstract double value(int i0,
                             int i1,
                             int i2,
                             int i3)

Description copied from interface: QDataSet

rank 4 accessor.

Specified by:

value in interface QDataSet

Parameters:

i0 - the index

i1 - the index

i2 - the index

i3 - the index

Returns:

the value, see the property UNITS to interpret this.

putValue

public void putValue(int i0,
                     int i1,
                     int i2,
                     int i3,
                     double v)

Description copied from interface: WritableDataSet

put a value into the rank 4 dataset.

Specified by:

putValue in interface WritableDataSet

Parameters:

i0 - the index

i1 - the index

i2 - the index

i3 - the index

v - the value

property

public java.lang.Object property(java.lang.String name)

Description copied from interface: QDataSet

accessor for properties attached to the dataset. See final static members for example properties.

Specified by:

property in interface QDataSet

Parameters:

name - property name, such as "DEPEND_0" or "UNITS"

Returns:

the value

See Also:

QDataSet.DEPEND_0, QDataSet.UNITS

property

public java.lang.Object property(java.lang.String name,
                                 int i)

Description copied from interface: QDataSet

accessor for properties attached to the dataset's first index. These properties override (or shadow) properties attached to the dataset, and often implementations will simply return the result of the no-index accessor. Note: properties of higher dimension are accessible only by slicing.

Specified by:

property in interface QDataSet

Parameters:

name - property name, such as "DEPEND_0" or "UNITS"

i - the index

Returns:

the value

See Also:

QDataSet.DEPEND_0, QDataSet.UNITS

putProperty

public void putProperty(java.lang.String name,
                        java.lang.Object value)

Description copied from interface: MutablePropertyDataSet

assign the name value to the property. Note that name__i can be used as a alias for an indexed property, but when possible putProperty(name,i,value) should be used.

Specified by:

putProperty in interface MutablePropertyDataSet

Parameters:

name - property name like "UNITS" (Use QDataSet.UNITS)

value - the property value.

See Also:

putProperty which properly checks mutability of the dataset, QDataSet.UNITS

putProperty

public void putProperty(java.lang.String name,
                        int i,
                        java.lang.Object value)

Description copied from interface: MutablePropertyDataSet

assign the name value to the property at the slice index.

Specified by:

putProperty in interface MutablePropertyDataSet

Parameters:

name - property name like "UNITS" (Use QDataSet.UNITS)

i - the index of the slice.

value - the property value.

See Also:

Ops.putProperty(org.das2.qds.QDataSet, java.lang.String, java.lang.Object), QDataSet.UNITS, QDataSet.property(java.lang.String, int)

length

public int length()

Description copied from interface: QDataSet

return the length of the first dimension

Specified by:

length in interface QDataSet

Returns:

the length of the first dimension

length

public int length(int i)

Description copied from interface: QDataSet

return the length of the second dimension, for the ith element of the first dimension. Note if there are zero elements in the first dimension, but this is a QUBE, then this should not throw an IndexOutOfBoundsException.

Specified by:

length in interface QDataSet

Parameters:

i - the index

Returns:

the length of the second dimension at index i.

length

public int length(int i0,
                  int i1)

Description copied from interface: QDataSet

return the length of the third dimension, for the ith element of the first dimension and jth element of the second dimension.

Specified by:

length in interface QDataSet

Parameters:

i0 - the index

i1 - the index

Returns:

the length of the third dimension at index i.

length

public int length(int i0,
                  int i1,
                  int i2)

Description copied from interface: QDataSet

return the length of the fourth dimension for the ith, jth and kth elements of the first three dimensions.

Specified by:

length in interface QDataSet

Parameters:

i0 - the index

i1 - the index

i2 - the index

Returns:

the length of the fourth dimension for the ith, jth and kth elements of the first three dimensions.

capability

public <T> T capability(java.lang.Class<T> clazz)

Description copied from interface: QDataSet

return null or an object implementing the capability for the given interface For example:

ds= DDataSet.createRank1(100);
WriteCapability write= ds.capability( WriteCapability.class );
write.putValue( 99, -1e31 );

This allows operations to be performed efficiently. Note there is no WriteCapability class, this is just an example.

Specified by:

capability in interface QDataSet

Type Parameters:

T - a capability

Parameters:

clazz - the class, such as WriteCapability.class

Returns:

the implementing class, or null (Jython None) if the capability is not provided.

slice

public QDataSet slice(int i)

Description copied from interface: QDataSet

return a dataset that is a slice of this dataset, slicing on the zeroth dimension. A slice will be the elements at this index, for example if this dataset is a rank 2 dataset flux(Time,Energy) then the slice of this will be a rank 1 dataset flux(Energy). The result of any slice will be a qube. Note the index must be positive. Negative indices, referenced from the end of the dataset, are not supported.

Specified by:

slice in interface QDataSet

Parameters:

i - the index to slice at

Returns:

the rank n-1 QDataSet at index i.

trim

public QDataSet trim(int start,
                     int end)

Description copied from interface: QDataSet

return a dataset that is a subset of this dataset. For example:

 
    ds= DDataSet.createRank1(100);
    QDataSet trim= ds.trim(50,60);
    assert( trim.length()==10 );
 
 

Note start and end must be positive. Negative indices, referenced from the end of the dataset, are not supported here.

Specified by:

trim in interface QDataSet

Parameters:

start - the first index to be included in the new dataset.

end - the exclusive index indicating the last index.

Returns:

a QDataSet with the same rank but fewer elements.

makeImmutable

public void makeImmutable()

Description copied from interface: MutablePropertyDataSet

mark the dataset as being immutable. Once this is called, calls to mutating properties will print warning messages for now, but will soon be an error.

Specified by:

makeImmutable in interface MutablePropertyDataSet

isImmutable

public boolean isImmutable()

Description copied from interface: MutablePropertyDataSet

return true if the dataset has been made immutable.

Specified by:

isImmutable in interface MutablePropertyDataSet

Returns:

true if the dataset has been made immutable.

checkImmutable

protected final void checkImmutable()

here is the one place where we check immutable, and we can make this throw an exception once things look stable.

newDataSet

protected static DodsVarDataSet newDataSet(opendap.dap.DArray z,
                                           java.util.Map<java.lang.String,java.lang.Object> properties)