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

类 StandardDeviation

java.lang.Object
org.hipparchus.stat.descriptive.AbstractStorelessUnivariateStatistic
org.hipparchus.stat.descriptive.moment.StandardDeviation
所有已实现的接口:
Serializable, DoubleConsumer, StorelessUnivariateStatistic, UnivariateStatistic, MathArrays.Function
public class StandardDeviation extends AbstractStorelessUnivariateStatistic implements Serializable
计算样本标准差。

标准差是方差的正平方根。此实现包装了一个Variance实例。

包装的Variance实例的isBiasCorrected属性是公开的，因此这个类可用于计算"样本标准差"（偏差校正的"样本方差"的平方根）或"总体标准差"（非偏差校正的"总体方差"的平方根）。更多信息请参阅Variance。

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

另请参阅:

  • 构造器详细资料

    • StandardDeviation

      public StandardDeviation()
      构造一个StandardDeviation。将底层的Variance实例的isBiasCorrected属性设置为true。

    • StandardDeviation

      public StandardDeviation(SecondMoment m2)
      从外部二阶矩构造一个StandardDeviation。
      参数:
      m2 - 外部矩

    • StandardDeviation

      public StandardDeviation(boolean isBiasCorrected)
      使用指定的isBiasCorrected属性值构造一个StandardDeviation。如果此属性设置为true，则用于计算结果的Variance将使用偏差校正或"样本"公式。有关详细信息，请参阅Variance。
      参数:
      isBiasCorrected - 方差计算是否使用偏差校正公式

    • StandardDeviation

      public StandardDeviation(boolean isBiasCorrected, SecondMoment m2)
      使用指定的isBiasCorrected属性值和提供的外部矩构造一个StandardDeviation。如果isBiasCorrected设置为true，则用于计算结果的Variance将使用偏差校正或"样本"公式。有关详细信息，请参阅Variance。
      参数:
      isBiasCorrected - 方差计算是否使用偏差校正公式
      m2 - 外部矩

    • StandardDeviation

      public StandardDeviation(StandardDeviation original) throws NullArgumentException
      复制构造函数，创建一个与原始StandardDeviation相同的新实例。
      参数:
      original - 要复制的StandardDeviation实例
      抛出:
      NullArgumentException - 如果原始实例为null

  • 方法详细资料

    • increment

      public void increment(double d)
      更新统计量的内部状态以反映添加新值。
      指定者:
      increment 在接口中 StorelessUnivariateStatistic
      指定者:
      increment 在类中 AbstractStorelessUnivariateStatistic
      参数:
      d - 新值。

    • getN

      public long getN()
      返回已添加的值的数量。
      指定者:
      getN 在接口中 StorelessUnivariateStatistic
      返回:
      值的数量。

    • getResult

      public double getResult()
      返回统计量的当前值。
      指定者:
      getResult 在接口中 StorelessUnivariateStatistic
      指定者:
      getResult 在类中 AbstractStorelessUnivariateStatistic
      返回:
      统计量的值，如果已清除或刚实例化，则为Double.NaN。

    • clear

      public void clear()
      清除统计量的内部状态。
      指定者:
      clear 在接口中 StorelessUnivariateStatistic
      指定者:
      clear 在类中 AbstractStorelessUnivariateStatistic

    • evaluate

      public double evaluate(double[] values, int begin, int length) throws MathIllegalArgumentException
      返回指定数组部分的条目的标准差，如果指定的子数组为空，则返回Double.NaN。

      对于单个值（即长度=1）的样本，返回0。

      不会改变统计量的内部状态。

      指定者:
      evaluate 在接口中 MathArrays.Function
      指定者:
      evaluate 在接口中 StorelessUnivariateStatistic
      指定者:
      evaluate 在接口中 UnivariateStatistic
      参数:
      values - 输入数组
      begin - 要包括的第一个数组元素的索引
      length - 要包括的元素数量
      返回:
      值的标准偏差，如果长度 = 0，则返回Double.NaN
      抛出:
      MathIllegalArgumentException - 如果数组为null或数组索引参数无效
      另请参阅:

    • evaluate

      public double evaluate(double[] values, double mean, int begin, int length) throws MathIllegalArgumentException
      返回指定输入数组的指定部分的标准偏差，使用预先计算的均值。如果指定的子数组为空，则返回Double.NaN。

      对于单个值（即长度 = 1）的样本，返回0。

      使用的公式假定提供的均值是样本数据的算术平均值，而不是已知的总体参数。此方法仅用于在已经计算均值时节省计算。

      不会改变统计数据的内部状态。

      参数:
      values - 输入数组
      mean - 预先计算的均值
      begin - 要包括的第一个数组元素的索引
      length - 要包括的元素数量
      返回:
      值的标准偏差，如果长度 = 0，则返回Double.NaN
      抛出:
      MathIllegalArgumentException - 如果数组为null或数组索引参数无效

    • evaluate

      public double evaluate(double[] values, double mean) throws MathIllegalArgumentException
      返回使用预先计算的均值值的输入数组的条目的标准偏差。如果指定的子数组为空，则返回Double.NaN。

      对于单个值（即长度 = 1）的样本，返回0。

      使用的公式假定提供的均值是样本数据的算术平均值，而不是已知的总体参数。此方法仅用于在已经计算坝值时节省计算。

      不会改变统计数据的内部状态。

      参数:
      values - 输入数组
      mean - 预先计算的均值
      返回:
      值的标准偏差，如果长度 = 0，则返回Double.NaN
      抛出:
      MathIllegalArgumentException - 如果数组为null

    • isBiasCorrected

      public boolean isBiasCorrected()
      检查是否已校正偏差。
      返回:
      返回isBiasCorrected。

    • withBiasCorrection

      public StandardDeviation withBiasCorrection(boolean biasCorrection)
      返回具有给定偏差校正设置的此标准偏差的新副本。
      参数:
      biasCorrection - 要设置的偏差校正标志。
      返回:
      具有给定偏差校正设置的此实例的副本

    • copy

      public StandardDeviation copy()
      返回具有相同内部状态的统计数据的副本。
      指定者:
      copy 在接口中 StorelessUnivariateStatistic
      指定者:
      copy 在接口中 UnivariateStatistic
      指定者:
      copy 在类中 AbstractStorelessUnivariateStatistic
      返回:
      统计数据的副本