com.androidplot.util

Class SeriesUtils

java.lang.Object

com.androidplot.util.SeriesUtils

public class SeriesUtils
extends java.lang.Object

Utilities for dealing with Series data.

Constructor Summary

Constructors

Constructor and Description
SeriesUtils()

Method Summary

Modifier and Type	Method and Description
protected static Region	getNullRegion(XYSeries series, int index) Determine the minMax iVals of the xVals surrounding a range of one or more null values.
static OrderedXYSeries.XOrder	getXYOrder(XYSeries series) Determine the XVal order of an XYSeries.
static Region	iBounds(XYSeries series, RectRegion visibleBounds) Compute the range of visible i-vals in the specified series.
protected static int	iBoundsMax(XYSeries series, double visibleMax, float step) TODO: This is a poor alternative to a true binary search implementation.
protected static int	iBoundsMin(XYSeries series, double visibleMin, float step) TODO: This is a poor alternative to a true binary search implementation.
static Region	minMax(java.util.List<java.lang.Number>... lists)
static RectRegion	minMax(java.util.List<XYSeries> seriesList)
static Region	minMax(Region bounds, java.util.List<java.lang.Number>... lists)
static RectRegion	minMax(XYConstraints constraints, java.util.List<XYSeries> seriesList)
static RectRegion	minMax(XYConstraints constraints, XYSeries... seriesArray)
static RectRegion	minMax(XYSeries... seriesList)
static Region	minMaxX(XYSeries... seriesList)
static Region	minMaxY(XYSeries... seriesList)

Methods inherited from class java.lang.Object

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

Constructor Detail

SeriesUtils

public SeriesUtils()

Method Detail

minMax

public static RectRegion minMax(java.util.List<XYSeries> seriesList)

minMax

public static RectRegion minMax(XYSeries... seriesList)

minMaxX

public static Region minMaxX(XYSeries... seriesList)

minMaxY

public static Region minMaxY(XYSeries... seriesList)

minMax

public static RectRegion minMax(XYConstraints constraints,
                                java.util.List<XYSeries> seriesList)

Parameters:

constraints - may be null.

seriesList -

Returns:

Since:

0.9.7

minMax

public static RectRegion minMax(XYConstraints constraints,
                                XYSeries... seriesArray)

Parameters:

constraints - May be null.

seriesArray -

Returns:

Since:

0.9.7

minMax

public static Region minMax(Region bounds,
                            java.util.List<java.lang.Number>... lists)

Parameters:

bounds - Starting minMax values to work from; only lists values that are greater than or less than those in bounds will be be used.

lists - lists to be evaluated for min/max values.

Returns:

the original bounds instance passed in

iBounds

public static Region iBounds(XYSeries series,
                             RectRegion visibleBounds)

Compute the range of visible i-vals in the specified series. Assumes that x-vals are in strict ascending order; behavior is undefined otherwise.

Parameters:

series -

visibleBounds - The visible constraints of the plot

Returns:

iBoundsMax

protected static int iBoundsMax(XYSeries series,
                                double visibleMax,
                                float step)

TODO: This is a poor alternative to a true binary search implementation. Unfortunately writing TODO a binary search algorithm that also supports nulls is not trivial and would not likely TODO result in any noticeable performance increase here. It's a task for another day!

Parameters:

series -

visibleMax -

step -

Returns:

The index of the smallest non-null value that is greater than visibleMax, or the index of the last element if no such value exists.

iBoundsMin

protected static int iBoundsMin(XYSeries series,
                                double visibleMin,
                                float step)

TODO: This is a poor alternative to a true binary search implementation. Unfortunately writing TODO a binary search algorithm that also supports nulls is not trivial and would not likely TODO result in any noticeable performance increase here. It's a task for another day!

Parameters:

series -

visibleMin -

step -

Returns:

The index of the largest non-null value that is less than visible, or 0 (the first element index) if no such value exists.

getNullRegion

protected static Region getNullRegion(XYSeries series,
                                      int index)

Determine the minMax iVals of the xVals surrounding a range of one or more null values.

Parameters:

series -

index - index of the null value in question

Returns:

The iVals of the non-null values surrounding the null range. If the null range is unbounded on either side then either or both min and max values will also be null.

minMax

public static Region minMax(java.util.List<java.lang.Number>... lists)

Parameters:

lists -

Returns:

Since:

0.9.7

getXYOrder

public static OrderedXYSeries.XOrder getXYOrder(XYSeries series)

Determine the XVal order of an XYSeries. If series does not implement OrderedXYSeries then OrderedXYSeries.XOrder.NONE is assumed.

Parameters:

series -

Returns:

The OrderedXYSeries.XOrder of the series.