Pular para o conteúdo principal

Cálculos e fórmulas

Por trás de cada número do painel há um cálculo: uma contagem, uma soma, uma média, um percentual. A escolha do cálculo muda o resultado e, às vezes, a decisão. A média de conformidade de uma unidade não é o mesmo que a mediana; a quantidade de coletas não é o mesmo que a quantidade de não conformidades; e uma taxa de aprovação precisa dividir as aprovadas pelo total certo.

As funções cobrem os cálculos mais comuns com um clique. As fórmulas combinam funções para criar indicadores próprios: taxas, percentuais do total, variação em relação ao mês anterior, saldo de estoque, pontuação ponderada.


Funções de cálculo​

Ao abrir uma métrica no editor de gráficos, a aba Quick function lista as funções disponíveis:

FunçãoNa telaCalculaQuando usar
ContagemCount (Count of records)Quantidade de registrosQuantas coletas, auditorias, entrevistas.
Contagem de valores únicosUnique countQuantos valores diferentes um campo temQuantas unidades auditadas, quantos auditores ativos.
SomaSumSoma dos valoresTotal de ocorrências, de itens, de horas, de quantidades.
MédiaAverageSoma dividida pela quantidadeResultado médio de auditorias, temperatura média, nota média.
MedianaMedianO valor do meio, com metade dos valores acima e metade abaixoTempos e valores com extremos que distorcem a média.
Mínimo e máximoMinimum / MaximumO menor e o maior valorPior e melhor resultado, menor e maior temperatura.
PercentilPercentileO valor abaixo do qual está um percentual dos registros"90% dos atendimentos levam até X minutos."
Posição percentualPercentile rankO percentual de registros abaixo de um valor"Que parte das câmaras ficou abaixo de 4 °C?"
Último valorLast valueO valor da coleta mais recenteLeituras atuais: nível de tanque, horímetro, estoque.
Desvio padrãoStandard deviationO quanto os valores variam em torno da médiaEstabilidade de um processo (pesos, temperaturas).
Soma acumuladaCumulative sumA soma dos períodos anteriores mais o atualTotal acumulado de coletas ao longo do ano.
DiferençaDifferencesA diferença em relação ao período anteriorQuanto o indicador subiu ou caiu de um mês para o outro.
Média móvelMoving averageA média dos últimos N períodosSuavizar oscilações diárias para ver a tendência.

Soma acumulada, diferença e média móvel são calculadas sobre o agrupamento por data do eixo horizontal. Use-as em gráficos com Date histogram.

Média ou mediana​

O editor costuma escolher Median ao colocar um campo numérico no gráfico. Para indicadores de resultado (notas, percentuais de conformidade), o usual é a média. Veja a diferença com cinco auditorias de uma unidade:

ResultadosMédiaMediana
90, 88, 85, 84, 3075,485

A média é puxada para baixo pela auditoria de 30; a mediana a ignora. Se o indicador oficial é a média, use Average em todos os gráficos, para os números do painel baterem com os relatórios.

Contagem de registros e contagem de ocorrências​

Count of records conta coletas (registros), não respostas "Sim" nem ocorrências.

  • Para contar as coletas com uma resposta específica, use Count of records com um filtro (por exemplo, status : "Reprovado").
  • Para contar ocorrências registradas como número (por exemplo, opções com valor 1 para "Sim"), use Sum do campo.
  • Num índice transposto, cada coleta vira vários registros: use Sum do campo de valor.
  • Numa pergunta de seleção múltipla, uma coleta é contada em cada opção marcada.

Fórmulas​

Uma fórmula combina funções, números e operações. Para usar:

  1. Abra a métrica no editor de gráficos.
  2. Clique na aba Formula.
  3. Digite a fórmula. O editor sugere funções e campos enquanto você escreve, e mostra a documentação de cada função no botão de ajuda.
  4. Em Value format, escolha o formato do resultado (por exemplo, Percent para uma taxa).

Elementos de uma fórmula​

ElementoExemploObservação
Função sobre um campoaverage(temperatura)As mesmas funções da tabela acima, com os nomes em inglês: count, unique_count, sum, average, median, min, max, percentile, last_value, standard_deviation.
Campo com hífenaverage('perc-total')Nomes com hífen ou caracteres especiais vão entre aspas simples.
Contagem de registroscount()Sem campo.
Filtro numa funçãocount(kql='status : "Reprovado"')O parâmetro kql recebe uma expressão da barra de busca, entre aspas simples.
Deslocamento no tempoaverage('perc-total', shift='1M')O mesmo cálculo no mês anterior. Outros valores: 1d, 1w, 3M, 1y.
Operações+ - * / e parêntesesSeguem a ordem usual da matemática.
Funções matemáticasround(x, 1), abs(x), clamp(x, 0, 100), pow(x, 2), sqrt(x)Arredondar, valor absoluto, limitar a uma faixa, potência, raiz.
Totais do conjuntooverall_sum(count()), overall_average(...)O total ou a média de todos os grupos do gráfico, para calcular participações.
Aspas dentro do filtro

O filtro kql='...' fica entre aspas simples, e os valores dentro dele, entre aspas duplas: count(kql='aprovacao : "Necessita ajustes"'). Se o valor tiver um apóstrofo, escreva \' no lugar dele.

Fórmulas prontas​

IndicadorFórmulaFormato
Taxa de reprovaçãocount(kql='status : "Reprovado"') / count()Percent
Taxa de aprovação entre as avaliadas (ignora as não avaliadas)count(kql='status : "Aprovado"') / count(kql='status : *')Percent
Positividade (positivos entre os testados)count(kql='resultado : "Positivo"') / count(kql='testado : "Sim"')Percent
Encaminhamento dos positivoscount(kql='encaminhado : "Sim" and resultado : "Positivo"') / count(kql='resultado : "Positivo"')Percent
Participação de cada grupo no totalcount() / overall_sum(count())Percent
Fora da faixa de temperaturacount(kql='temperatura > 4 or temperatura < 0') / count()Percent
Primeira vez (por exemplo, entrevistados que nunca participaram)count(kql='ja-participou : "Não"') / count()Percent
Saldo a partir de uma leitura de espaço vazio (capacidade menos o vazio medido)500 - last_value('espaco-vazio', kql='espaco-vazio : *')Number
Ocupação percentual de um tanque(500 - last_value('espaco-vazio', kql='espaco-vazio : *')) / 500Percent
Percentual sobre o máximo de pontossum(pontos) / sum('pontos-possiveis')Percent
Média ponderada de duas notas (peso 2 e peso 1)(average('nota-pratica') * 2 + average('nota-teorica')) / 3Number
Não conformidades por auditoriasum('qtd-nc') / count()Number
Último valor ignorando coletas sem a leitura

last_value traz o valor da coleta mais recente. Se essa coleta não tiver o campo preenchido, o resultado fica vazio. O filtro kql='campo : *' faz a função considerar só as coletas com o campo preenchido.

Percentuais: formato Percent ou sufixo %

Uma taxa calculada por divisão (por exemplo, 0.25) deve usar o formato Percent, que mostra 25%. Um campo que já vem multiplicado por 100 do formulário (por exemplo, 85) deve usar o formato Number com sufixo %. Misturar os dois gera valores como 0,85% ou 8.500%.

Variação em relação ao período anterior​

IndicadorFórmulaFormato
Variação percentual em relação ao mês anterioraverage('perc-total') / average('perc-total', shift='1M') - 1Percent
Diferença em pontos em relação ao mês anterioraverage('perc-total') - average('perc-total', shift='1M')Number
Coletas em relação ao mesmo período do ano anteriorcount() / count(shift='1y') - 1Percent

Num card, coloque o valor atual como métrica principal e a variação como métrica secundária, com cor por valor (verde para positivo, vermelho para negativo).

Divisão por zero

Se o período anterior não tiver coletas, a divisão não tem resultado e o gráfico mostra um valor vazio. Isso é esperado. Para evitar o vazio, escolha um período em que os dois intervalos tenham coletas.


Valor fixo​

A aba Static value define um número fixo numa dimensão. É usada principalmente para:


Opções avançadas de uma métrica​

Em Advanced, dentro de cada métrica:

OpçãoO que faz
Filter byAplica um filtro só a essa métrica. Veja Filtro numa métrica.
Time shiftCalcula a métrica deslocada no tempo. Veja Comparar com o período anterior.
Reduced time rangeUsa só o trecho final do período (por exemplo, a última hora), útil para leituras "atuais" em painéis de acompanhamento.

Quando calcular no formulário​

Algumas regras ficam melhores no próprio formulário, como campo calculado, do que numa fórmula do painel:

  • Regras com várias condições sobre a mesma coleta ("positivo se A ou pelo menos duas entre B, C e D").
  • Classificações que precisam aparecer na resposta e nos relatórios do formulário (por exemplo, "Aprovado" ou "Reprovado").
  • Pontuações por tag, como sumByTag e avgByTag.

O resultado chega pronto ao índice, e o painel só precisa contar, somar ou tirar a média. Veja Campos calculados e tags.