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

类 SumOfLogs

java.lang.Object

org.hipparchus.stat.descriptive.AbstractStorelessUnivariateStatistic

org.hipparchus.stat.descriptive.summary.SumOfLogs

所有已实现的接口:

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

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

返回此值集合的自然对数之和。

使用FastMath.log(double)来计算对数。因此，

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

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

另请参阅:

• 序列化表格

构造器概要

构造器

构造器	说明
SumOfLogs()	创建一个SumOfLogs实例。
SumOfLogs(SumOfLogs original)	复制构造函数，创建一个与原始original相同的新SumOfLogs。

方法概要

修饰符和类型	方法	说明
void	aggregate(SumOfLogs other)	将提供的实例聚合到此实例中。
void	clear()	清除统计数据的内部状态。
SumOfLogs	copy()	返回具有相同内部状态的统计数据副本。
double	evaluate(double[] values, int begin, int length)	返回输入数组指定部分中条目的自然对数之和，如果指定的子数组为空，则返回Double.NaN。
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

构造器详细资料

SumOfLogs

             public SumOfLogs()
            

创建一个SumOfLogs实例。

SumOfLogs

             public SumOfLogs(SumOfLogs original) throws NullArgumentException
            

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

参数:

original - 要复制的SumOfLogs实例

抛出:

NullArgumentException - 如果原始实例为null

方法详细资料

increment

             public void increment(double d)
            

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

指定者:

increment 在接口中 StorelessUnivariateStatistic

指定者:

increment 在类中 AbstractStorelessUnivariateStatistic

参数:

d - 新值。

getResult

             public double getResult()
            

返回统计数据的当前值。

指定者:

getResult 在接口中 StorelessUnivariateStatistic

指定者:

getResult 在类中 AbstractStorelessUnivariateStatistic

返回:

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

getN

             public long getN()
            

返回已添加值的数量。

指定者:

getN 在接口中 StorelessUnivariateStatistic

返回:

值的数量。

clear

             public void clear()
            

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

指定者:

clear 在接口中 StorelessUnivariateStatistic

指定者:

clear 在类中 AbstractStorelessUnivariateStatistic

aggregate

             public void aggregate(SumOfLogs other)
            

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

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

指定者:

aggregate 在接口中 AggregatableStatistic<SumOfLogs>

参数:

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

evaluate

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

返回输入数组指定部分中条目的自然对数之和，如果指定的子数组为空，则返回Double.NaN。

指定者:

evaluate 在接口中 MathArrays.Function

指定者:

evaluate 在接口中 StorelessUnivariateStatistic

指定者:

evaluate 在接口中 UnivariateStatistic

参数:

values - 输入数组

begin - 要包含的第一个数组元素的索引

length - 要包含的元素数

返回:

值的自然对数之和，如果长度为0，则为0

抛出:

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

另请参阅:

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

copy

             public SumOfLogs copy()
            

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

指定者:

copy 在接口中 StorelessUnivariateStatistic

指定者:

copy 在接口中 UnivariateStatistic

指定者:

copy 在类中 AbstractStorelessUnivariateStatistic

返回:

统计量的副本