org.jfree.data.xy

Class DefaultXYZDataset

java.lang.Object

org.jfree.data.general.AbstractDataset

org.jfree.data.general.AbstractSeriesDataset

org.jfree.data.xy.AbstractXYDataset

org.jfree.data.xy.AbstractXYZDataset

org.jfree.data.xy.DefaultXYZDataset

All Implemented Interfaces:

ObjectInputValidation, Serializable, Cloneable, EventListener, Dataset, SeriesChangeListener, SeriesDataset, XYDataset, XYZDataset, org.jfree.util.PublicCloneable

public class DefaultXYZDataset
extends AbstractXYZDataset
implements XYZDataset, org.jfree.util.PublicCloneable

A default implementation of the XYZDataset interface that stores data values in arrays of double primitives.

Since:

1.0.2

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DefaultXYZDataset() Creates a new DefaultXYZDataset instance, initially containing no data.

Method Summary

Modifier and Type	Method and Description
void	addSeries(Comparable seriesKey, double[][] data) Adds a series or if a series with the same key already exists replaces the data for that series, then sends a DatasetChangeEvent to all registered listeners.
Object	clone() Creates an independent copy of this dataset.
boolean	equals(Object obj) Tests this DefaultXYDataset instance for equality with an arbitrary object.
DomainOrder	getDomainOrder() Returns the order of the domain (x-) values in the dataset.
int	getItemCount(int series) Returns the number of items in the specified series.
int	getSeriesCount() Returns the number of series in the dataset.
Comparable	getSeriesKey(int series) Returns the key for a series.
Number	getX(int series, int item) Returns the x-value for an item within a series.
double	getXValue(int series, int item) Returns the x-value for an item within a series.
Number	getY(int series, int item) Returns the y-value for an item within a series.
double	getYValue(int series, int item) Returns the y-value for an item within a series.
Number	getZ(int series, int item) Returns the z-value for an item within a series.
double	getZValue(int series, int item) Returns the z-value for an item within a series.
int	hashCode() Returns a hash code for this instance.
int	indexOf(Comparable seriesKey) Returns the index of the series with the specified key, or -1 if there is no such series in the dataset.
void	removeSeries(Comparable seriesKey) Removes a series from the dataset, then sends a DatasetChangeEvent to all registered listeners.

Methods inherited from class org.jfree.data.general.AbstractSeriesDataset

seriesChanged

Methods inherited from class org.jfree.data.general.AbstractDataset

addChangeListener, getGroup, getNotify, hasListener, removeChangeListener, setGroup, setNotify, validateObject

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jfree.data.general.Dataset

addChangeListener, getGroup, removeChangeListener, setGroup

Constructor Detail

DefaultXYZDataset

public DefaultXYZDataset()

Creates a new DefaultXYZDataset instance, initially containing no data.

Method Detail

getSeriesCount

public int getSeriesCount()

Returns the number of series in the dataset.

Specified by:

getSeriesCount in interface SeriesDataset

Specified by:

getSeriesCount in class AbstractSeriesDataset

Returns:

The series count.

getSeriesKey

public Comparable getSeriesKey(int series)

Returns the key for a series.

Specified by:

getSeriesKey in interface SeriesDataset

Specified by:

getSeriesKey in class AbstractSeriesDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

Returns:

The key for the series.

Throws:

IllegalArgumentException - if series is not in the specified range.

indexOf

public int indexOf(Comparable seriesKey)

Returns the index of the series with the specified key, or -1 if there is no such series in the dataset.

Specified by:

indexOf in interface SeriesDataset

Overrides:

indexOf in class AbstractSeriesDataset

Parameters:

seriesKey - the series key (null permitted).

Returns:

The index, or -1.

getDomainOrder

public DomainOrder getDomainOrder()

Returns the order of the domain (x-) values in the dataset. In this implementation, we cannot guarantee that the x-values are ordered, so this method returns DomainOrder.NONE.

Specified by:

getDomainOrder in interface XYDataset

Overrides:

getDomainOrder in class AbstractXYDataset

Returns:

DomainOrder.NONE.

getItemCount

public int getItemCount(int series)

Returns the number of items in the specified series.

Specified by:

getItemCount in interface XYDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

Returns:

The item count.

Throws:

IllegalArgumentException - if series is not in the specified range.

getXValue

public double getXValue(int series,
                        int item)

Returns the x-value for an item within a series.

Specified by:

getXValue in interface XYDataset

Overrides:

getXValue in class AbstractXYDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

item - the item index (in the range 0 to getItemCount(series)).

Returns:

The x-value.

Throws:

ArrayIndexOutOfBoundsException - if series is not within the specified range.

ArrayIndexOutOfBoundsException - if item is not within the specified range.

See Also:

getX(int, int)

getX

public Number getX(int series,
                   int item)

Returns the x-value for an item within a series.

Specified by:

getX in interface XYDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

item - the item index (in the range 0 to getItemCount(series)).

Returns:

The x-value.

Throws:

ArrayIndexOutOfBoundsException - if series is not within the specified range.

ArrayIndexOutOfBoundsException - if item is not within the specified range.

See Also:

getXValue(int, int)

getYValue

public double getYValue(int series,
                        int item)

Returns the y-value for an item within a series.

Specified by:

getYValue in interface XYDataset

Overrides:

getYValue in class AbstractXYDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

item - the item index (in the range 0 to getItemCount(series)).

Returns:

The y-value.

Throws:

ArrayIndexOutOfBoundsException - if series is not within the specified range.

ArrayIndexOutOfBoundsException - if item is not within the specified range.

See Also:

getY(int, int)

getY

public Number getY(int series,
                   int item)

Returns the y-value for an item within a series.

Specified by:

getY in interface XYDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

item - the item index (in the range 0 to getItemCount(series)).

Returns:

The y-value.

Throws:

ArrayIndexOutOfBoundsException - if series is not within the specified range.

ArrayIndexOutOfBoundsException - if item is not within the specified range.

See Also:

getX(int, int)

getZValue

public double getZValue(int series,
                        int item)

Returns the z-value for an item within a series.

Specified by:

getZValue in interface XYZDataset

Overrides:

getZValue in class AbstractXYZDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

item - the item index (in the range 0 to getItemCount(series)).

Returns:

The z-value.

Throws:

ArrayIndexOutOfBoundsException - if series is not within the specified range.

ArrayIndexOutOfBoundsException - if item is not within the specified range.

See Also:

getZ(int, int)

getZ

public Number getZ(int series,
                   int item)

Returns the z-value for an item within a series.

Specified by:

getZ in interface XYZDataset

Parameters:

series - the series index (in the range 0 to getSeriesCount() - 1).

item - the item index (in the range 0 to getItemCount(series)).

Returns:

The z-value.

Throws:

ArrayIndexOutOfBoundsException - if series is not within the specified range.

ArrayIndexOutOfBoundsException - if item is not within the specified range.

See Also:

getZ(int, int)

addSeries

public void addSeries(Comparable seriesKey,
                      double[][] data)

Adds a series or if a series with the same key already exists replaces the data for that series, then sends a DatasetChangeEvent to all registered listeners.

Parameters:

seriesKey - the series key (null not permitted).

data - the data (must be an array with length 3, containing three arrays of equal length, the first containing the x-values, the second containing the y-values and the third containing the z-values).

removeSeries

public void removeSeries(Comparable seriesKey)

Removes a series from the dataset, then sends a DatasetChangeEvent to all registered listeners.

Parameters:

seriesKey - the series key (null not permitted).

equals

public boolean equals(Object obj)

Tests this DefaultXYDataset instance for equality with an arbitrary object. This method returns true if and only if:

• obj is not null;
• obj is an instance of DefaultXYDataset;
• both datasets have the same number of series, each containing exactly the same values.

Overrides:

equals in class Object

Parameters:

obj - the object (null permitted).

Returns:

A boolean.

hashCode

public int hashCode()

Returns a hash code for this instance.

Overrides:

hashCode in class Object

Returns:

A hash code.

clone

public Object clone()
             throws CloneNotSupportedException

Creates an independent copy of this dataset.

Specified by:

clone in interface org.jfree.util.PublicCloneable

Overrides:

clone in class AbstractDataset

Returns:

The cloned dataset.

Throws:

CloneNotSupportedException - if there is a problem cloning the dataset (for instance, if a non-cloneable object is used for a series key).