Esta página documenta os parâmetros LookML para aplicar uma linha de referência a um bloco de painel LookML. Elas funcionam para todos os gráficos, exceto os de barras e aqueles em que swap_axes
foi definido como verdadeiro.
Com as linhas de referência, é possível inserir 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 a partir dos dados do gráfico.
Configuração
As linhas de referência são especificadas como uma opção na configuração do painel para os gráficos de dispersão, área, linha, coluna e barra do Looker.
No momento, as linhas de referência são compatíveis apenas com a primeira série desses gráficos.
Você pode 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, sendo que cada item é um hash de opções.
A opção de configuração do gráfico abaixo é implementada da seguinte forma:
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. Ela especifica onde desenhar a referência.
Para desenhar uma única linha na marca "50" do gráfico, especifique sua configuração da seguinte forma:
reference_lines:
- value: 50
Cálculos de valor
Em vez de especificar um número para a linha de referência, defina um nome de cálculo.
Todos os cálculos de valor são baseados no conjunto de dados retornado da consulta, não no seu conjunto inteiro.
median
: o valor médio 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 variação estatística do conjunto de dados.
Para desenhar uma linha com o valor médio do seu conjunto de dados, especifique isso.
reference_lines:
- value: median
Para desenhar três linhas, uma na média, uma em um valor constante e outra no máximo, você especifica a configuração da seguinte forma:
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, é possível 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 área em que os pontos de dados estão acima da média.
reference_lines:
- value: [max, mean]
label: Above Average
Linhas e erros
É possível fornecer uma matriz de três números ou nomes de cálculo para o 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 +/- cinco unidades estão 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 que mostra 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 preferir.
reference_lines:
- value: 90
label: Sales Goal
Você pode incluir valores calculados no marcador, independentemente de usá-los ou não no gráfico.
Coloque o nome do cálculo dentro de chaves duplas: {{median}}
. Para isso, coloque a string entre aspas.
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 chamada CSS.