Cette page décrit les paramètres LookML permettant d'appliquer une ligne de référence à une tuile de tableau de bord LookML. Ils fonctionnent pour tous les graphiques, à l'exception des graphiques à barres et de ceux où swap_axes a été défini sur "true".
Les lignes de référence vous permettent de placer des lignes et des régions sur n'importe quel graphique cartésien de Looker. Vous pouvez utiliser des valeurs statiques ou certaines fonctions statistiques calculées à partir des données du graphique.
Configuration
Les lignes de référence sont spécifiées comme une option dans la configuration du tableau de bord pour les graphiques à nuage de points, en aires, en courbes, à colonnes et à barres de Looker.
Les lignes de référence ne sont actuellement disponibles que pour la première série de ces graphiques.
Vous pouvez ajouter un nombre illimité de lignes de référence à n'importe quel graphique.
L'option de configuration reference_lines accepte un tableau de lignes de référence, dont chaque élément est un hachage d'options.
Par exemple, la configuration suivante crée une ligne de référence écarlate intitulée "Objectif de vente" à la valeur 90 de l'axe Y :
reference_lines:
- value: 90
label: Sales Goal
color: crimson
Tracer une ligne constante
value est le seul champ obligatoire pour une ligne de référence. Elle spécifie où dessiner la référence.
Pour tracer une seule ligne à la marque "50" du graphique, spécifiez votre configuration comme suit :
reference_lines:
- value: 50
Calculs de la valeur
Au lieu de spécifier un nombre pour la valeur de votre ligne de référence, vous pouvez spécifier un nom de calcul.
Tous les calculs de valeurs sont basés sur l'ensemble de données renvoyé par la requête, et non sur l'intégralité de votre ensemble de données.
median: valeur médiane de l'ensemble de données.mean: valeur moyenne de l'ensemble de données.max: valeur maximale de l'ensemble de données.min: valeur minimale de l'ensemble de données.deviation: écart type de l'ensemble de données.variance: variance statistique de l'ensemble de données.
Pour tracer une ligne à la valeur médiane de votre ensemble de données, spécifiez ceci.
reference_lines:
- value: median
Pour tracer trois lignes (une à la médiane, une à une valeur constante et une au maximum), configurez votre graphique comme suit :
reference_lines:
- value: median
- value: 25
- value: max
Dessiner une zone
Au lieu de spécifier un seul nombre ou un seul nom de calcul pour votre ligne de référence, vous pouvez fournir un tableau.
Si le tableau fourni comporte exactement deux valeurs, il est traité comme les limites d'une plage.
reference_lines:
- value: [60, 90]
label: Butter Zone
color: orange
La configuration suivante ombrage une zone qui représente une zone où les points de données sont supérieurs à la moyenne.
reference_lines:
- value: [max, mean]
label: Above Average
Lignes et erreurs
Vous pouvez fournir un tableau de trois nombres ou noms de calcul au paramètre value.
Dans cette configuration, la première valeur est traitée comme l'erreur "en dessous" de la ligne de référence, la valeur du milieu est considérée comme la valeur de la ligne elle-même et la troisième valeur est traitée comme l'erreur "au-dessus" de la ligne de référence.
error below, reference line value, error above
Imaginons que votre objectif de vente soit de 60 unités, mais que +/- 5 unités se situe dans la plage acceptable. Vous pouvez l'illustrer sur un graphique comme celui-ci :
reference_lines:
- value: [5, 60, 5]
label: Target Sales
Voici comment spécifier la moyenne en indiquant l'écart-type :
reference_lines:
- value: [deviation, mean, deviation]
Étiquettes
Vous pouvez inclure un attribut label pour libeller la ligne avec le texte de votre choix.
reference_lines:
- value: 90
label: Sales Goal
Vous pouvez choisir d'inclure des valeurs calculées dans votre libellé, que vous les utilisiez ou non dans votre graphique.
Placez le nom du calcul entre doubles accolades : {{median}}. Dans ce cas, vous devez placer des guillemets autour de la chaîne de libellé.
reference_lines:
- value: 50
label: "Target (Average: {{mean}})"
Colors
Vous pouvez inclure un attribut color pour colorer la ligne et le texte.
Chaque valeur de couleur peut être une chaîne hexadécimale comme #2ca6cd ou une chaîne de couleur nommée CSS.