ucar.unidata.idv.control.chart

Class MyHistogramDataset

java.lang.Object

org.jfree.data.general.AbstractDataset

org.jfree.data.general.AbstractSeriesDataset

org.jfree.data.xy.AbstractXYDataset

org.jfree.data.xy.AbstractIntervalXYDataset

ucar.unidata.idv.control.chart.MyHistogramDataset

All Implemented Interfaces:

java.io.ObjectInputValidation, java.io.Serializable, java.lang.Cloneable, java.util.EventListener, org.jfree.data.general.Dataset, org.jfree.data.general.SeriesChangeListener, org.jfree.data.general.SeriesDataset, org.jfree.data.xy.IntervalXYDataset, org.jfree.data.xy.XYDataset, org.jfree.util.PublicCloneable

public class MyHistogramDataset
extends org.jfree.data.xy.AbstractIntervalXYDataset
implements org.jfree.data.xy.IntervalXYDataset, java.lang.Cloneable, org.jfree.util.PublicCloneable, java.io.Serializable

A dataset that can be used for creating histograms.

See Also:

SimpleHistogramDataset, Serialized Form

Constructor Summary

Constructors

Constructor and Description
MyHistogramDataset() Creates a new (empty) dataset with a default type of HistogramType.FREQUENCY.

Method Summary

Modifier and Type	Method and Description
void	addSeries(java.lang.Comparable key, double[] values, int bins) Adds a series to the dataset, using the specified number of bins.
void	addSeries(java.lang.Comparable key, double[] values, int bins, double minimum, double maximum) Adds a series to the dataset.
java.lang.Object	clone() Returns a clone of the dataset.
boolean	equals(java.lang.Object obj) Tests this dataset for equality with an arbitrary object.
java.lang.Number	getEndX(int series, int item) Returns the end value for a bin.
java.lang.Number	getEndY(int series, int item) Returns the end y-value for a bin (which is the same as the y-value, this method exists only to support the general form of the IntervalXYDataset interface).
int	getItemCount(int series) Returns the number of data items for a series.
int	getSeriesCount() Returns the number of series in the dataset.
java.lang.Comparable	getSeriesKey(int series) Returns the key for a series.
java.lang.Number	getStartX(int series, int item) Returns the start value for a bin.
java.lang.Number	getStartY(int series, int item) Returns the start y-value for a bin (which is the same as the y-value, this method exists only to support the general form of the IntervalXYDataset interface).
org.jfree.data.statistics.HistogramType	getType() Returns the histogram type.
java.lang.Number	getX(int series, int item) Returns the X value for a bin.
java.lang.Number	getY(int series, int item) Returns the y-value for a bin (calculated to take into account the histogram type).
void	removeAllSeries() Remove series
void	setType(org.jfree.data.statistics.HistogramType type) Sets the histogram type and sends a DatasetChangeEvent to all registered listeners.

Methods inherited from class org.jfree.data.xy.AbstractIntervalXYDataset

getEndXValue, getEndYValue, getStartXValue, getStartYValue

Methods inherited from class org.jfree.data.xy.AbstractXYDataset

getDomainOrder, getXValue, getYValue

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

indexOf, seriesChanged

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

addChangeListener, fireDatasetChanged, getGroup, hasListener, notifyListeners, removeChangeListener, setGroup, validateObject

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jfree.data.xy.IntervalXYDataset

getEndXValue, getEndYValue, getStartXValue, getStartYValue

Methods inherited from interface org.jfree.data.xy.XYDataset

getDomainOrder, getXValue, getYValue

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

indexOf

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

addChangeListener, getGroup, removeChangeListener, setGroup

Constructor Detail

MyHistogramDataset

public MyHistogramDataset()

Creates a new (empty) dataset with a default type of HistogramType.FREQUENCY.

Method Detail

removeAllSeries

public void removeAllSeries()

Remove series

getType

public org.jfree.data.statistics.HistogramType getType()

Returns the histogram type.

Returns:

The type (never null).

setType

public void setType(org.jfree.data.statistics.HistogramType type)

Sets the histogram type and sends a DatasetChangeEvent to all registered listeners.

Parameters:

type - the type (null not permitted).

addSeries

public void addSeries(java.lang.Comparable key,
                      double[] values,
                      int bins)

Adds a series to the dataset, using the specified number of bins.

Parameters:

key - the series key (null not permitted).

values - the values (null not permitted).

bins - the number of bins (must be at least 1).

addSeries

public void addSeries(java.lang.Comparable key,
                      double[] values,
                      int bins,
                      double minimum,
                      double maximum)

Adds a series to the dataset. Any data value falling on a bin boundary will be assigned to the lower value bin, with the exception of the lower bound of the bin range which is always assigned to the first bin.

Parameters:

key - the series key (null not permitted).

values - the raw observations.

bins - the number of bins.

minimum - the lower bound of the bin range.

maximum - the upper bound of the bin range.

getSeriesCount

public int getSeriesCount()

Returns the number of series in the dataset.

Specified by:

getSeriesCount in interface org.jfree.data.general.SeriesDataset

Specified by:

getSeriesCount in class org.jfree.data.general.AbstractSeriesDataset

Returns:

The series count.

getSeriesKey

public java.lang.Comparable getSeriesKey(int series)

Returns the key for a series.

Specified by:

getSeriesKey in interface org.jfree.data.general.SeriesDataset

Specified by:

getSeriesKey in class org.jfree.data.general.AbstractSeriesDataset

Parameters:

series - the series index (zero based).

Returns:

The series key.

getItemCount

public int getItemCount(int series)

Returns the number of data items for a series.

Specified by:

getItemCount in interface org.jfree.data.xy.XYDataset

Parameters:

series - the series index (zero based).

Returns:

The item count.

getX

public java.lang.Number getX(int series,
                             int item)

Returns the X value for a bin. This value won't be used for plotting histograms, since the renderer will ignore it. But other renderers can use it (for example, you could use the dataset to create a line chart).

Specified by:

getX in interface org.jfree.data.xy.XYDataset

Parameters:

series - the series index (zero based).

item - the item index (zero based).

Returns:

The start value.

getY

public java.lang.Number getY(int series,
                             int item)

Returns the y-value for a bin (calculated to take into account the histogram type).

Specified by:

getY in interface org.jfree.data.xy.XYDataset

Parameters:

series - the series index (zero based).

item - the item index (zero based).

Returns:

The y-value.

getStartX

public java.lang.Number getStartX(int series,
                                  int item)

Returns the start value for a bin.

Specified by:

getStartX in interface org.jfree.data.xy.IntervalXYDataset

Parameters:

series - the series index (zero based).

item - the item index (zero based).

Returns:

The start value.

getEndX

public java.lang.Number getEndX(int series,
                                int item)

Returns the end value for a bin.

Specified by:

getEndX in interface org.jfree.data.xy.IntervalXYDataset

Parameters:

series - the series index (zero based).

item - the item index (zero based).

Returns:

The end value.

getStartY

public java.lang.Number getStartY(int series,
                                  int item)

Returns the start y-value for a bin (which is the same as the y-value, this method exists only to support the general form of the IntervalXYDataset interface).

Specified by:

getStartY in interface org.jfree.data.xy.IntervalXYDataset

Parameters:

series - the series index (zero based).

item - the item index (zero based).

Returns:

The y-value.

getEndY

public java.lang.Number getEndY(int series,
                                int item)

Returns the end y-value for a bin (which is the same as the y-value, this method exists only to support the general form of the IntervalXYDataset interface).

Specified by:

getEndY in interface org.jfree.data.xy.IntervalXYDataset

Parameters:

series - the series index (zero based).

item - the item index (zero based).

Returns:

The Y value.

equals

public boolean equals(java.lang.Object obj)

Tests this dataset for equality with an arbitrary object.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to test against (null permitted).

Returns:

A boolean.

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Returns a clone of the dataset.

Specified by:

clone in interface org.jfree.util.PublicCloneable

Overrides:

clone in class org.jfree.data.general.AbstractDataset

Returns:

A clone of the dataset.

Throws:

java.lang.CloneNotSupportedException - if the object cannot be cloned.