程序包 org.hipparchus.stat.descriptive.moment

类 GeometricMean

java.lang.Object

org.hipparchus.stat.descriptive.AbstractStorelessUnivariateStatistic

org.hipparchus.stat.descriptive.moment.GeometricMean

所有已实现的接口:

Serializable, DoubleConsumer, AggregatableStatistic<GeometricMean>, StorelessUnivariateStatistic, UnivariateStatistic, MathArrays.Function

       public class GeometricMean extends AbstractStorelessUnivariateStatistic implements AggregatableStatistic<GeometricMean>, Serializable
      

返回可用值的几何平均值。

使用SumOfLogs实例计算对数和返回exp( 1/n (sum of logs) )。因此，

• 如果任何值小于0，则结果为NaN。
• 如果所有值均为非负且小于Double.POSITIVE_INFINITY，但至少有一个值为0，则结果为0。
• 如果值中包含Double.POSITIVE_INFINITY和Double.NEGATIVE_INFINITY，则结果为NaN。

请注意，此实现未同步。如果多个线程同时访问此类的实例，并且至少有一个线程调用increment()或clear()方法，则必须在外部进行同步。

另请参阅:

• 序列化表格

构造器概要

构造器

构造器	说明
GeometricMean()	创建一个GeometricMean实例。
GeometricMean(GeometricMean original)	复制构造函数，创建一个与original相同的新GeometricMean。
GeometricMean(SumOfLogs sumOfLogs)	使用给定的SumOfLogs实例创建一个GeometricMean实例。

方法概要

修饰符和类型	方法	说明
void	aggregate(GeometricMean other)	将提供的实例聚合到此实例中。
void	clear()	清除统计数据的内部状态。
GeometricMean	copy()	返回具有相同内部状态的统计数据副本。
double	evaluate(double[] values, int begin, int length)	返回输入数组指定部分中条目的几何平均值。
long	getN()	返回已添加值的数量。
double	getResult()	返回统计数据的当前值。
void	increment(double d)	更新统计数据的内部状态以反映新值的添加。

从类继承的方法 org.hipparchus.stat.descriptive.AbstractStorelessUnivariateStatistic

equals, hashCode, toString

从类继承的方法 java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

从接口继承的方法 org.hipparchus.stat.descriptive.AggregatableStatistic

aggregate, aggregate

从接口继承的方法 java.util.function.DoubleConsumer

andThen

从接口继承的方法 org.hipparchus.stat.descriptive.StorelessUnivariateStatistic

accept, incrementAll, incrementAll

从接口继承的方法 org.hipparchus.stat.descriptive.UnivariateStatistic

evaluate

构造器详细资料

GeometricMean

             public GeometricMean()
            

创建一个GeometricMean实例。

GeometricMean

             public GeometricMean(SumOfLogs sumOfLogs)
            

使用给定的SumOfLogs实例创建一个GeometricMean实例。

参数:

sumOfLogs - 用于计算的对数和实例。

GeometricMean

             public GeometricMean(GeometricMean original) throws NullArgumentException
            

复制构造函数，创建一个与original相同的新GeometricMean。

参数:

original - 要复制的GeometricMean实例

抛出:

NullArgumentException - 如果原始值为null

方法详细资料

copy

             public GeometricMean copy()
            

返回具有相同内部状态的统计数据副本。

指定者:

copy 在接口中 StorelessUnivariateStatistic

指定者:

copy 在接口中 UnivariateStatistic

指定者:

copy 在类中 AbstractStorelessUnivariateStatistic

返回:

统计数据的副本

increment

             public void increment(double d)
            

更新统计数据的内部状态以反映新值的添加。

指定者:

increment 在接口中 StorelessUnivariateStatistic

指定者:

increment 在类中 AbstractStorelessUnivariateStatistic

参数:

d - 新值。

getResult

             public double getResult()
            

返回统计数据的当前值。

指定者:

getResult 在接口中 StorelessUnivariateStatistic

指定者:

getResult 在类中 AbstractStorelessUnivariateStatistic

返回:

统计数据的值，如果已清除或刚实例化，则为Double.NaN。

clear

             public void clear()
            

清除统计数据的内部状态。

指定者:

clear 在接口中 StorelessUnivariateStatistic

指定者:

clear 在类中 AbstractStorelessUnivariateStatistic

aggregate

             public void aggregate(GeometricMean other)
            

将提供的实例聚合到此实例中。

此方法可用于合并在分区或子样本上计算的统计数据 - 即，此操作后此实例的值应与在组合数据集上应用单个统计数据时的值相同。

指定者:

aggregate 在接口中 AggregatableStatistic<GeometricMean>

参数:

other - 要聚合到此实例中的实例

evaluate

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

返回输入数组指定部分中条目的几何平均值。

有关计算算法的详细信息，请参阅GeometricMean。

指定者:

evaluate 在接口中 MathArrays.Function

指定者:

evaluate 在接口中 StorelessUnivariateStatistic

指定者:

evaluate 在接口中 UnivariateStatistic

参数:

values - 包含值的输入数组

begin - 要包括的第一个数组元素

length - 要包括的元素数量

返回:

几何平均值，如果length = 0或任何值<= 0，则返回Double.NaN。

抛出:

MathIllegalArgumentException - 如果输入数组为null或数组索引参数无效

另请参阅:

• UnivariateStatistic.evaluate(double[], int, int)

getN

             public long getN()
            

返回已添加值的数量。

指定者:

getN 在接口中 StorelessUnivariateStatistic

返回:

值的数量。