En esta página, se documentan los parámetros de LookML para aplicar una línea de referencia a una tarjeta del panel de LookML. Funcionan para todos los gráficos, excepto los de barras y aquellos en los que swap_axes se estableció como verdadero.
Las líneas de referencia te permiten colocar líneas y regiones en cualquiera de los gráficos cartesianos de Looker. Puedes usar valores estáticos o ciertas funciones estadísticas calculadas a partir de los datos del gráfico.
Configuración
Las líneas de referencia se especifican como una opción en la configuración del panel para los gráficos de dispersión, de área, de líneas, de columnas y de barras de Looker.
Actualmente, las líneas de referencia solo se admiten en la primera serie de estos gráficos.
Puedes tener una cantidad ilimitada de líneas de referencia en cualquier gráfico.
La opción de configuración reference_lines toma un array de líneas de referencia, cada elemento del cual es un hash de opciones.
Por ejemplo, la siguiente configuración crea una línea de referencia carmesí etiquetada como "Objetivo de ventas" en el valor 90 del eje Y:
reference_lines:
- value: 90
label: Sales Goal
color: crimson
Cómo dibujar una línea constante
value es el único campo obligatorio para una línea de referencia. Especifica dónde dibujar la referencia.
Para dibujar una sola línea en la marca "50" del gráfico, especifica tu configuración de la siguiente manera:
reference_lines:
- value: 50
Cálculos de valor
En lugar de especificar un número para el valor de la línea de referencia, puedes especificar un nombre de cálculo.
Todos los cálculos de valores se basan en el conjunto de datos que se devuelve de la consulta, no en todo tu conjunto de datos.
median: Es el valor de la mediana del conjunto de datos.mean: Es el valor promedio del conjunto de datos.max: Es el valor máximo del conjunto de datos.min: Es el valor mínimo del conjunto de datos.deviation: Es la desviación estándar del conjunto de datos.variance: Es la varianza estadística del conjunto de datos.
Para dibujar una línea en el valor medio de tu conjunto de datos, debes especificarlo.
reference_lines:
- value: median
Para dibujar tres líneas, una en la mediana, una en un valor constante y otra en el máximo, especifica tu configuración de la siguiente manera:
reference_lines:
- value: median
- value: 25
- value: max
Cómo dibujar un área
En lugar de especificar un solo número o nombre de cálculo para tu línea de referencia, puedes proporcionar un array.
Si el array proporcionado tiene exactamente dos valores, se trata como los límites de un rango.
reference_lines:
- value: [60, 90]
label: Butter Zone
color: orange
La siguiente configuración sombrea un área que representa un área en la que los puntos de datos están por encima del promedio.
reference_lines:
- value: [max, mean]
label: Above Average
Líneas y errores
Puedes proporcionar un array de tres números o nombres de cálculo al parámetro value.
En esta configuración, el primer valor se considera el error "por debajo" de la línea de referencia, el valor medio se considera el valor de la línea en sí y el tercer valor se considera el error "por encima" de la línea de referencia.
error below, reference line value, error above
Supongamos que tu objetivo de ventas es de 60 unidades, pero un rango de +/- 5 unidades es aceptable. Podrías ilustrar esto en un gráfico como el siguiente:
reference_lines:
- value: [5, 60, 5]
label: Target Sales
A continuación, se muestra cómo podrías especificar el promedio que muestra la desviación estándar:
reference_lines:
- value: [deviation, mean, deviation]
Etiquetas
Puedes incluir un atributo label para etiquetar la línea con el texto que elijas.
reference_lines:
- value: 90
label: Sales Goal
Puedes optar por incluir valores calculados en tu etiqueta, ya sea que los uses o no en tu gráfico.
Coloca el nombre del cálculo entre llaves dobles: {{median}}. Si lo haces, deberás colocar comillas alrededor de la cadena de la etiqueta.
reference_lines:
- value: 50
label: "Target (Average: {{mean}})"
Colores
Puedes incluir un atributo color para colorear la línea y el texto.
Cada valor de color puede ser una cadena hexadecimal, como #2ca6cd, o una cadena de color con nombre de CSS.