org.jfree.data

Class DataUtilities

java.lang.Object

org.jfree.data.DataUtilities

public abstract class DataUtilities
extends java.lang.Object

Utility methods for use with some of the data classes (but not the datasets, see DatasetUtilities).

Constructor Summary

Constructors

Constructor and Description
DataUtilities()

Method Summary

Modifier and Type	Method and Description
static double	calculateColumnTotal(Values2D data, int column) Returns the total of the values in one column of the supplied data table.
static double	calculateColumnTotal(Values2D data, int column, int[] validRows) Returns the total of the values in one column of the supplied data table by taking only the row numbers in the array into account.
static double	calculateRowTotal(Values2D data, int row) Returns the total of the values in one row of the supplied data table.
static double	calculateRowTotal(Values2D data, int row, int[] validCols) Returns the total of the values in one row of the supplied data table by taking only the column numbers in the array into account.
static double[][]	clone(double[][] source) Returns a clone of the specified array.
static java.lang.Number[]	createNumberArray(double[] data) Constructs an array of Number objects from an array of double primitives.
static java.lang.Number[][]	createNumberArray2D(double[][] data) Constructs an array of arrays of Number objects from a corresponding structure containing double primitives.
static boolean	equal(double[][] a, double[][] b) Tests two arrays for equality.
static KeyedValues	getCumulativePercentages(KeyedValues data) Returns a KeyedValues instance that contains the cumulative percentage values for the data in another KeyedValues instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataUtilities

public DataUtilities()

Method Detail

equal

public static boolean equal(double[][] a,
                            double[][] b)

Tests two arrays for equality. To be considered equal, the arrays must have exactly the same dimensions, and the values in each array must also match (two values that qre both NaN or both INF are considered equal in this test).

Parameters:

a - the first array (null permitted).

b - the second array (null permitted).

Returns:

A boolean.

Since:

1.0.13

clone

public static double[][] clone(double[][] source)

Returns a clone of the specified array.

Parameters:

source - the source array (null not permitted).

Returns:

A clone of the array.

Since:

1.0.13

calculateColumnTotal

public static double calculateColumnTotal(Values2D data,
                                          int column)

Returns the total of the values in one column of the supplied data table.

Parameters:

data - the table of values (null not permitted).

column - the column index (zero-based).

Returns:

The total of the values in the specified column.

calculateColumnTotal

public static double calculateColumnTotal(Values2D data,
                                          int column,
                                          int[] validRows)

Returns the total of the values in one column of the supplied data table by taking only the row numbers in the array into account.

Parameters:

data - the table of values (null not permitted).

column - the column index (zero-based).

validRows - the array with valid rows (zero-based).

Returns:

The total of the valid values in the specified column.

Since:

1.0.13

calculateRowTotal

public static double calculateRowTotal(Values2D data,
                                       int row)

Returns the total of the values in one row of the supplied data table.

Parameters:

data - the table of values (null not permitted).

row - the row index (zero-based).

Returns:

The total of the values in the specified row.

calculateRowTotal

public static double calculateRowTotal(Values2D data,
                                       int row,
                                       int[] validCols)

Returns the total of the values in one row of the supplied data table by taking only the column numbers in the array into account.

Parameters:

data - the table of values (null not permitted).

row - the row index (zero-based).

validCols - the array with valid cols (zero-based).

Returns:

The total of the valid values in the specified row.

Since:

1.0.13

createNumberArray

public static java.lang.Number[] createNumberArray(double[] data)

Constructs an array of Number objects from an array of double primitives.

Parameters:

data - the data (null not permitted).

Returns:

An array of Double.

createNumberArray2D

public static java.lang.Number[][] createNumberArray2D(double[][] data)

Constructs an array of arrays of Number objects from a corresponding structure containing double primitives.

Parameters:

data - the data (null not permitted).

Returns:

An array of Double.

getCumulativePercentages

public static KeyedValues getCumulativePercentages(KeyedValues data)

Returns a KeyedValues instance that contains the cumulative percentage values for the data in another KeyedValues instance.

The percentages are values between 0.0 and 1.0 (where 1.0 = 100%).

Parameters:

data - the data (null not permitted).

Returns:

The cumulative percentages.