public class SumOfSquares extends AbstractStorelessUnivariateStatistic implements java.io.Serializable
If there are no values in the dataset, or any of the values are
NaN
, then NaN
is returned.
Note that this implementation is not synchronized. If
multiple threads access an instance of this class concurrently, and at least
one of the threads invokes the increment()
or
clear()
method, it must be synchronized externally.
Constructor and Description |
---|
SumOfSquares()
Create a SumOfSquares instance
|
SumOfSquares(SumOfSquares original)
Copy constructor, creates a new
SumOfSquares identical
to the original |
Modifier and Type | Method and Description |
---|---|
void |
clear()
Clears the internal state of the Statistic
|
SumOfSquares |
copy()
Returns a copy of the statistic with the same internal state.
|
static void |
copy(SumOfSquares source,
SumOfSquares dest)
Copies source to dest.
|
double |
evaluate(double[] values,
int begin,
int length)
Returns the sum of the squares of the entries in the specified portion of
the input array, or
Double.NaN if the designated subarray
is empty. |
long |
getN()
Returns the number of values that have been added.
|
double |
getResult()
Returns the current value of the Statistic.
|
void |
increment(double d)
Updates the internal state of the statistic to reflect the addition of the new value.
|
equals, evaluate, hashCode, incrementAll, incrementAll
test, test
public SumOfSquares()
public SumOfSquares(SumOfSquares original)
SumOfSquares
identical
to the original
original
- the SumOfSquares
instance to copypublic void increment(double d)
increment
in interface StorelessUnivariateStatistic
increment
in class AbstractStorelessUnivariateStatistic
d
- the new value.public double getResult()
getResult
in interface StorelessUnivariateStatistic
getResult
in class AbstractStorelessUnivariateStatistic
Double.NaN
if it
has been cleared or just instantiated.public long getN()
getN
in interface StorelessUnivariateStatistic
public void clear()
clear
in interface StorelessUnivariateStatistic
clear
in class AbstractStorelessUnivariateStatistic
public double evaluate(double[] values, int begin, int length)
Double.NaN
if the designated subarray
is empty.
Throws IllegalArgumentException
if the array is null.
evaluate
in interface UnivariateStatistic
evaluate
in class AbstractStorelessUnivariateStatistic
values
- the input arraybegin
- index of the first array element to includelength
- the number of elements to includejava.lang.IllegalArgumentException
- if the array is null or the array index
parameters are not validUnivariateStatistic.evaluate(double[], int, int)
public SumOfSquares copy()
copy
in interface StorelessUnivariateStatistic
copy
in interface UnivariateStatistic
copy
in class AbstractStorelessUnivariateStatistic
public static void copy(SumOfSquares source, SumOfSquares dest)
Neither source nor dest can be null.
source
- SumOfSquares to copydest
- SumOfSquares to copy tojava.lang.NullPointerException
- if either source or dest is null