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

类 Product

java.lang.Object

org.hipparchus.stat.descriptive.AbstractStorelessUnivariateStatistic

org.hipparchus.stat.descriptive.summary.Product

所有已实现的接口:

Serializable, DoubleConsumer, AggregatableStatistic<Product>, StorelessUnivariateStatistic, UnivariateStatistic, WeightedEvaluation, MathArrays.Function

       public class Product extends AbstractStorelessUnivariateStatistic implements AggregatableStatistic<Product>, WeightedEvaluation, Serializable
      

返回可用值的乘积。

如果数据集中没有值，则返回1。如果任何值为NaN，则返回NaN。

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

另请参阅:

• 序列化表格

构造器概要

构造器

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

方法概要

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

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

evaluate

构造器详细资料

Product

             public Product()
            

创建一个Product实例。

Product

             public Product(Product original) throws NullArgumentException
            

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

参数:

original - 要复制的Product实例

抛出:

NullArgumentException - 如果original为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(Product other)
            

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

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

指定者:

aggregate 在接口中 AggregatableStatistic<Product>

参数:

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，则为1

抛出:

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

另请参阅:

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

evaluate

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

返回输入数组指定部分中条目的加权乘积，如果指定的子数组为空，则返回Double.NaN。

如果以下任一情况为真，则抛出MathIllegalArgumentException：

• 值数组为null
• 权重数组为null
• 权重数组的长度与值数组的长度不同
• 权重数组包含一个或多个无限值
• 权重数组包含一个或多个NaN值
• 权重数组包含负值
• 开始和长度参数未确定有效数组

使用公式\(\mathrm{加权乘积} = \prod \mathrm{values}_i^{\mathrm{weights}_i}\)

即，在计算加权乘积时，权重作为指数应用。

指定者:

evaluate 在接口中 WeightedEvaluation

参数:

values - 输入数组

weights - 权重数组

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

length - 要包括的元素数量

返回:

值的乘积，如果长度为0，则返回1

抛出:

MathIllegalArgumentException - 如果参数无效

copy

             public Product copy()
            

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

指定者:

copy 在接口中 StorelessUnivariateStatistic

指定者:

copy 在接口中 UnivariateStatistic

指定者:

copy 在类中 AbstractStorelessUnivariateStatistic

返回:

统计数据的副本