de.gsi.dataset.spi

Class TransposedDataSet

java.lang.Object

de.gsi.dataset.spi.TransposedDataSet

All Implemented Interfaces:

DataSet, EventSource, Serializable

Direct Known Subclasses:

TransposedDataSet.TransposedDataSet3D

public class TransposedDataSet
extends Object
implements DataSet

Allows permutation of the axes of an underlying DataSet, for applications like: - transposed display - reduction of multi-dimensional DataSets to lower dimensions To be able to handle different DataSet Interface types, the constructors are private and only accessible via the static class methods, which return the correct sub-type.

Author:

Alexander Krimm

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TransposedDataSet.TransposedDataSet3D TODO: allow permutations to change number of grid dimensions, while enforcing contract, that all grid axes must come before data axes.

Field Summary

Fields

Modifier and Type	Field and Description
protected DataSet	dataSet
protected int[]	permutation

Fields inherited from interface de.gsi.dataset.DataSet

DIM_X, DIM_Y, DIM_Z

Method Summary

Modifier and Type	Method and Description
AtomicBoolean	autoNotification() Set the automatic notification of invalidation listeners.
double	get(int dimIndex, int index) Gets the x value of the data point with the index i
AxisDescription	getAxisDescription(int dimIndex) Return the axis description of the i-th axis.
List<AxisDescription>	getAxisDescriptions()
int	getDataCount(int dimIndex) Get the number of data points in the data set for a specific dimension.
String	getDataLabel(int index) Returns label of a data point specified by the index.
int	getDimension()
int	getIndex(int dimIndex, double value) Gets the index of the data point closest to the given 'value' coordinate.
String	getName() Gets the name of the data set.
int[]	getPermutation()
String	getStyle() A string representation of the CSS style associated with this specific DataSet.
String	getStyle(int index) A string representation of the CSS style associated with this specific DataSet data point.
double	getValue(int dimIndex, double x) Gets the interpolated y value of the data point for given x coordinate
double[]	getValues(int dimIndex)
boolean	isTransposed()
<D extends DataSet> DataSetLock<D>	lock()
static TransposedDataSet	permute(DataSet dataSet, int[] permutation)
DataSet	recomputeLimits(int dimension)
void	setPermutation(int[] permutation)
DataSet	setStyle(String style) A string representation of the CSS style associated with this specific DataSet.
void	setTransposed(boolean transposed)
static TransposedDataSet	transpose(DataSet dataSet)
static TransposedDataSet	transpose(DataSet dataSet, boolean transpose)
List<EventListener>	updateEventListener()

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.gsi.dataset.DataSet

getDataCount

Methods inherited from interface de.gsi.dataset.event.EventSource

addListener, invokeListener, invokeListener, invokeListener, isAutoNotification, removeListener

Field Detail

dataSet

protected final DataSet dataSet

permutation

protected int[] permutation

Method Detail

autoNotification

public AtomicBoolean autoNotification()

Description copied from interface: EventSource

Set the automatic notification of invalidation listeners. In general, data sets should notify registered invalidation listeners, if the data in the data set has changed. Charts usually register an invalidation listener with the data set to be notified of any changes and update the charts. Setting the automatic notification to false, allows applications to prevent this behaviour, in case data sets are updated multiple times during an acquisition cycle but the chart update is only required at the end of the cycle. true for automatic notification

Specified by:

autoNotification in interface EventSource

Returns:

the atomic boolean

get

public double get(int dimIndex,
                  int index)

Description copied from interface: DataSet

Gets the x value of the data point with the index i

Specified by:

get in interface DataSet

Parameters:

dimIndex - the dimension index (ie. '0' equals 'X', '1' equals 'Y')

index - data point index

Returns:

the x value

getAxisDescriptions

public List<AxisDescription> getAxisDescriptions()

Specified by:

getAxisDescriptions in interface DataSet

Returns:

axis descriptions of the primary and secondary axes

getAxisDescription

public AxisDescription getAxisDescription(int dimIndex)

Description copied from interface: DataSet

Return the axis description of the i-th axis.

Specified by:

getAxisDescription in interface DataSet

Parameters:

dimIndex - 0: X-Axis, 1: Y-Axis, ...

Returns:

Axis Label

getDataCount

public int getDataCount(int dimIndex)

Description copied from interface: DataSet

Get the number of data points in the data set for a specific dimension.

Specified by:

getDataCount in interface DataSet

Parameters:

dimIndex - the dimension index (ie. '0' equals 'X', '1' equals 'Y')

Returns:

the number of data points

getDataLabel

public String getDataLabel(int index)

Description copied from interface: DataSet

Returns label of a data point specified by the index. The label can be used as a category name if CategoryStepsDefinition is used or for annotations displayed for data points.

Specified by:

getDataLabel in interface DataSet

Parameters:

index - the data index

Returns:

label of a data point specified by the index or null if none label has been specified for this data point.

getDimension

public int getDimension()

Specified by:

getDimension in interface DataSet

Returns:

number of dimensions

getIndex

public int getIndex(int dimIndex,
                    double value)

Description copied from interface: DataSet

Gets the index of the data point closest to the given 'value' coordinate. The index returned may be less then zero or larger the the number of data points in the data set, if the x coordinate lies outside the range of the data set.

Specified by:

getIndex in interface DataSet

Parameters:

dimIndex - the dimension index (ie. '0' equals 'X', '1' equals 'Y')

value - the data point coordinate to search for

Returns:

the index of the data point

getName

public String getName()

Description copied from interface: DataSet

Gets the name of the data set.

Specified by:

getName in interface DataSet

Returns:

the name of the DataSet

getPermutation

public int[] getPermutation()

getStyle

public String getStyle()

Description copied from interface: DataSet

A string representation of the CSS style associated with this specific DataSet. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.

Specified by:

getStyle in interface DataSet

Returns:

user-specific data set style description (ie. may be set by user)

getStyle

public String getStyle(int index)

Description copied from interface: DataSet

A string representation of the CSS style associated with this specific DataSet data point. @see #getStyle()

Specified by:

getStyle in interface DataSet

Parameters:

index - the specific data point index

Returns:

user-specific data set style description (ie. may be set by user)

getValue

public double getValue(int dimIndex,
                       double x)

Description copied from interface: DataSet

Gets the interpolated y value of the data point for given x coordinate

Specified by:

getValue in interface DataSet

Parameters:

dimIndex - the dimension index (ie. '0' equals 'X', '1' equals 'Y')

x - the new x coordinate

Returns:

the y value

getValues

public double[] getValues(int dimIndex)

Specified by:

getValues in interface DataSet

Parameters:

dimIndex - the dimension index (ie. '0' equals 'X', '1' equals 'Y')

Returns:

the x value array

isTransposed

public boolean isTransposed()

lock

public <D extends DataSet> DataSetLock<D> lock()

Specified by:

lock in interface DataSet

Type Parameters:

D - generics (fluent design)

Returns:

Read-Write Lock to guard the DataSet

See Also:

DataSetLock

recomputeLimits

public DataSet recomputeLimits(int dimension)

Specified by:

recomputeLimits in interface DataSet

setPermutation

public void setPermutation(int[] permutation)

setStyle

public DataSet setStyle(String style)

Description copied from interface: DataSet

A string representation of the CSS style associated with this specific DataSet. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.

Specified by:

setStyle in interface DataSet

Parameters:

style - the new user-specific style

Returns:

itself (fluent interface)

setTransposed

public void setTransposed(boolean transposed)

updateEventListener

public List<EventListener> updateEventListener()

Specified by:

updateEventListener in interface EventSource

Returns:

list containing all update event listener (needs to be provided by implementing class)

permute

public static TransposedDataSet permute(DataSet dataSet,
                                        int[] permutation)

transpose

public static TransposedDataSet transpose(DataSet dataSet)

transpose

public static TransposedDataSet transpose(DataSet dataSet,
                                          boolean transpose)