Auf dieser Seite werden die LookML-Parameter zum Anwenden einer Referenzlinie auf eine LookML-Dashboard-Kachel dokumentiert. Sie funktionieren für alle Diagramme außer Balkendiagrammen und für alle, bei denen swap_axes
auf „true“ gesetzt wurde.
Mit Referenzlinien können Sie Linien und Regionen in allen cartes-Diagrammen von Looker platzieren. Sie können statische Werte oder bestimmte statistische Funktionen verwenden, die aus den Daten des Diagramms berechnet werden.
Konfiguration
Referenzlinien werden in der Dashboard-Konfiguration für die Streu-, Flächen-, Linien-, Säulen- und Balkendiagramme von Looker als Option angegeben.
Referenzlinien werden derzeit nur in der ersten Reihe dieser Diagramme unterstützt.
Jedes Diagramm kann eine unbegrenzte Anzahl von Referenzlinien haben.
Die Konfigurationsoption reference_lines
verwendet ein Array von Referenzlinien, von denen jedes Element ein Hash der Optionen ist.
Die Konfigurationsoption für das folgende Diagramm wird so implementiert:
reference_lines:
- value: 90
label: Sales Goal
color: crimson
Konstante Linie zeichnen
value
ist das einzige Pflichtfeld für eine Referenzlinie. Es gibt an, wo die Referenz gezeichnet werden soll.
Wenn Sie eine einzelne Linie an der Markierung „50“ im Diagramm zeichnen möchten, geben Sie die Konfiguration so an:
reference_lines:
- value: 50
Wertberechnungen
Anstelle einer Zahl für den Referenzlinienwert können Sie auch einen Berechnungsnamen angeben.
Alle Wertberechnungen basieren auf dem von der Abfrage zurückgegebenen Dataset und nicht auf dem gesamten Dataset.
median
: Der Medianwert des Datasets.mean
: Der Durchschnittswert des Datasets.max
: Der Höchstwert des Datasets.min
: Der Mindestwert des Datasets.deviation
: Die Standardabweichung des Datasets.variance
: Die statistische Varianz des Datasets.
Geben Sie diese Option an, um eine Linie am Medianwert des Datasets zu zeichnen.
reference_lines:
- value: median
Wenn Sie drei Linien zeichnen möchten, eine im Medianwert, eine mit konstantem Wert und eine mit dem Höchstwert, geben Sie die Konfiguration so an:
reference_lines:
- value: median
- value: 25
- value: max
Bereich zeichnen
Anstatt eine einzelne Zahl oder einen Berechnungsnamen für Ihre Referenzlinie anzugeben, können Sie ein Array angeben.
Wenn das angegebene Array genau zwei Werte hat, wird es als die Grenze eines Bereichs behandelt.
reference_lines:
- value: [60, 90]
label: Butter Zone
color: orange
In der folgenden Konfiguration wird ein Bereich schattiert, der einen Bereich darstellt, in dem Datenpunkte über dem Durchschnitt liegen.
reference_lines:
- value: [max, mean]
label: Above Average
Zeilen und Fehler
Sie können dem Parameter value
ein Array mit drei Zahlen oder Berechnungsnamen angeben.
In dieser Konfiguration wird der erste Wert als Fehler "unter" der Referenzlinie, der mittlere Wert als Wert für die Zeile selbst und der dritte Wert als Fehler "oberhalb" der Referenzlinie behandelt.
error below, reference line value, error above
Nehmen wir an, Ihr Verkaufsziel liegt bei 60 Einheiten, aber die Zahl von +/- 5 liegt innerhalb des zulässigen Bereichs. Das lässt sich in einer Grafik wie dieser veranschaulichen:
reference_lines:
- value: [5, 60, 5]
label: Target Sales
So können Sie den Durchschnittswert für die Standardabweichung angeben:
reference_lines:
- value: [deviation, mean, deviation]
Labels
Sie können ein label
-Attribut angeben, um die Zeile mit einem beliebigen Text zu kennzeichnen.
reference_lines:
- value: 90
label: Sales Goal
Sie können berechnete Werte in das Label aufnehmen, unabhängig davon, ob Sie sie im Diagramm verwenden oder nicht.
Setzen Sie den Berechnungsnamen in doppelte geschweifte Klammern: {{median}}
. In diesem Fall müssen Sie den Labelstring in Anführungszeichen setzen.
reference_lines:
- value: 50
label: "Target (Average: {{mean}})"
Farben
Sie können das Attribut color
verwenden, um die Linie und den Text einzufärben.
Farbwerte können jeweils ein Hexadezimalstring wie #2ca6cd
oder ein CSS-benannter Farbstring sein.