org.hipparchus.stat.descriptive

Class AbstractUnivariateStatistic

java.lang.Object

org.hipparchus.stat.descriptive.AbstractUnivariateStatistic

All Implemented Interfaces:

UnivariateStatistic, MathArrays.Function

Direct Known Subclasses:

Median, Percentile, SemiVariance

public abstract class AbstractUnivariateStatistic
extends Object
implements UnivariateStatistic

Abstract base class for implementations of the UnivariateStatistic interface.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractUnivariateStatistic() Default constructor.
protected	AbstractUnivariateStatistic(AbstractUnivariateStatistic original) Copy constructor, creates an identical copy of the original.

Method Summary

Modifier and Type	Method and Description
abstract UnivariateStatistic	copy() Returns a copy of the statistic with the same internal state.
double	evaluate() Returns the result of evaluating the statistic over the stored data.
abstract double	evaluate(double[] values, int begin, int length) Returns the result of evaluating the statistic over the specified entries in the input array.
double[]	getData() Get a copy of the stored data array.
protected double[]	getDataRef() Get a reference to the stored data array.
void	setData(double[] values) Set the data array.
void	setData(double[] values, int begin, int length) Set the data array.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hipparchus.stat.descriptive.UnivariateStatistic

evaluate

Constructor Detail

AbstractUnivariateStatistic

protected AbstractUnivariateStatistic()

Default constructor.

AbstractUnivariateStatistic

protected AbstractUnivariateStatistic(AbstractUnivariateStatistic original)

Copy constructor, creates an identical copy of the original.

Parameters:

original - the instance to copy

Throws:

NullArgumentException - if original is null

Method Detail

evaluate

public abstract double evaluate(double[] values,
                                int begin,
                                int length)
                         throws MathIllegalArgumentException

Returns the result of evaluating the statistic over the specified entries in the input array.

Specified by:

evaluate in interface UnivariateStatistic

Specified by:

evaluate in interface MathArrays.Function

Parameters:

values - the input array

begin - the index of the first element to include

length - the number of elements to include

Returns:

the value of the statistic applied to the included array entries

Throws:

MathIllegalArgumentException - if values is null or the indices are invalid

copy

public abstract UnivariateStatistic copy()

Returns a copy of the statistic with the same internal state.

Specified by:

copy in interface UnivariateStatistic

Returns:

a copy of the statistic

setData

public void setData(double[] values)

Set the data array.

The stored value is a copy of the parameter array, not the array itself.

Parameters:

values - data array to store (may be null to remove stored data)

See Also:

evaluate()

getData

public double[] getData()

Get a copy of the stored data array.

Returns:

copy of the stored data array (may be null)

getDataRef

protected double[] getDataRef()

Get a reference to the stored data array.

Returns:

reference to the stored data array (may be null)

setData

public void setData(double[] values,
                    int begin,
                    int length)
             throws MathIllegalArgumentException

Set the data array. The input array is copied, not referenced.

Parameters:

values - data array to store

begin - the index of the first element to include

length - the number of elements to include

Throws:

MathIllegalArgumentException - if values is null or the indices are not valid

See Also:

evaluate()

evaluate

public double evaluate()
                throws MathIllegalArgumentException

Returns the result of evaluating the statistic over the stored data.

The stored array is the one which was set by previous calls to setData(double[]).

Returns:

the value of the statistic applied to the stored data

Throws:

MathIllegalArgumentException - if the stored data array is null