org.das2.qds

Interface WritableDataSet

All Superinterfaces:

MutablePropertyDataSet, QDataSet

All Known Implementing Classes:

ArrayDataSet, AsciiDataSet, BDataSet, BufferDataSet, ByteDataSet, DDataSet, DodsVarDataSet, DodsVarDataSet.DoubleArray, DodsVarDataSet.EpochStringArray, DodsVarDataSet.FloatArray, DodsVarDataSet.Int16Array, DodsVarDataSet.Int32Array, DodsVarDataSet.NominalStringArray, DoubleDataSet, FDataSet, FloatDataSet, IDataSet, Int24DataSet, IntDataSet, LDataSet, LongDataSet, NybbleDataSet, SDataSet, ShortDataSet, SparseDataSet, TimeDataSet, TrDDataSet, TrFDataSet, TrLDataSet, TruncatedFloatDataSet, UByteDataSet, UInt24DataSet, UIntDataSet, UShortDataSet, VaxFloatDataSet, WritableDataSetWrapper, WritableJoinDataSet

public interface WritableDataSet
extends MutablePropertyDataSet

Some QDataSets are be mutable as well, meaning their values can be assigned as well as read. In addition to the value() method they have putValue() methods. These datasets cannot be written to once they are made immutable by calling the makeImmutable() of MutablePropertyDataSet, and clients must check the isImmutable flag or call Ops.maybeCopy when they need write access to the data. Mutable datasets warning: No dataset should be mutable once it is accessible to the rest of the system. This would require clients make defensive copies which would seriously degrade performance.

See Also:

Ops.maybeCopy(org.das2.qds.QDataSet), MutablePropertyDataSet.isImmutable()

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_BINS_MIN_MAX_INCLUSIVE, 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_RENDER_TYPE_TRIANGLE_MESH, VALUE_SCALE_TYPE_LINEAR, VALUE_SCALE_TYPE_LOG, VERSION, WEIGHTS

Method Summary

Modifier and Type	Method and Description
void	putValue(double d) put a value into the rank 0 dataset.
void	putValue(int i0, double d) put a value into the rank 1 dataset.
void	putValue(int i0, int i1, double d) put a value into the rank 2 dataset.
void	putValue(int i0, int i1, int i2, double d) put a value into the rank 3 dataset.
void	putValue(int i0, int i1, int i2, int i3, double d) put a value into the rank 4 dataset.

Methods inherited from interface org.das2.qds.MutablePropertyDataSet

isImmutable, makeImmutable, putProperty, putProperty

Methods inherited from interface org.das2.qds.QDataSet

capability, length, length, length, length, property, property, rank, slice, svalue, trim, value, value, value, value, value

Method Detail

putValue

void putValue(double d)

put a value into the rank 0 dataset.

Parameters:

d - the value

Throws:

java.lang.IllegalArgumentException - if the dataset immutable or is not rank 0.

putValue

void putValue(int i0,
              double d)

put a value into the rank 1 dataset.

Parameters:

i0 - the index

d - the value

Throws:

java.lang.IllegalArgumentException - if the dataset immutable or is not rank 1.

putValue

void putValue(int i0,
              int i1,
              double d)

put a value into the rank 2 dataset.

Parameters:

i0 - the index

i1 - the index

d - the value

Throws:

java.lang.IllegalArgumentException - if the dataset immutable or is not rank 2.

putValue

void putValue(int i0,
              int i1,
              int i2,
              double d)

put a value into the rank 3 dataset.

Parameters:

i0 - the index

i1 - the index

i2 - the index

d - the value

Throws:

java.lang.IllegalArgumentException - if the dataset immutable or is not rank 3.

putValue

void putValue(int i0,
              int i1,
              int i2,
              int i3,
              double d)

put a value into the rank 4 dataset.

Parameters:

i0 - the index

i1 - the index

i2 - the index

i3 - the index

d - the value

Throws:

java.lang.IllegalArgumentException - if the dataset immutable or is not rank 4.