|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.commons.math.stat.descriptive.AbstractUnivariateStatistic
org.apache.commons.math.stat.descriptive.AbstractStorelessUnivariateStatistic
org.apache.commons.math.stat.descriptive.moment.FirstMoment
public class FirstMoment
Computes the first moment (arithmetic mean). Uses the definitional formula:
mean = sum(x_i) / n
where n
is the number of observations.
To limit numeric errors, the value of the statistic is computed using the following recursive updating algorithm:
m =
the first valuem = m + (new value - m) / (number of observations)
Returns Double.NaN
if the dataset is empty.
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.
Field Summary | |
---|---|
protected double |
dev
Deviation of most recently added value from previous first moment. |
protected double |
m1
First moment of values that have been added |
protected long |
n
Count of values that have been added |
protected double |
nDev
Deviation of most recently added value from previous first moment, normalized by previous sample size. |
private static long |
serialVersionUID
Serializable version identifier |
Constructor Summary | |
---|---|
FirstMoment()
Create a FirstMoment instance |
Method Summary | |
---|---|
void |
clear()
Clears the internal state of the Statistic |
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. |
Methods inherited from class org.apache.commons.math.stat.descriptive.AbstractStorelessUnivariateStatistic |
---|
equals, evaluate, evaluate, hashCode, incrementAll, incrementAll |
Methods inherited from class org.apache.commons.math.stat.descriptive.AbstractUnivariateStatistic |
---|
test |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
private static final long serialVersionUID
protected long n
protected double m1
protected double dev
protected double nDev
Constructor Detail |
---|
public FirstMoment()
Method Detail |
---|
public void increment(double d)
StorelessUnivariateStatistic
increment
in interface StorelessUnivariateStatistic
increment
in class AbstractStorelessUnivariateStatistic
d
- the new value.StorelessUnivariateStatistic.increment(double)
public void clear()
StorelessUnivariateStatistic
clear
in interface StorelessUnivariateStatistic
clear
in class AbstractStorelessUnivariateStatistic
StorelessUnivariateStatistic.clear()
public double getResult()
StorelessUnivariateStatistic
getResult
in interface StorelessUnivariateStatistic
getResult
in class AbstractStorelessUnivariateStatistic
Double.NaN
if it
has been cleared or just instantiated.StorelessUnivariateStatistic.getResult()
public long getN()
StorelessUnivariateStatistic
getN
in interface StorelessUnivariateStatistic
StorelessUnivariateStatistic.getN()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |