パッケージ org.opengion.plugin.table

# クラス StandardDeviation

java.lang.Object
org.opengion.plugin.table.StandardDeviation

class StandardDeviation extends Object
StandardDeviation は、登録されたデータから、標準偏差等の値を求めます。 このﾌﾟﾛｸﾞﾗﾑは、０データを無視する特殊な計算をしています。 これは、成形条件ﾐﾄﾞﾙｳｴｱが、０をﾃﾞｰﾀなしとして扱っているためです。 よって、一般的な標準偏差等の値を求めることは出来ません。 ここではデータを追加していき、取り出すときに、計算した値を文字列配列で返します。 作成するカラムは、CNT,SUM,AVG,(STDEVS or STDEVP),COEFF,M3S,M2S,M1S,M0S,P0S,P1S,P2S,P3S です。 CNT(個数),SUM(合計),AVG(平均), STDEVS(標本標準偏差:n-1) または、STDEVP(母標準偏差:n) を、useDEVP(trueで、母標準偏差) で選択します。 COEFF(変動係数) は、標準偏差(σ)を算術平均で、割ったものの百分率 M3S(～-3σ),M2S(-3σ～-2σ),M1S(-2σ～-σ),M0S(-σ～0),P0S(0～σ),P1S(σ～2σ),P2S(2σ～3σ),P3S(3σ～) FILTERは、1:(-2σ～-σ or σ～2σ) , 2:(-3σ～-2σ or 2σ～3σ) , 3:(～-3σ or 3σ～) のみピックアップします。 初期値の 0 は、フィルターなしです。 6.9.9.2 (2018/09/18) COEFF(変動係数)の最小値でフィルターするためのｷｰﾜｰﾄﾞ MIN_CV を追加します。 これは、単位(%)で、指定の値以下の変動係数のﾚｺｰﾄﾞを出力しません。

変更履歴:
  6.7.7.0 (2017/03/31) 新規追加, 6.9.3.0 (2018/03/26) 標本標準偏差と母標準偏差は、一つだけにし、変動係数を追加します。
導入されたバージョン:
  JDK1.8,

- ## フィールドの概要

  フィールド
  修飾子とタイプ
  フィールド
  説明
  `static final String[]`
  `ADD_CLMS`
  追加カラム列

- ## コンストラクタの概要

  コンストラクタ
  コンストラクタ
  説明
  `StandardDeviation(int ftype, boolean useDEVP, String format, String minCV)`
  各種条件を指定した標準偏差計算用のインスタンスを作成します。

- ## メソッドの概要

  修飾子とタイプ
  メソッド
  説明
  `void`
  `addData(String strVal)`
  データを追加します。
  `void`
  `clear()`
  内部情報を、初期化します。
  `String[]`
  `getData()`
  データから計算した結果を、文字列に変換して、返します。

  ### クラスから継承されたメソッド java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## フィールド詳細

  - ### ADD_CLMS

    public static final String[] ADD_CLMS
    追加カラム列

- ## コンストラクタの詳細

  - ### StandardDeviation

    public StandardDeviation(int ftype, boolean useDEVP, String format, String minCV)
    各種条件を指定した標準偏差計算用のインスタンスを作成します。
    パラメータ:
      `ftype` - フィルタータイプ(0,1,2,3)
      `useDEVP` - 初期値が、"P" (母標準偏差)
      `format` - 初期値が、"%.3f"
      `minCV` - 変動係数の最小値(%)
    変更履歴:
      6.7.7.0 (2017/03/31) 新規追加。, 6.9.9.2 (2018/09/18) COEFF(変動係数)の最小値でフィルターするためのｷｰﾜｰﾄﾞ MIN_CV を追加。

- ## メソッドの詳細

  - ### clear

    public void clear()
    内部情報を、初期化します。
    変更履歴:
      6.7.7.0 (2017/03/31) 新規追加。

  - ### addData

    public void addData(String strVal)
    データを追加します。 引数の文字列を、double に変換して使用します。 変換できない場合は、エラーにはなりませんが、警告を出します。 ただし、値が、0.0 の場合は、対象外にします。
    パラメータ:
      `strVal` - データ
    変更履歴:
      6.7.7.0 (2017/03/31) 新規追加。, 6.9.2.0 (2018/03/05) 分散の計算方法を変更

  - ### getData

    public String[] getData()
    データから計算した結果を、文字列に変換して、返します。 標準偏差の式を σ＝sqrt(Σ(Xi - Xave)^2 / n) から σ＝sqrt(Σ(Xi^2) / n - Xave^2)) に変形します。 参考：http://imagingsolution.blog107.fc2.com/blog-entry-62.html
    戻り値:
      データから計算した結果(無い場合は、長さゼロの配列)
    変更履歴:
      6.7.7.0 (2017/03/31) 新規追加。, 6.9.2.0 (2018/03/05) 分散の計算方法を変更, 6.9.3.0 (2018/03/26) 標本標準偏差と母標準偏差は、一つだけにし、変動係数を追加します。, 6.9.9.2 (2018/09/18) COEFF(変動係数)の最小値でフィルターするためのｷｰﾜｰﾄﾞ MIN_CV を追加。, 7.3.0.0 (2021/01/06) SpotBugs:null ではなく長さが0の配列を返すことを検討する
    このﾒｿｯﾄﾞは、nullを返しません