@CORRELATION
2つのパラレル・データ・セット(XrangeList1とXrangeList2)間の相関係数を返します。 相関係数によって、2つのデータ・セット間の関係が決まります。
構文
@CORRELATION (SKIPNONE | SKIPMISSING | SKIPZERO | SKIPBOTH, XrangeList1, XrangeList2)
パラメータ
- SKIPNONE
-
相関係数の計算時に、2つのデータ・セットで指定されたすべてのセルを、その内容に関係なく含めます。
- SKIPMISSING
-
相関係数の計算時に、2つのデータ・セットからすべての
#MISSING
値を除外します。 - SKIPZERO
-
相関係数の計算時に、2つのデータ・セットからすべてのゼロ(0)値を除外します。
- SKIPBOTH
-
相関係数の計算時に、すべてのゼロ(0)値および
#MISSING
値を2つのデータ・セットから除外します。 - XrangeList1
-
2つのパラレル・データ・セットのうちの最初の方。
有効なメンバー名、メンバー名のカンマ区切りリスト、ディメンション間メンバー、またはメンバー・セット関数または範囲関数(@XRANGEを含む)からの戻り値を指定できます。
XrangeListの詳細は、「範囲関数と財務関数」のトピックの「範囲リスト・パラメータ」を参照してください。
- XrangeList2
-
2つのパラレル・データ・セットのうち2つ目の方。
有効なメンバー名、メンバー名のカンマ区切りリスト、ディメンション間メンバー、またはメンバー・セット関数または範囲関数(@XRANGEを含む)からの戻り値を指定できます。
ノート
-
@RANGE関数の使用方法の詳細は、@RANGEを参照してください。 XrangeListの詳細は、「範囲関数と財務関数」のトピックの「範囲リスト・パラメータ」を参照してください。
-
XrangeList1およびXrangeList2パラメータは、同じ数のデータ・ポイントを持つ必要があります。 2つのデータ・セットのデータ・ポイント数が異なる場合、この関数は
#MISSING
を戻します。 -
この関数は、XrangeList1およびXrangeList2(1)が空の場合、(2)
#MISSING
値のみが含まれている場合、または(3)標準偏差が0 (すべての値が定数)の場合に#MISSING
を戻します。 -
SKIPMISSINGまたはSKIPBOTHが指定されていないかぎり、この関数は
#MISSING
値をゼロ(0)値として処理します。 XrangeList1の値が#MISSING
で、SKIPMISSINGが指定されている場合、XrangeList1の対応する値は#MISSING
として扱われます。 (つまり、計算の前に両方の値が削除されます。) SKIPZEROとSKIPBOTHも同様に機能します。 -
この関数は、 -1から1の値を戻します。
-
メンバー・セット関数を使用してこの関数(@SIBLINGSなど)のメンバー・リストを生成する場合は、生成されたメンバー・リストがEssbaseによってソートされる順序を考慮してください。 詳細は、使用しているメンバー・セット関数のトピックを参照してください。
-
相関係数の方程式は次のとおりです:
例
次の例は、Sample Basicデータベースに基づいています。 Measuresディメンションに追加のメンバーSales Correlが含まれているとします。 計算スクリプトは、一連のメンバー(Qtr1およびQtr2の子の場合はSales)の相関係数を計算します。 計算スクリプトはJunで修正されるため、結果はSales Correl->Junに配置されます。
この例では、@RANGE関数を使用してXrangeList1およびXrangeList2を生成します:
FIX(June)
"Sales Correl"=@CORRELATION(SKIPNONE,
@RANGE(Sales,@CHILDREN(Qtr1)),@RANGE(Sales,@CHILDREN(Qtr2)));
ENDFIX
この例では、次のレポートが作成されます:
Colas Actual New York
Sales Sales Correl
===== ============
Jan 678 #MI
Feb 645 #MI
Mar 675 #MI
Apr 712 #MI
May 756 #MI
Jun 890 0.200368468
次の例は、YearディメンションがSample Basicに追加されていることを前提としています。 データ・セット内のディメンション間メンバーを使用して相関係数を計算します。
FIX(Product)
"Sales Correl" = @CORRELATION(SKIPNONE,@XRANGE("2011"->"Sep", "2012"->"Mar"),@XRANGE("2012"->"Sep", "2013"->"Mar"));
ENDFIX
前述の相関は、XrangeList1およびXrangeList2で指定された次の2つの多ディメンション範囲にわたって計算されます:
2011->Sep
2011->Oct
2011->Nov
2011->Dec
2012->Jan
2012->Feb
2012->Mar
2012->Sep
2012->Oct
2012->Nov
2012->Dec
2013->Jan
2013->Feb
2013->Mar
関連項目