Esta página documenta os parâmetros do LookML para aplicar uma linha de referência a um bloco de dashboard do LookML. Eles funcionam para todos os gráficos, exceto os de barras e aqueles em que swap_axes foi definido como "true".
Com as linhas de referência, é possível colocar linhas e regiões em qualquer um dos gráficos cartesianos do Looker. É possível usar valores estáticos ou determinadas funções estatísticas calculadas com base nos dados do gráfico.
Configuração
As linhas de referência são especificadas como uma opção na configuração do painel para gráficos de dispersão, área, linhas, colunas e barras do Looker.
No momento, as linhas de referência são compatíveis apenas com a primeira série desses gráficos.
É possível ter um número ilimitado de linhas de referência em qualquer gráfico.
A opção de configuração reference_lines usa uma matriz de linhas de referência, em que cada item é um hash de opções.
Por exemplo, a configuração a seguir cria uma linha de referência carmesim chamada "Meta de vendas" no valor 90 do eixo y:
reference_lines:
- value: 90
label: Sales Goal
color: crimson
Como desenhar uma linha constante
value é o único campo obrigatório para uma linha de referência. Ele especifica onde desenhar a referência.
Para desenhar uma única linha na marca "50" do gráfico, especifique sua configuração assim:
reference_lines:
- value: 50
Cálculos de valor
Em vez de especificar um número para o valor da linha de referência, é possível especificar um nome de cálculo.
Todos os cálculos de valor são baseados no conjunto de dados retornado da consulta, e não no conjunto de dados inteiro.
median: o valor da mediana do conjunto de dados.mean: o valor médio do conjunto de dados.max: o valor máximo do conjunto de dados.min: o valor mínimo do conjunto de dados.deviation: o desvio padrão do conjunto de dados.variance: a variância estatística do conjunto de dados.
Para desenhar uma linha no valor da mediana do conjunto de dados, especifique isso.
reference_lines:
- value: median
Para desenhar três linhas, uma na mediana, uma em um valor constante e outra no máximo, especifique sua configuração assim:
reference_lines:
- value: median
- value: 25
- value: max
Desenhar uma área
Em vez de especificar um único número ou nome de cálculo para a linha de referência, você pode fornecer uma matriz.
Se a matriz fornecida tiver exatamente dois valores, ela será tratada como os limites de um intervalo.
reference_lines:
- value: [60, 90]
label: Butter Zone
color: orange
A configuração a seguir sombreia uma área que representa uma região em que os pontos de dados estão acima da média.
reference_lines:
- value: [max, mean]
label: Above Average
Linhas e erros
Você pode fornecer uma matriz de três números ou nomes de cálculo ao parâmetro value.
Nessa configuração, o primeiro valor é tratado como o erro "abaixo" da linha de referência, o valor do meio é considerado o valor da própria linha, e o terceiro valor é tratado como o erro "acima" da linha de referência.
error below, reference line value, error above
Digamos que sua meta de vendas seja de 60 unidades, mas +/- 5 unidades esteja no intervalo aceitável. Você pode ilustrar isso em um gráfico como este:
reference_lines:
- value: [5, 60, 5]
label: Target Sales
Veja como especificar a média mostrando o desvio padrão:
reference_lines:
- value: [deviation, mean, deviation]
Rótulos
Você pode incluir um atributo label para rotular a linha com o texto que quiser.
reference_lines:
- value: 90
label: Sales Goal
Você pode incluir valores calculados no rótulo, mesmo que não os use no gráfico.
Coloque o nome do cálculo entre chaves duplas: {{median}}. Se você fizer isso, coloque aspas ao redor da string de rótulo.
reference_lines:
- value: 50
label: "Target (Average: {{mean}})"
Cores
Você pode incluir um atributo color para colorir a linha e o texto.
Cada valor de cor pode ser uma string hexadecimal, como #2ca6cd, ou uma string de cor nomeada CSS.