org.jfree.data.statistics

Interface BoxAndWhiskerXYDataset

public interface BoxAndWhiskerXYDataset extends XYDataset

An interface that defines data in the form of (x, max, min, average, median) tuples.

Example: JFreeChart uses this interface to obtain data for AIMS max-min-average-median plots.

Method Summary
doublegetFaroutCoefficient()
Returns the value used as the farout coefficient.
NumbergetMaxOutlier(int series, int item)
Returns the maximum value which is not a farout, ie Q3 + (interquartile range * farout coefficient).
NumbergetMaxRegularValue(int series, int item)
Returns the max-value for the specified series and item.
NumbergetMeanValue(int series, int item)
Returns the mean for the specified series and item.
NumbergetMedianValue(int series, int item)
Returns the median-value for the specified series and item.
NumbergetMinOutlier(int series, int item)
Returns the minimum value which is not a farout.
NumbergetMinRegularValue(int series, int item)
Returns the min-value for the specified series and item.
doublegetOutlierCoefficient()
Returns the value used as the outlier coefficient.
ListgetOutliers(int series, int item)
Returns an array of outliers for the specified series and item.
NumbergetQ1Value(int series, int item)
Returns the Q1 median-value for the specified series and item.
NumbergetQ3Value(int series, int item)
Returns the Q3 median-value for the specified series and item.

Method Detail

getFaroutCoefficient

public double getFaroutCoefficient()
Returns the value used as the farout coefficient. The farout coefficient allows the calculation of which values will be off the graph.

Returns: A double representing the value used to calculate farouts

getMaxOutlier

public Number getMaxOutlier(int series, int item)
Returns the maximum value which is not a farout, ie Q3 + (interquartile range * farout coefficient).

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: A Number representing the maximum non-farout value.

getMaxRegularValue

public Number getMaxRegularValue(int series, int item)
Returns the max-value for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The max-value for the specified series and item.

getMeanValue

public Number getMeanValue(int series, int item)
Returns the mean for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The mean for the specified series and item.

getMedianValue

public Number getMedianValue(int series, int item)
Returns the median-value for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The median-value for the specified series and item.

getMinOutlier

public Number getMinOutlier(int series, int item)
Returns the minimum value which is not a farout.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: A Number representing the maximum non-farout value.

getMinRegularValue

public Number getMinRegularValue(int series, int item)
Returns the min-value for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The min-value for the specified series and item.

getOutlierCoefficient

public double getOutlierCoefficient()
Returns the value used as the outlier coefficient. The outlier coefficient gives an indication of the degree of certainty in an unskewed distribution. Increasing the coefficient increases the number of values included. Currently only used to ensure farout coefficient is greater than the outlier coefficient

Returns: A double representing the value used to calculate outliers

getOutliers

public List getOutliers(int series, int item)
Returns an array of outliers for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The array of outliers for the specified series and item.

getQ1Value

public Number getQ1Value(int series, int item)
Returns the Q1 median-value for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The Q1 median-value for the specified series and item.

getQ3Value

public Number getQ3Value(int series, int item)
Returns the Q3 median-value for the specified series and item.

Parameters: series the series (zero-based index). item the item (zero-based index).

Returns: The Q3 median-value for the specified series and item.

Copyright © 2000-2009 by Object Refinery Limited. All Rights Reserved.