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

Implemented Interfaces:: Cloneable, Dataset, EventListener, PublicCloneable, Serializable, Dataset, ObjectInputValidation, Serializable, SeriesChangeListener, SeriesDataset, XYDataset, XYZDataset

public class DefaultXYZDataset

extends AbstractXYZDataset

implements XYZDataset, PublicCloneable

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

Since:: 1.0.2

Constructor Summary
`DefaultXYZDataset()` Creates a new `DefaultXYZDataset` instance, initially containing no data.

Method Summary
`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.xy.AbstractXYZDataset
`getZValue`

Methods inherited from class org.jfree.data.xy.AbstractXYDataset
`getDomainOrder`, `getXValue`, `getYValue`

Methods inherited from class org.jfree.data.general.AbstractSeriesDataset
`getSeriesCount`, `getSeriesKey`, `indexOf`, `seriesChanged`

Methods inherited from class org.jfree.data.general.AbstractDataset
`addChangeListener`, `clone`, `fireDatasetChanged`, `getGroup`, `hasListener`, `notifyListeners`, `removeChangeListener`, `setGroup`, `validateObject`

DefaultXYZDataset

public DefaultXYZDataset()

Creates a new DefaultXYZDataset instance, initially containing no data.

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).

clone

public Object clone()
            throws CloneNotSupportedException

Creates an independent copy of this dataset.
Overrides:
clone in interface AbstractDataset
Returns:
The cloned dataset.

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.

Parameters:
obj - the object (null permitted).
Returns:
A boolean.

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 interface 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.

getSeriesCount

public int getSeriesCount()

Returns the number of series in the dataset.
Specified by:
getSeriesCount in interface SeriesDataset
Overrides:
getSeriesCount in interface AbstractSeriesDataset
Returns:
The series count.

getSeriesKey

public Comparable getSeriesKey(int series)

Returns the key for a series.
Specified by:
getSeriesKey in interface SeriesDataset
Overrides:
getSeriesKey in interface AbstractSeriesDataset
Parameters:
series - the series index (in the range 0 to getSeriesCount() - 1).
Returns:
The key for the series.

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.
See Also:
getXValue(int,int)

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 interface 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.
See Also:
getX(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.
See Also:
getX(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 interface 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.
See Also:
getY(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.
See Also:
getZ(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 interface 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.
See Also:
getZ(int,int)

hashCode

public int hashCode()

Returns a hash code for this instance.
Returns:
A hash code.

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 interface AbstractSeriesDataset
Parameters:
seriesKey - the series key (null permitted).
Returns:
The index, or -1.

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).

Overview Package Class Use Source Tree Index Deprecated About
Prev Class \| Next Class	Frames \| No Frames
Summary: Nested \| Field \| Method \| Constr	Detail: Nested \| Field \| Method \| Constr