このページでは、LookML ダッシュボード タイルに基準線を適用するための LookML パラメータについて説明します。これらは、棒グラフと swap_axes が true に設定されているグラフを除くすべてのグラフで機能します。
基準線を使用すると、Looker の任意のデカルト図に線と領域を配置できます。静的な値、またはグラフのデータから計算された特定の統計関数を使用できます。
構成
基準線は、Looker の散布図、面グラフ、折れ線グラフ、縦棒グラフ、横棒グラフのダッシュボード構成のオプションとして指定されます。
現在、基準線はこれらのグラフの最初の系列でのみサポートされています。
グラフに基準線をいくつでも追加できます。
reference_lines 構成オプションは、参照線の配列を受け取ります。各項目はオプションのハッシュです。
たとえば、次の構成では、y 軸の値 90 に「Sales Goal」というラベルの付いたクリムゾンの基準線が作成されます。
reference_lines:
- value: 90
label: Sales Goal
color: crimson
定数線の描画
基準線の必須フィールドは value のみです。参照を描画する場所を指定します。
グラフの「50」のマークに 1 本の線を描画するには、次のように構成を指定します。
reference_lines:
- value: 50
値の計算
基準線の値に数値を指定する代わりに、計算名を指定できます。
すべての値の計算は、データセット全体ではなく、クエリから返されたデータセットに基づきます。
median- データセットの中央値。mean- データセットの平均値。max- データセットの最大値。min- データセットの最小値。deviation- データセットの標準偏差。variance- データセットの統計分散。
データセットの中央値に線を描画するには、これを指定します。
reference_lines:
- value: median
中央値、定数値、最大値の 3 本の線を描画するには、次のように構成を指定します。
reference_lines:
- value: median
- value: 25
- value: max
エリアを描画する
基準線に単一の数値または計算名を指定する代わりに、配列を指定できます。
指定された配列に 2 つの値が含まれている場合、範囲の境界として扱われます。
reference_lines:
- value: [60, 90]
label: Butter Zone
color: orange
次の構成では、データポイントが平均値を上回る領域を表す領域をシェーディングします。
reference_lines:
- value: [max, mean]
label: Above Average
行とエラー
value パラメータには、3 つの数値または計算名の配列を指定できます。
この構成では、最初の値は基準線「下」のエラーとして扱われ、中央の値は線自体の値と見なされ、3 番目の値は基準線「上」のエラーとして扱われます。
error below, reference line value, error above
たとえば、販売目標が 60 個で、許容範囲が +/- 5 個の場合、これをグラフで表すと次のようになります。
reference_lines:
- value: [5, 60, 5]
label: Target Sales
標準偏差を示す平均値を指定する方法は次のとおりです。
reference_lines:
- value: [deviation, mean, deviation]
ラベル
label 属性を含めて、任意のテキストで行にラベルを付けることができます。
reference_lines:
- value: 90
label: Sales Goal
グラフで使用するかどうかに関係なく、ラベルに計算値を含めるかどうかを選択できます。
計算名を二重中かっこで囲みます（{{median}}）。この場合、ラベル文字列を引用符で囲む必要があります。
reference_lines:
- value: 50
label: "Target (Average: {{mean}})"
色
color 属性を含めて、線とテキストの色を指定できます。
カラー値は、#2ca6cd などの 16 進数文字列、または CSS 指定のカラー文字列にすることができます。