com.jrefinery.chart.demo
Class SampleXYSymbolicDataset

java.lang.Object
  |
  +--com.jrefinery.data.AbstractDataset
        |
        +--com.jrefinery.data.AbstractSeriesDataset
              |
              +--com.jrefinery.chart.demo.SampleXYSymbolicDataset
All Implemented Interfaces:
Dataset, SeriesChangeListener, SeriesDataset, XisSymbolic, XYDataset, YisSymbolic

public class SampleXYSymbolicDataset
extends AbstractSeriesDataset
implements XYDataset, XisSymbolic, YisSymbolic

Random data for a symbolic plot demo.

Author:
AB

Constructor Summary
SampleXYSymbolicDataset(java.lang.String datasetName, java.lang.Integer[][] xValues, java.lang.Integer[][] yValues, java.lang.String[] xSymbolicValues, java.lang.String[] ySymbolicValues, java.lang.String[] seriesName)
          Creates a new dataset.
 
Method Summary
 java.lang.Object clone()
          Clone the SampleXYSymbolicDataset object
static java.lang.String[] combineXSymbolicDataset(XisSymbolic dataset1, XisSymbolic dataset2)
          This function modify dataset1 and dataset1 in order that they share the same X symbolic value list.
static java.lang.String[] combineYSymbolicDataset(YisSymbolic dataset1, YisSymbolic dataset2)
          This function modify dataset1 and dataset1 in order that they share the same Y symbolic value list.
 int getItemCount(int series)
          Returns the number of items in the specified series.
 int getSeriesCount()
          Returns the number of series in the dataset.
 java.lang.String getSeriesName(int series)
          Returns the name of the series.
 java.lang.String getXSymbolicValue(java.lang.Integer val)
          Returns the X symbolic value linked with the specified Integer.
 java.lang.String getXSymbolicValue(int series, int item)
          Returns the X symbolic value of the data set specified by series and item parameters.
 java.lang.String[] getXSymbolicValues()
          Returns the list of X symbolic values.
 java.lang.Number getXValue(int series, int item)
          Returns the x-value for the specified series and item.
 java.lang.String getYSymbolicValue(java.lang.Integer val)
          Returns the Y symbolic value linked with the specified Integer.
 java.lang.String getYSymbolicValue(int series, int item)
          Returns the Y symbolic value of the data set specified by series and item parameters.
 java.lang.String[] getYSymbolicValues()
          Returns the list of Y symbolic values.
 java.lang.Number getYValue(int series, int item)
          Returns the y-value for the specified series and item.
 void setXSymbolicValues(java.lang.String[] sValues)
          Sets the list of X symbolic values.
 void setXValue(int series, int item, java.lang.Number newValue)
          Sets the x-value for the specified series and item with the specified new Number value.
 void setYSymbolicValues(java.lang.String[] sValues)
          Sets the list of Y symbolic values.
 void setYValue(int series, int item, java.lang.Number newValue)
          Sets the y-value for the specified series and item with the specified new Number value.
 
Methods inherited from class com.jrefinery.data.AbstractSeriesDataset
getLegendItemCount, getLegendItemLabels, seriesChanged
 
Methods inherited from class com.jrefinery.data.AbstractDataset
addChangeListener, fireDatasetChanged, getGroup, notifyListeners, removeChangeListener, setGroup
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.jrefinery.data.Dataset
addChangeListener, getGroup, removeChangeListener, setGroup
 

Constructor Detail

SampleXYSymbolicDataset

public SampleXYSymbolicDataset(java.lang.String datasetName,
                               java.lang.Integer[][] xValues,
                               java.lang.Integer[][] yValues,
                               java.lang.String[] xSymbolicValues,
                               java.lang.String[] ySymbolicValues,
                               java.lang.String[] seriesName)
Creates a new dataset.
Parameters:
datasetName - the dataset name.
xValues - the x values.
yValues - the y values.
xSymbolicValues - the x symbols.
ySymbolicValues - the y symbols.
seriesName - the series name.
Method Detail

getXValue

public java.lang.Number getXValue(int series,
                                  int item)
Returns the x-value for the specified series and item. Series are numbered 0, 1, ...
Specified by:
getXValue in interface XYDataset
Parameters:
series - the index (zero-based) of the series.
item - the index (zero-based) of the required item.
Returns:
the x-value for the specified series and item.

getYValue

public java.lang.Number getYValue(int series,
                                  int item)
Returns the y-value for the specified series and item. Series are numbered 0, 1, ...
Specified by:
getYValue in interface XYDataset
Parameters:
series - the index (zero-based) of the series.
item - the index (zero-based) of the required item.
Returns:
the y-value for the specified series and item.

setXValue

public void setXValue(int series,
                      int item,
                      java.lang.Number newValue)
Sets the x-value for the specified series and item with the specified new Number value. Series are numbered 0, 1, ...

This method is used by combineXSymbolicDataset to modify the reference to the symbolic value ...

Parameters:
series - the index (zero-based) of the series.
item - the index (zero-based) of the required item.
newValue - the value to set.

setYValue

public void setYValue(int series,
                      int item,
                      java.lang.Number newValue)
Sets the y-value for the specified series and item with the specified new Number value. Series are numbered 0, 1, ...

This method is used by combineYSymbolicDataset to modify the reference to the symbolic value ...

Parameters:
series - the index (zero-based) of the series.
item - the index (zero-based) of the required item.
newValue - the value to set.

getSeriesCount

public int getSeriesCount()
Returns the number of series in the dataset.
Specified by:
getSeriesCount in interface SeriesDataset
Overrides:
getSeriesCount in class AbstractSeriesDataset
Returns:
The number of series in the dataset.

getSeriesName

public java.lang.String getSeriesName(int series)
Returns the name of the series.
Specified by:
getSeriesName in interface SeriesDataset
Overrides:
getSeriesName in class AbstractSeriesDataset
Parameters:
series - the index (zero-based) of the series.
Returns:
the name of the series.

getItemCount

public int getItemCount(int series)
Returns the number of items in the specified series.
Specified by:
getItemCount in interface XYDataset
Parameters:
series - the index (zero-based) of the series.
Returns:
the number of items in the specified series.

getXSymbolicValues

public java.lang.String[] getXSymbolicValues()
Returns the list of X symbolic values.
Specified by:
getXSymbolicValues in interface XisSymbolic
Returns:
array of symbolic value.

getYSymbolicValues

public java.lang.String[] getYSymbolicValues()
Returns the list of Y symbolic values.
Specified by:
getYSymbolicValues in interface YisSymbolic
Returns:
array of symbolic value.

setXSymbolicValues

public void setXSymbolicValues(java.lang.String[] sValues)
Sets the list of X symbolic values.
Parameters:
sValues - the new list of symbolic value.

setYSymbolicValues

public void setYSymbolicValues(java.lang.String[] sValues)
Sets the list of Y symbolic values.
Parameters:
sValues - the new list of symbolic value.

getXSymbolicValue

public java.lang.String getXSymbolicValue(int series,
                                          int item)
Returns the X symbolic value of the data set specified by series and item parameters.
Specified by:
getXSymbolicValue in interface XisSymbolic
Parameters:
series - value of the serie.
item - value of the item.
Returns:
the symbolic value.

getYSymbolicValue

public java.lang.String getYSymbolicValue(int series,
                                          int item)
Returns the Y symbolic value of the data set specified by series and item parameters.
Specified by:
getYSymbolicValue in interface YisSymbolic
Parameters:
series - value of the serie.
item - value of the item.
Returns:
the symbolic value.

getXSymbolicValue

public java.lang.String getXSymbolicValue(java.lang.Integer val)
Returns the X symbolic value linked with the specified Integer.
Specified by:
getXSymbolicValue in interface XisSymbolic
Parameters:
val - value of the integer linked with the symbolic value.
Returns:
the symbolic value.

getYSymbolicValue

public java.lang.String getYSymbolicValue(java.lang.Integer val)
Returns the Y symbolic value linked with the specified Integer.
Specified by:
getYSymbolicValue in interface YisSymbolic
Parameters:
val - value of the integer linked with the symbolic value.
Returns:
the symbolic value.

combineYSymbolicDataset

public static java.lang.String[] combineYSymbolicDataset(YisSymbolic dataset1,
                                                         YisSymbolic dataset2)
This function modify dataset1 and dataset1 in order that they share the same Y symbolic value list.

The sharing Y symbolic value list is obtained adding the Y symbolic data list of the fist data set to the Y symbolic data list of the second data set.

This function is use with the combined plot functions of JFreeChart.

Parameters:
dataset1 - the first data set to combine.
dataset2 - the second data set to combine.
Returns:
the shared Y symbolic array.
Throws:
ClassCastException - if dataset1 and dataset2 is not an instance of SampleYSymbolicDataset.

combineXSymbolicDataset

public static java.lang.String[] combineXSymbolicDataset(XisSymbolic dataset1,
                                                         XisSymbolic dataset2)
This function modify dataset1 and dataset1 in order that they share the same X symbolic value list.

The sharing X symbolic value list is obtained adding the X symbolic data list of the fist data set to the X symbolic data list of the second data set.

This function is use with the combined plot functions of JFreeChart.

Parameters:
dataset1 - the first data set to combine.
dataset2 - the second data set to combine.
Returns:
the shared X symbolic array.
Throws:
ClassCastException - if dataset1 and dataset2 is not an instance of SampleYSymbolicDataset.

clone

public java.lang.Object clone()
Clone the SampleXYSymbolicDataset object
Overrides:
clone in class java.lang.Object
Returns:
the cloned object.