STATISTICS コマンド

コンセプト情報

統計の生成

Analytics テーブルで、1 つ以上の数値または日付時刻フィールドについて統計計算します。

構文

STATISTICS {<ON> フィールド名 <...n>|<ON> ALL <EXCLUDE フィールド名 <...n>>} <STD> <MODMEDQ> <NUMBER n> <TO {SCREEN|ファイル名|PRINT}> <IF テスト> <WHILE テスト> <FIRST 範囲|NEXT 範囲> <APPEND>

パラメーター

名前 説明
ON フィールド名 <...n> | ON ALL

合計する 1 つ以上の数値または日付時刻フィールドを指定するか、あるいは、Analytics テーブル内の数値フィールドと日付時刻フィールドすべてについて統計を生成する場合は ON ALL を指定します。

EXCLUDE フィールド名

省略可能

ON ALL を使用して統計情報を生成するときにのみ有効です。

コマンドから除外するフィールド。EXCLUDE では、指定したフィールドを除外して、ON ALL を微調整できます。

EXCLUDE は ON ALL の直後に置く必要があります。例:

ON ALL EXCLUDE field_1 field_2

STD

省略可能

STD を指定すると、指定したフィールドの標準偏差もほかの統計情報と共に計算されます。

MODMEDQ

省略可能

指定したフィールド群の最頻値、中央値、上位四分位数、および 3 番目の四分位数値を他の統計のほかに計算します。

NUMBER n

省略可能

処理の間に保持しておく高値と低値の数。デフォルト値は 5 です。

TO SCREEN | ファイル名 | PRINT

省略可能

コマンドの結果を送信する場所:

  • 画面 - Analytics の表示領域に結果を表示します

    ヒント

    表示領域内で、リンク付きの任意の結果値をクリックすると、関連付けられているソース テーブル内の 1 つまたは複数のレコードにドリルダウンすることができます。

  • ファイル名は結果の保存先となるファイルです。

    ファイル名には、適切なファイル拡張子を付けた文字列を引用符で囲んで指定します。例:TO "Output.TXT"

    デフォルトでは、テーブル ファイルは、Analytics プロジェクトが入っているフォルダーに保存されます。

    既存の異なるフォルダーにファイルを保存するには、絶対または相対ファイル パスを指定します。

    • TO "C:\Output.TXT"
    • TO "Results\Output.TXT"
  • 印刷 – 通常使うプリンターに結果を送信します

IF テスト

省略可能

各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。

メモ

IF パラメーターは、任意の範囲パラメーター(WHILE、FIRST、NEXT)が適用された後に、テーブルに残るレコードに対してのみ評価されます。

WHILE テスト

省略可能

各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。

メモ

WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。

FIRST 範囲 | NEXT 範囲

省略可能

処理するレコード数:

  • FIRST 指定されたレコード数に達するまで、最初のレコードから処理を開始します
  • NEXT 指定されたレコード数に達するまで、現在選択されているレコードから処理を開始します

範囲は処理するレコード数を指定します。

FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。

APPEND

省略可能

コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。

メモ

コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。

  • 同じフィールド
  • 同じフィールド順序
  • 一致するフィールドが同じ長さ
  • 一致するフィールドが同じデータ型

出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。

Analytics の出力変数

メモ

テーブル内の複数のフィールドを対象として統計を生成した場合、システムで生成される出力変数には、最初に列挙したフィールドの値が含まれています。

名前 含む
ABSn

コマンドによって計算された絶対値。

日付時刻フィールドについては計算されません。

AVERAGEn

コマンドによって計算された平均値。

COUNTn

コマンドによって計算されたレコード数。

  • 変数名が COUNT1 の場合、それは最近実行されたコマンドのレコード数を格納しています。
  • 変数名 COUNTnn が 1 より大きい場合、変数は GROUP コマンドの内で実行されたコマンドのレコード数を格納しています。

    n の値は GROUP 内のコマンドの行番号に基づいて割り当てられます。たとえば、コマンドが GROUP コマンドの 1 行下にある場合、値は COUNT2 が割り当てられます。コマンドが GROUP コマンドの 4 行下にある場合、値は COUNT5 が割り当てられます。

HIGHn

このコマンドによって確認された 5 番目に高い値、つまり最新の日付から 5 番目の日付。

5 番目に高い値はデフォルト設定です。この設定を変更するには NUMBER パラメーターを使用します。たとえば、NUMBER 3 は、3 番目に高い値を格納することを指定するものです。

メモ

Analytics で最も高い値が確認される際、重複値は除外されません。たとえば、降順の値リストが 100、100、99、98 の場合、3 番目に高い値は 98 でなく 99 になります。

LOWn

このコマンドによって確認された 5 番目に低い値、つまり最も古いほうから 5 番目の日付。

5 番目に低い値はデフォルト設定です。この設定を変更するには NUMBER パラメーターを使用します。たとえば、NUMBER 3 は、3 番目に低い値を格納することを指定するものです。

メモ

Analytics で最も低い値が確認される際、重複値は除外されません。たとえば、昇順の値リストが 1、1、2、3 の場合、3 番目に低い値は 3 でなく 2 になります。

MAXn

このコマンドによって確認された最大値、つまり最も新しい日付。

MEDIANn

コマンドによって確認された中央値。

日付中央値はシリアル日付時刻値として表示されます。

MINn このコマンドによって確認された最小値、つまり最も古い日付。
MODEn

コマンドによって確認された最頻値。

モーダル日付はシリアル日付時刻値として表示されます。

Q25n

コマンドによって計算された最初の四分位数値(下位四分位数値)。

最初の四分位日付はシリアル日付時刻値として表示されます。

Q75n

コマンドによって計算された 3 番目の四分位数値(上位四分位数値)。

3 番目の四分位日付はシリアル日付時刻値として表示されます。

RANGEn コマンドによって計算された最大値と最小値の差。
STDDEVn コマンドによって計算された標準偏差値。
TOTALn

コマンドによって計算された最初の合計値。

TOTAL コマンドが GROUP コマンド内になければ、n の値は 1 です。n の値は GROUP コマンド内の TOTAL コマンドの行番号に相当します。

詳細については、GROUP コマンドを参照してください。

日付時刻フィールドの場合、フィールド内のすべてのシリアル日付時刻値の合計。

条件付き統計を生成する

次の例では、製品クラス ID(ProdCls)が '01' であるレコードの、数量(Qty)フィールドの統計を生成しています。

STATISTICS ON Quantity IF ProdCls = "01"

備考

すべての統計は数値フィールドに対して生成されます。日付時刻フィールドにはサブセットの統計のみが生成されます。

いくつかの日付時刻統計は、シリアル日付時刻値として表示されます。変換関数を使用して、シリアル日付時刻値を人間が判読できる通常の日付時刻値に変換できます。詳細については、シリアル日付時刻を参照してください。

統計名 数値フィールド 日付時刻フィールド
範囲 最高値および最低値の間の差 最新の日付と最も古い日付の間の日数
  • 正の値の数

  • 正の値の合計

  • 正の値の平均

  • 日付時刻値の数

  • すべてのシリアル日付時刻値の合計

    日付や、時点を表す時間値に対して意味はありません。時間の合計を表す時間値に対して有意です。

    詳細については、時間の量と時点を参照してください。

  • 平均日付時刻値

  • 負の値の数

  • 負の値の合計

  • 負の値の平均

該当なし、生成されません
ゼロ ゼロの値の数 空白の日付の数
合計
  • 正、負およびゼロの値の数の合計

  • 正、負およびゼロのすべての値の合計

  • 正、負およびゼロのすべての値の平均

該当なし、生成されません
絶対値 数値の符号を無視した、値すべての合計 該当なし、生成されません
標準偏差(オプション) 平均値からの標準偏差

平均日付時刻値からの標準偏差

統計を画面に出力するときには表示されませんが、システム生成出力変数 STDDEVn にキャプチャされます。

中央値(省略可能) 中央値
  • 奇数の値セット:中央値

  • 偶数の値セット:中央にある 2 つの値の平均

日付中央値
  • 奇数の日付セット:日付中央値

  • 偶数の日付セット:中央にある 2 つの日付の平均

Q25(省略可能) 最初の四分位数値(下四分位数値)
  • 結果は Analytics のアルゴリズムによって計算された補間値である

  • Microsoft Excel の QUARTILE および QUARTILE.INC 関数と同じ結果を生成する

最初の四分位日付(下四分位日付)
  • 結果は Analytics のアルゴリズムによって計算された補間値である

  • Microsoft Excel の QUARTILE および QUARTILE.INC 関数の結果から 1 日分オフセットします

    詳細については、シリアル日付時刻を参照してください。

Q75(省略可能) 3 番目の四分位数(下四分位数)
  • 結果は Analytics のアルゴリズムによって計算された補間値である

  • Microsoft Excel の QUARTILE および QUARTILE.INC 関数と同じ結果を生成する

3 番目の四分位日付(下四分位日付)
  • 結果は Analytics のアルゴリズムによって計算された補間値である

  • Microsoft Excel の QUARTILE および QUARTILE.INC 関数の結果から 1 日分オフセットします

    詳細については、シリアル日付時刻を参照してください。

最頻値(省略可能) 最も頻繁に発生する値
  • 2 回以上出現する値がない場合は、"N/A" が表示される

  • 関連付けの場合は、最も低い値が表示される

最も頻繁に発生する日付
  • 2 回以上出現する日付がない場合は、「N/A」が表示される

  • 関連付けの場合は、最も古い値が表示される

最高値

最高値から 5 番目までの値

統計]ダイアログボックスの[詳細]タブにある[高/低の #]設定で、高い値を変更することができます。

最新の日付順の上位 5 件

統計]ダイアログボックスの[詳細]タブにある[高/低の #]設定で、最近の日付の数を変更することができます。

最低値

最低値から 5 番目までの値

統計]ダイアログボックスの[詳細]タブにある[高/低の #]設定で、低い値を変更することができます。

最も古い日付順の上位 5 件

統計]ダイアログボックスの[詳細]タブにある[高/低の #]設定で、最も古い日付の数を変更することができます。