de.gsi.dataset.spi

Class AbstractDataSet<D extends AbstractStylable<D>>

java.lang.Object

de.gsi.dataset.spi.AbstractStylable<D>

de.gsi.dataset.spi.AbstractDataSet<D>

Type Parameters:

D - java generics handling of DataSet for derived classes (needed for fluent design)

All Implemented Interfaces:

DataSet, DataSetMetaData, EventSource

Direct Known Subclasses:

AbstractDataSet3D, AbstractErrorDataSet, AveragingDataSet, DoubleDataSet, FloatDataSet, FragmentedDataSet, LabelledMarkerDataSet, ListDataSet, WrappedDataSet

public abstract class AbstractDataSet<D extends AbstractStylable<D>>
extends AbstractStylable<D>
implements DataSet, DataSetMetaData

The abstract implementation of DataSet interface that provides implementation of some methods.

• It maintains the name of the DataSet
• It maintains a list of DataSetListener objects and provides methods that can be used to dispatch DataSetEvent events.
• It maintains ranges of X and Y values.
• It gives a possibility to specify an undefined value.

Field Summary

Fields

Modifier and Type	Field and Description
protected StringHashMapList	dataLabels
protected StringHashMapList	dataStyles
protected EditConstraints	editConstraints
protected ArrayList<String>	errorList
protected ArrayList<String>	infoList
protected ReentrantLock	lock
protected Map<String,String>	metaInfoMap
protected String	name
protected List<EventListener>	updateListeners
protected ArrayList<String>	warningList
protected DataRange	xRange
protected DataRange	yRange

Fields inherited from interface de.gsi.dataset.DataSetMetaData

TAG_GAIN_RANGE, TAG_OVERSHOOT, TAG_UNDERSHOOT

Constructor Summary

Constructors

Constructor and Description
AbstractDataSet(String name) default constructor

Method Summary

Modifier and Type	Method and Description
String	addDataLabel(int index, String label) adds a custom new data label for a point The label can be used as a category name if CategoryStepsDefinition is used or for annotations displayed for data points.
String	addDataStyle(int index, String style) A string representation of the CSS style associated with this specific DataSet data point.
protected int	binarySearchX(double search, int indexMin, int indexMax)
protected int	binarySearchY(double search, int indexMin, int indexMax)
D	clearMetaInfo()
protected D	computeLimits() Computes limits (ranges) of this DataSet.
D	fireInvalidated(UpdateEvent event) Notifies listeners that the data has been invalidated.
int	getDataCount(double xmin, double xmax) Gets the number of data points in the range xmin to xmax.
String	getDataLabel(int index) Returns label of a data point specified by the index.
StringHashMapList	getDataLabelMap()
StringHashMapList	getDataStyleMap()
EditConstraints	getEditConstraints()
List<String>	getErrorList()
List<String>	getInfoList()
Map<String,String>	getMetaInfo()
String	getName() Gets the name of the data set.
String	getStyle(int index) A string representation of the CSS style associated with this specific DataSet data point.
protected D	getThis()
Double	getUndefValue() Returns the value for undefined data points.
List<String>	getWarningList()
int	getXIndex(double x) Gets the index of the data point closest to the given x coordinate.
double	getXMax() Gets the maximum x value of the data set.
double	getXMin() Gets the minimum x value of the data set.
DataRange	getXRange()
int	getYIndex(double y) Gets the first index of the data point closest to the given y coordinate.
double	getYMax() Gets the maximum y value of the data set.
double	getYMin() Gets the minimum y value of the data set.
DataRange	getYRange()
boolean	isAutoNotification() Checks it automatic notification is enabled.
D	lock() Locks access to the data set.
protected int	minNeigbourSearchX(double search, int indexMin, int indexMax)
String	removeDataLabel(int index) remove a custom data label for a point The label can be used as a category name if CategoryStepsDefinition is used or for annotations displayed for data points.
String	removeStyle(int index) A string representation of the CSS style associated with this specific DataSet data point.
D	setAutoNotifaction(boolean flag) Set the automatic notification of invalidation listeners.
D	setEditConstraints(EditConstraints constraints)
D	setName(String name) Sets the name of data set (meta data)
String	toString()
D	unlock() Unlock the data set.
List<EventListener>	updateEventListener()

Methods inherited from class de.gsi.dataset.spi.AbstractStylable

getStyle, setStyle

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.gsi.dataset.DataSet

getDataCount, getStyle, getValue, getX, getXValues, getY, getYValues, setStyle

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

addListener, invokeListener, invokeListener, removeListener

Field Detail

name

protected String name

updateListeners

protected final List<EventListener> updateListeners

lock

protected final ReentrantLock lock

xRange

protected DataRange xRange

yRange

protected DataRange yRange

dataLabels

protected StringHashMapList dataLabels

dataStyles

protected StringHashMapList dataStyles

infoList

protected ArrayList<String> infoList

warningList

protected ArrayList<String> warningList

errorList

protected ArrayList<String> errorList

editConstraints

protected EditConstraints editConstraints

metaInfoMap

protected final Map<String,String> metaInfoMap

Constructor Detail

AbstractDataSet

public AbstractDataSet(String name)

default constructor

Parameters:

name - the default name of the data set (meta data)

Method Detail

getThis

protected D getThis()

Overrides:

getThis in class AbstractStylable<D extends AbstractStylable<D>>

setName

public D setName(String name)

Sets the name of data set (meta data)

Parameters:

name - the new name

Returns:

itself (fluent design)

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

lock

public D lock()

Description copied from interface: DataSet

Locks access to the data set. Multi-threaded applications should lock the data set before setting the data.

Specified by:

lock in interface DataSet

Returns:

itself (fluent interface)

unlock

public D unlock()

Description copied from interface: DataSet

Unlock the data set.

Specified by:

unlock in interface DataSet

Returns:

itself (fluent interface)

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)

setAutoNotifaction

public D setAutoNotifaction(boolean flag)

Description copied from interface: DataSet

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.

Specified by:

setAutoNotifaction in interface DataSet

Parameters:

flag - true for automatic notification

Returns:

itself (fluent interface)

isAutoNotification

public boolean isAutoNotification()

Description copied from interface: DataSet

Checks it automatic notification is enabled.

Specified by:

isAutoNotification in interface DataSet

Returns:

true if automatic notification is enabled

getUndefValue

public Double getUndefValue()

Description copied from interface: DataSet

Returns the value for undefined data points.

Specified by:

getUndefValue in interface DataSet

Returns:

the value indicating undefined data points

getXMin

public double getXMin()

Gets the minimum x value of the data set.

Specified by:

getXMin in interface DataSet

Returns:

minimum x value

getXMax

public double getXMax()

Gets the maximum x value of the data set.

Specified by:

getXMax in interface DataSet

Returns:

maximum x value

getYMin

public double getYMin()

Gets the minimum y value of the data set.

Specified by:

getYMin in interface DataSet

Returns:

minimum y value

getYMax

public double getYMax()

Gets the maximum y value of the data set.

Specified by:

getYMax in interface DataSet

Returns:

maximum y value

getXRange

public DataRange getXRange()

Returns:

horizontal range of data set

getYRange

public DataRange getYRange()

Returns:

vertical range of data set

computeLimits

protected D computeLimits()

Computes limits (ranges) of this DataSet.

Returns:

itself (fluent design)

getDataCount

public int getDataCount(double xmin,
                        double xmax)

Gets the number of data points in the range xmin to xmax.

Specified by:

getDataCount in interface DataSet

Parameters:

xmin - the lower end of the range

xmax - the upper end of the range

Returns:

the number of data points

getXIndex

public int getXIndex(double x)

Gets the index of the data point closest to the given x 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:

getXIndex in interface DataSet

Parameters:

x - the x position of the data point

Returns:

the index of the data point

getYIndex

public int getYIndex(double y)

Gets the first index of the data point closest to the given y coordinate.

Specified by:

getYIndex in interface DataSet

Parameters:

y - the y position of the data point

Returns:

the index of the data point

binarySearchX

protected int binarySearchX(double search,
                            int indexMin,
                            int indexMax)

binarySearchY

protected int binarySearchY(double search,
                            int indexMin,
                            int indexMax)

minNeigbourSearchX

protected int minNeigbourSearchX(double search,
                                 int indexMin,
                                 int indexMax)

fireInvalidated

public D fireInvalidated(UpdateEvent event)

Notifies listeners that the data has been invalidated. If the data is added to the chart, it triggers repaint.

Parameters:

event - the change event

Returns:

itself (fluent design)

toString

public String toString()

Overrides:

toString in class Object

getDataLabelMap

public StringHashMapList getDataLabelMap()

Returns:

data label map for given data point

getDataStyleMap

public StringHashMapList getDataStyleMap()

Returns:

data style map (CSS-styling)

addDataLabel

public String addDataLabel(int index,
                           String label)

adds a custom new data label for a point The label can be used as a category name if CategoryStepsDefinition is used or for annotations displayed for data points.

Parameters:

index - of the data point

label - for the data point specified by the index

Returns:

the previously set label or null if no label has been specified

removeDataLabel

public String removeDataLabel(int index)

remove a custom data label for a point The label can be used as a category name if CategoryStepsDefinition is used or for annotations displayed for data points.

Parameters:

index - of the data point

Returns:

the previously set label or null if no label has been specified

getDataLabel

public String getDataLabel(int index)

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 - of the data label

Returns:

data point label specified by the index or null if no label has been specified

addDataStyle

public String addDataStyle(int index,
                           String style)

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

Parameters:

index - the index of the specific data point

style - string for the data point specific CSS-styling

Returns:

itself (fluent interface)

removeStyle

public String removeStyle(int index)

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

Parameters:

index - the index of the specific data point

Returns:

itself (fluent interface)

getStyle

public String getStyle(int index)

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 index of the specific data point

Returns:

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

getEditConstraints

public EditConstraints getEditConstraints()

setEditConstraints

public D setEditConstraints(EditConstraints constraints)

getMetaInfo

public Map<String,String> getMetaInfo()

Specified by:

getMetaInfo in interface DataSetMetaData

clearMetaInfo

public D clearMetaInfo()

getInfoList

public List<String> getInfoList()

Specified by:

getInfoList in interface DataSetMetaData

getWarningList

public List<String> getWarningList()

Specified by:

getWarningList in interface DataSetMetaData

getErrorList

public List<String> getErrorList()

Specified by:

getErrorList in interface DataSetMetaData