ilog.views.chart.data

Class IlvXSortedDataSet

java.lang.Object

ilog.views.chart.data.IlvAbstractDataSet

ilog.views.chart.data.IlvFilterDataSet

ilog.views.chart.data.IlvXSortedDataSet

All Implemented Interfaces:

IlvDataSet, IlvBatchable, Serializable, Cloneable

public class IlvXSortedDataSet
extends IlvFilterDataSet
implements Cloneable

This class encapsulates a data set and sorts its data points so that the X values are in ascending order.

All the immediate data access methods on this data set are implemented by an indirection to the underlying data set.

An instance of this class automatically propagates notification events from the underlying data set to its own listeners.

Since:

JViews 8.1

See Also:

IlvDataSet.isXValuesSorted(), Serialized Form

Field Summary

Fields inherited from class ilog.views.chart.data.IlvAbstractDataSet

DEFAULT_UNDEF_VALUE

Constructor Summary

Constructors

Constructor and Description
IlvXSortedDataSet() Creates a sorted data set without any underlying data set.
IlvXSortedDataSet(IlvDataSet dataSet) Creates a sorted data set.

Method Summary

Modifier and Type	Method and Description
void	addData(double x, double y) This method adds the point to the end of the underlying data set.
Object	clone() Returns a copy of this object.
void	disconnect() Drops references to objects to help garbage collection.
void	dispose() Cleans up this data set and drops references to objects to help garbage collection.
String	getDataLabel(int pos) The implementation here delegates to the underlying data set, applying index conversion.
double	getXData(int pos) The implementation here delegates to the underlying data set, applying index conversion.
IlvDataInterval	getXRange(IlvDataInterval range) The implementation here looks at the first and last X values.
double	getYData(int pos) The implementation here delegates to the underlying data set, applying index conversion.
boolean	isXValuesSorted() The implementation here always returns true.
void	noteAfterDataChanged(int firstIdx, int lastIdx) Reacts on an AFTER_DATA_CHANGED event from the underlying data set.
void	noteBeforeDataChanged(int firstIdx, int lastIdx) Reacts on a BEFORE_DATA_CHANGED event from the underlying data set.
void	noteDataAdded(int firstIdx, int lastIdx) Reacts on a DATA_ADDED event from the underlying data set.
void	noteDataChanged(int firstIdx, int lastIdx) Reacts on a DATA_CHANGED event from the underlying data set.
void	noteDataLabelChanged(int firstIdx, int lastIdx) Reacts on a DATA_LABEL_CHANGED event from the underlying data set.
void	noteFullUpdate() Reacts on a FULL_UPDATE event from the underlying data set.
void	setData(int pos, double x, double y) The implementation here delegates to the underlying data set, applying index conversion.

Methods inherited from class ilog.views.chart.data.IlvFilterDataSet

getDataCount, getFilteredDataSet, getName, getUndefValue, getYRange, isEditable, noteBatchBegin, noteBatchEnd, noteDataSetPropertyChanged, setFilteredDataSet, setName

Methods inherited from class ilog.views.chart.data.IlvAbstractDataSet

addDataSetListener, computeLimits, computeMinimumXDifference, dataAdded, dataChanged, endBatch, fireDataAddedEvent, fireDataChangedEvent, fireDataSetContentsEvent, fireDataSetPropertyEvent, getData, getDataBetween, getDataInside, getDataInside, getMinimumXDifference, getProperty, getXRange, getYRange, invalidateLimits, invalidateLimits, invalidateLimits, isBatched, isXRangeIncludingUndefinedPoints, putProperty, removeDataSetListener, setLimitsValid, setUndefValue, setXRangeIncludingUndefinedPoints, startBatch, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvXSortedDataSet

public IlvXSortedDataSet()

Creates a sorted data set without any underlying data set. You need to call setFilteredDataSet in order to specify the underlying data set.

IlvXSortedDataSet

public IlvXSortedDataSet(IlvDataSet dataSet)

Creates a sorted data set.

Parameters:

dataSet - The underlying data set.

Method Detail

getXData

public double getXData(int pos)

The implementation here delegates to the underlying data set, applying index conversion.

Specified by:

getXData in interface IlvDataSet

Overrides:

getXData in class IlvFilterDataSet

Parameters:

pos - a data point index, >= 0, < getDataCount()

getYData

public double getYData(int pos)

The implementation here delegates to the underlying data set, applying index conversion.

Specified by:

getYData in interface IlvDataSet

Overrides:

getYData in class IlvFilterDataSet

Parameters:

pos - a data point index, >= 0, < getDataCount()

setData

public void setData(int pos,
                    double x,
                    double y)

The implementation here delegates to the underlying data set, applying index conversion.

Specified by:

setData in interface IlvDataSet

Overrides:

setData in class IlvFilterDataSet

Parameters:

pos - a data point index, >= 0, < getDataCount()

x - the new x coordinate of the point (if this data set supports setting arbitrary x values)

y - the new y coordinate of the point

addData

public void addData(double x,
                    double y)

This method adds the point to the end of the underlying data set. It may appear at any position in this data set.

Specified by:

addData in interface IlvDataSet

Overrides:

addData in class IlvFilterDataSet

Parameters:

x - the x coordinate of the new point

y - the y coordinate of the new point

getDataLabel

public String getDataLabel(int pos)

The implementation here delegates to the underlying data set, applying index conversion.

Specified by:

getDataLabel in interface IlvDataSet

Overrides:

getDataLabel in class IlvFilterDataSet

Parameters:

pos - a data point index, >= 0, < getDataCount()

getXRange

public IlvDataInterval getXRange(IlvDataInterval range)

The implementation here looks at the first and last X values.

Specified by:

getXRange in interface IlvDataSet

Overrides:

getXRange in class IlvFilterDataSet

See Also:

IlvAbstractDataSet.isXRangeIncludingUndefinedPoints()

isXValuesSorted

public boolean isXValuesSorted()

The implementation here always returns true.

Specified by:

isXValuesSorted in interface IlvDataSet

Overrides:

isXValuesSorted in class IlvFilterDataSet

noteBeforeDataChanged

public void noteBeforeDataChanged(int firstIdx,
                                  int lastIdx)

Reacts on a BEFORE_DATA_CHANGED event from the underlying data set.

Overrides:

noteBeforeDataChanged in class IlvFilterDataSet

Parameters:

firstIdx - Index of first point that will be modified.

lastIdx - Index of last point that will be modified.

noteAfterDataChanged

public void noteAfterDataChanged(int firstIdx,
                                 int lastIdx)

Reacts on an AFTER_DATA_CHANGED event from the underlying data set.

Overrides:

noteAfterDataChanged in class IlvFilterDataSet

Parameters:

firstIdx - Index of first point that has been modified.

lastIdx - Index of last point that has been modified.

noteDataChanged

public void noteDataChanged(int firstIdx,
                            int lastIdx)

Reacts on a DATA_CHANGED event from the underlying data set.

Overrides:

noteDataChanged in class IlvFilterDataSet

Parameters:

firstIdx - Index of first point that was modified.

lastIdx - Index of last point that was modified.

noteDataAdded

public void noteDataAdded(int firstIdx,
                          int lastIdx)

Reacts on a DATA_ADDED event from the underlying data set.

Overrides:

noteDataAdded in class IlvFilterDataSet

Parameters:

firstIdx - Index of first point that was added.

lastIdx - Index of last point that was added.

noteDataLabelChanged

public void noteDataLabelChanged(int firstIdx,
                                 int lastIdx)

Reacts on a DATA_LABEL_CHANGED event from the underlying data set.

Overrides:

noteDataLabelChanged in class IlvFilterDataSet

Parameters:

firstIdx - Index of first point that was modified.

lastIdx - Index of last point that was modified.

noteFullUpdate

public void noteFullUpdate()

Reacts on a FULL_UPDATE event from the underlying data set.

Overrides:

noteFullUpdate in class IlvFilterDataSet

dispose

public void dispose()

Cleans up this data set and drops references to objects to help garbage collection.

Note: After calling this function, this data set is no longer functional.

Overrides:

dispose in class IlvFilterDataSet

disconnect

public void disconnect()

Drops references to objects to help garbage collection.

Note: After calling this function, and after some changes occurred in the underlying data set, this data set is no longer functional.

Overrides:

disconnect in class IlvFilterDataSet

clone

public Object clone()

Returns a copy of this object.

Overrides:

clone in class IlvFilterDataSet