Package org.jfree.data.category
Class DefaultIntervalCategoryDataset
- java.lang.Object
-
- org.jfree.data.general.AbstractDataset
-
- org.jfree.data.general.AbstractSeriesDataset
-
- org.jfree.data.category.DefaultIntervalCategoryDataset
-
- All Implemented Interfaces:
ObjectInputValidation
,Serializable
,Cloneable
,EventListener
,CategoryDataset
,IntervalCategoryDataset
,Dataset
,SeriesChangeListener
,SeriesDataset
,KeyedValues2D
,Values2D
public class DefaultIntervalCategoryDataset extends AbstractSeriesDataset implements IntervalCategoryDataset
A convenience class that provides a default implementation of theIntervalCategoryDataset
interface.The standard constructor accepts data in a two dimensional array where the first dimension is the series, and the second dimension is the category.
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description DefaultIntervalCategoryDataset(double[][] starts, double[][] ends)
Creates a new dataset using the specified data values and automatically generated series and category keys.DefaultIntervalCategoryDataset(Comparable[] seriesKeys, Comparable[] categoryKeys, Number[][] starts, Number[][] ends)
Constructs a DefaultIntervalCategoryDataset, populates it with data from the arrays, and uses the supplied names for the series and the supplied objects for the categories.DefaultIntervalCategoryDataset(Number[][] starts, Number[][] ends)
Constructs a dataset and populates it with data from the array.DefaultIntervalCategoryDataset(String[] seriesNames, Number[][] starts, Number[][] ends)
Constructs a DefaultIntervalCategoryDataset, populates it with data from the arrays, and uses the supplied names for the series.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description Object
clone()
Returns a clone of this dataset.boolean
equals(Object obj)
Tests this dataset for equality with an arbitrary object.List
getCategories()
Deprecated.UsegetColumnKeys()
instead.int
getCategoryCount()
Returns the number of categories in the dataset.int
getCategoryIndex(Comparable category)
Returns the index for the given category.int
getColumnCount()
Returns the number of categories in the dataset.int
getColumnIndex(Comparable columnKey)
Returns a column index.Comparable
getColumnKey(int column)
Returns a column key.List
getColumnKeys()
Returns a list of the categories in the dataset.Number
getEndValue(int series, int category)
Returns the end data value for one category in a series.Number
getEndValue(Comparable series, Comparable category)
Returns the end data value for one category in a series.int
getItemCount()
Deprecated.UsegetCategoryCount()
instead.int
getRowCount()
Returns the number of series in the dataset (possibly zero).int
getRowIndex(Comparable rowKey)
Returns a row index.Comparable
getRowKey(int row)
Returns the name of the specified series.List
getRowKeys()
Returns a list of the series in the dataset.List
getSeries()
Deprecated.UsegetRowKeys()
instead.int
getSeriesCount()
Returns the number of series in the dataset (possibly zero).int
getSeriesIndex(Comparable seriesKey)
Returns a series index.Comparable
getSeriesKey(int series)
Returns the name of the specified series.Number
getStartValue(int series, int category)
Returns the start data value for one category in a series.Number
getStartValue(Comparable series, Comparable category)
Returns the start data value for one category in a series.Number
getValue(int series, int category)
Returns the data value for one category in a series.Number
getValue(Comparable series, Comparable category)
Returns the data value for one category in a series.void
setCategoryKeys(Comparable[] categoryKeys)
Sets the categories for the dataset.void
setEndValue(int series, Comparable category, Number value)
Sets the end data value for one category in a series.void
setSeriesKeys(Comparable[] seriesKeys)
Sets the names of the series in the dataset.void
setStartValue(int series, Comparable category, Number value)
Sets the start data value for one category in a series.-
Methods inherited from class org.jfree.data.general.AbstractSeriesDataset
indexOf, seriesChanged
-
Methods inherited from class org.jfree.data.general.AbstractDataset
addChangeListener, fireDatasetChanged, getGroup, getNotify, hasListener, notifyListeners, removeChangeListener, setGroup, setNotify, validateObject
-
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.jfree.data.general.Dataset
addChangeListener, getGroup, removeChangeListener, setGroup
-
-
-
-
Constructor Detail
-
DefaultIntervalCategoryDataset
public DefaultIntervalCategoryDataset(double[][] starts, double[][] ends)
Creates a new dataset using the specified data values and automatically generated series and category keys.- Parameters:
starts
- the starting values for the intervals (null
not permitted).ends
- the ending values for the intervals (null
not permitted).
-
DefaultIntervalCategoryDataset
public DefaultIntervalCategoryDataset(Number[][] starts, Number[][] ends)
Constructs a dataset and populates it with data from the array.The arrays are indexed as data[series][category]. Series and category names are automatically generated - you can change them using the
setSeriesKeys(Comparable[])
andsetCategoryKeys(Comparable[])
methods.- Parameters:
starts
- the start values data.ends
- the end values data.
-
DefaultIntervalCategoryDataset
public DefaultIntervalCategoryDataset(String[] seriesNames, Number[][] starts, Number[][] ends)
Constructs a DefaultIntervalCategoryDataset, populates it with data from the arrays, and uses the supplied names for the series.Category names are generated automatically ("Category 1", "Category 2", etc).
- Parameters:
seriesNames
- the series names (ifnull
, series names will be generated automatically).starts
- the start values data, indexed as data[series][category].ends
- the end values data, indexed as data[series][category].
-
DefaultIntervalCategoryDataset
public DefaultIntervalCategoryDataset(Comparable[] seriesKeys, Comparable[] categoryKeys, Number[][] starts, Number[][] ends)
Constructs a DefaultIntervalCategoryDataset, populates it with data from the arrays, and uses the supplied names for the series and the supplied objects for the categories.- Parameters:
seriesKeys
- the series keys (ifnull
, series keys will be generated automatically).categoryKeys
- the category keys (ifnull
, category keys will be generated automatically).starts
- the start values data, indexed as data[series][category].ends
- the end values data, indexed as data[series][category].
-
-
Method Detail
-
getSeriesCount
public int getSeriesCount()
Returns the number of series in the dataset (possibly zero).- Specified by:
getSeriesCount
in interfaceSeriesDataset
- Specified by:
getSeriesCount
in classAbstractSeriesDataset
- Returns:
- The number of series in the dataset.
- See Also:
getRowCount()
,getCategoryCount()
-
getSeriesIndex
public int getSeriesIndex(Comparable seriesKey)
Returns a series index.- Parameters:
seriesKey
- the series key.- Returns:
- The series index.
- See Also:
getRowIndex(Comparable)
,getSeriesKey(int)
-
getSeriesKey
public Comparable getSeriesKey(int series)
Returns the name of the specified series.- Specified by:
getSeriesKey
in interfaceSeriesDataset
- Specified by:
getSeriesKey
in classAbstractSeriesDataset
- Parameters:
series
- the index of the required series (zero-based).- Returns:
- The name of the specified series.
- See Also:
getSeriesIndex(Comparable)
-
setSeriesKeys
public void setSeriesKeys(Comparable[] seriesKeys)
Sets the names of the series in the dataset.- Parameters:
seriesKeys
- the new keys (null
not permitted, the length of the array must match the number of series in the dataset).- See Also:
setCategoryKeys(Comparable[])
-
getCategoryCount
public int getCategoryCount()
Returns the number of categories in the dataset.- Returns:
- The number of categories in the dataset.
- See Also:
getColumnCount()
-
getColumnKeys
public List getColumnKeys()
Returns a list of the categories in the dataset. This method supports theCategoryDataset
interface.- Specified by:
getColumnKeys
in interfaceKeyedValues2D
- Returns:
- A list of the categories in the dataset.
- See Also:
getRowKeys()
-
setCategoryKeys
public void setCategoryKeys(Comparable[] categoryKeys)
Sets the categories for the dataset.- Parameters:
categoryKeys
- an array of objects representing the categories in the dataset.- See Also:
getRowKeys()
,setSeriesKeys(Comparable[])
-
getValue
public Number getValue(Comparable series, Comparable category)
Returns the data value for one category in a series.This method is part of the CategoryDataset interface. Not particularly meaningful for this class...returns the end value.
- Specified by:
getValue
in interfaceKeyedValues2D
- Parameters:
series
- The required series (zero based index).category
- The required category.- Returns:
- The data value for one category in a series (null possible).
- See Also:
getEndValue(Comparable, Comparable)
-
getValue
public Number getValue(int series, int category)
Returns the data value for one category in a series.This method is part of the CategoryDataset interface. Not particularly meaningful for this class...returns the end value.
- Specified by:
getValue
in interfaceValues2D
- Parameters:
series
- the required series (zero based index).category
- the required category.- Returns:
- The data value for one category in a series (null possible).
- See Also:
getEndValue(int, int)
-
getStartValue
public Number getStartValue(Comparable series, Comparable category)
Returns the start data value for one category in a series.- Specified by:
getStartValue
in interfaceIntervalCategoryDataset
- Parameters:
series
- the required series.category
- the required category.- Returns:
- The start data value for one category in a series
(possibly
null
). - See Also:
getStartValue(int, int)
-
getStartValue
public Number getStartValue(int series, int category)
Returns the start data value for one category in a series.- Specified by:
getStartValue
in interfaceIntervalCategoryDataset
- Parameters:
series
- the required series (zero based index).category
- the required category.- Returns:
- The start data value for one category in a series
(possibly
null
). - See Also:
getStartValue(Comparable, Comparable)
-
getEndValue
public Number getEndValue(Comparable series, Comparable category)
Returns the end data value for one category in a series.- Specified by:
getEndValue
in interfaceIntervalCategoryDataset
- Parameters:
series
- the required series.category
- the required category.- Returns:
- The end data value for one category in a series (null possible).
- See Also:
getEndValue(int, int)
-
getEndValue
public Number getEndValue(int series, int category)
Returns the end data value for one category in a series.- Specified by:
getEndValue
in interfaceIntervalCategoryDataset
- Parameters:
series
- the required series (zero based index).category
- the required category.- Returns:
- The end data value for one category in a series (null possible).
- See Also:
getEndValue(Comparable, Comparable)
-
setStartValue
public void setStartValue(int series, Comparable category, Number value)
Sets the start data value for one category in a series.- Parameters:
series
- the series (zero-based index).category
- the category.value
- The value.- See Also:
setEndValue(int, Comparable, Number)
-
setEndValue
public void setEndValue(int series, Comparable category, Number value)
Sets the end data value for one category in a series.- Parameters:
series
- the series (zero-based index).category
- the category.value
- the value.- See Also:
setStartValue(int, Comparable, Number)
-
getCategoryIndex
public int getCategoryIndex(Comparable category)
Returns the index for the given category.- Parameters:
category
- the category (null
not permitted).- Returns:
- The index.
- See Also:
getColumnIndex(Comparable)
-
getColumnKey
public Comparable getColumnKey(int column)
Returns a column key.- Specified by:
getColumnKey
in interfaceKeyedValues2D
- Parameters:
column
- the column index.- Returns:
- The column key.
- See Also:
getRowKey(int)
-
getColumnIndex
public int getColumnIndex(Comparable columnKey)
Returns a column index.- Specified by:
getColumnIndex
in interfaceKeyedValues2D
- Parameters:
columnKey
- the column key (null
not permitted).- Returns:
- The column index.
- See Also:
getCategoryIndex(Comparable)
-
getRowIndex
public int getRowIndex(Comparable rowKey)
Returns a row index.- Specified by:
getRowIndex
in interfaceKeyedValues2D
- Parameters:
rowKey
- the row key.- Returns:
- The row index.
- See Also:
getSeriesIndex(Comparable)
-
getRowKeys
public List getRowKeys()
Returns a list of the series in the dataset. This method supports theCategoryDataset
interface.- Specified by:
getRowKeys
in interfaceKeyedValues2D
- Returns:
- A list of the series in the dataset.
- See Also:
getColumnKeys()
-
getRowKey
public Comparable getRowKey(int row)
Returns the name of the specified series.- Specified by:
getRowKey
in interfaceKeyedValues2D
- Parameters:
row
- the index of the required row/series (zero-based).- Returns:
- The name of the specified series.
- See Also:
getColumnKey(int)
-
getColumnCount
public int getColumnCount()
Returns the number of categories in the dataset. This method is part of theCategoryDataset
interface.- Specified by:
getColumnCount
in interfaceValues2D
- Returns:
- The number of categories in the dataset.
- See Also:
getCategoryCount()
,getRowCount()
-
getRowCount
public int getRowCount()
Returns the number of series in the dataset (possibly zero).- Specified by:
getRowCount
in interfaceValues2D
- Returns:
- The number of series in the dataset.
- See Also:
getSeriesCount()
,getColumnCount()
-
equals
public boolean equals(Object obj)
Tests this dataset for equality with an arbitrary object.
-
clone
public Object clone() throws CloneNotSupportedException
Returns a clone of this dataset.- Overrides:
clone
in classAbstractDataset
- Returns:
- A clone.
- Throws:
CloneNotSupportedException
- if there is a problem cloning the dataset.
-
getSeries
public List getSeries()
Deprecated.UsegetRowKeys()
instead.Returns a list of the series in the dataset.- Returns:
- A list of the series in the dataset.
-
getCategories
public List getCategories()
Deprecated.UsegetColumnKeys()
instead.Returns a list of the categories in the dataset.- Returns:
- A list of the categories in the dataset.
-
getItemCount
public int getItemCount()
Deprecated.UsegetCategoryCount()
instead.Returns the item count.- Returns:
- The item count.
-
-