Saltar al contenido principal

Cálculos y fórmulas

Detrás de cada número del tablero hay un cálculo: un conteo, una suma, un promedio, un porcentaje. La elección del cálculo cambia el resultado y, a veces, la decisión. El promedio de conformidad de una unidad no es lo mismo que la mediana; la cantidad de recolecciones no es lo mismo que la cantidad de no conformidades; y una tasa de aprobación debe dividir las aprobadas por el total correcto.

Las funciones cubren los cálculos más comunes con un clic. Las fórmulas combinan funciones para crear indicadores propios: tasas, porcentajes del total, variación respecto del mes anterior, saldo de stock, puntaje ponderado.


Funciones de cálculo​

Al abrir una métrica en el editor de gráficos, la pestaña Quick function lista las funciones disponibles:

FunciónEn pantallaCalculaCuándo usar
ConteoCount (Count of records)Cantidad de registrosCuántas recolecciones, auditorías, entrevistas.
Conteo de valores únicosUnique countCuántos valores distintos tiene un campoCuántas unidades auditadas, cuántos auditores activos.
SumaSumSuma de los valoresTotal de ocurrencias, de ítems, de horas, de cantidades.
PromedioAverageSuma dividida por la cantidadResultado promedio de auditorías, temperatura promedio, nota promedio.
MedianaMedianEl valor del medio, con la mitad de los valores por encima y la mitad por debajoTiempos y valores con extremos que distorsionan el promedio.
Mínimo y máximoMinimum / MaximumEl menor y el mayor valorPeor y mejor resultado, menor y mayor temperatura.
PercentilPercentileEl valor por debajo del cual está un porcentaje de los registros"El 90% de las atenciones tarda hasta X minutos."
Posición percentilPercentile rankEl porcentaje de registros por debajo de un valor"¿Qué parte de las cámaras quedó por debajo de 4 °C?"
Último valorLast valueEl valor de la recolección más recienteLecturas actuales: nivel de tanque, horómetro, stock.
Desviación estándarStandard deviationCuánto varían los valores alrededor del promedioEstabilidad de un proceso (pesos, temperaturas).
Suma acumuladaCumulative sumLa suma de los períodos anteriores más el actualTotal acumulado de recolecciones a lo largo del año.
DiferenciaDifferencesLa diferencia respecto del período anteriorCuánto subió o bajó el indicador de un mes a otro.
Media móvilMoving averageEl promedio de los últimos N períodosSuavizar oscilaciones diarias para ver la tendencia.

La suma acumulada, la diferencia y la media móvil se calculan sobre la agrupación por fecha del eje horizontal. Úselas en gráficos con Date histogram.

Promedio o mediana​

El editor suele elegir Median al colocar un campo numérico en el gráfico. Para indicadores de resultado (notas, porcentajes de conformidad), lo habitual es el promedio. Vea la diferencia con cinco auditorías de una unidad:

ResultadosPromedioMediana
90, 88, 85, 84, 3075,485

El promedio baja por la auditoría de 30; la mediana la ignora. Si el indicador oficial es el promedio, use Average en todos los gráficos, para que los números del tablero coincidan con los informes.

Conteo de registros y conteo de ocurrencias​

Count of records cuenta recolecciones (registros), no respuestas "Sí" ni ocurrencias.

  • Para contar las recolecciones con una respuesta específica, use Count of records con un filtro (por ejemplo, estado : "Rechazado").
  • Para contar ocurrencias registradas como número (por ejemplo, opciones con valor 1 para "Sí"), use Sum del campo.
  • En un índice transpuesto, cada recolección se convierte en varios registros: use Sum del campo de valor.
  • En una pregunta de selección múltiple, una recolección se cuenta en cada opción marcada.

Fórmulas​

Una fórmula combina funciones, números y operaciones. Para usarla:

  1. Abra la métrica en el editor de gráficos.
  2. Haga clic en la pestaña Formula.
  3. Escriba la fórmula. El editor sugiere funciones y campos mientras escribe, y muestra la documentación de cada función en el botón de ayuda.
  4. En Value format, elija el formato del resultado (por ejemplo, Percent para una tasa).

Elementos de una fórmula​

ElementoEjemploObservación
Función sobre un campoaverage(temperatura)Las mismas funciones de la tabla de arriba, con los nombres en inglés: count, unique_count, sum, average, median, min, max, percentile, last_value, standard_deviation.
Campo con guionaverage('perc-total')Los nombres con guion o caracteres especiales van entre comillas simples.
Conteo de registroscount()Sin campo.
Filtro en una funcióncount(kql='estado : "Rechazado"')El parámetro kql recibe una expresión de la barra de búsqueda, entre comillas simples.
Desplazamiento en el tiempoaverage('perc-total', shift='1M')El mismo cálculo en el mes anterior. Otros valores: 1d, 1w, 3M, 1y.
Operaciones+ - * / y paréntesisSiguen el orden habitual de la matemática.
Funciones matemáticasround(x, 1), abs(x), clamp(x, 0, 100), pow(x, 2), sqrt(x)Redondear, valor absoluto, limitar a un rango, potencia, raíz.
Totales del conjuntooverall_sum(count()), overall_average(...)El total o el promedio de todos los grupos del gráfico, para calcular participaciones.
Comillas dentro del filtro

El filtro kql='...' va entre comillas simples, y los valores dentro de él, entre comillas dobles: count(kql='aprobacion : "Necesita ajustes"'). Si el valor tiene un apóstrofo, escriba \' en su lugar.

Fórmulas listas​

IndicadorFórmulaFormato
Tasa de rechazocount(kql='estado : "Rechazado"') / count()Percent
Tasa de aprobación entre las evaluadas (ignora las no evaluadas)count(kql='estado : "Aprobado"') / count(kql='estado : *')Percent
Positividad (positivos entre los testeados)count(kql='resultado : "Positivo"') / count(kql='testeado : "Sí"')Percent
Derivación de los positivoscount(kql='derivado : "Sí" and resultado : "Positivo"') / count(kql='resultado : "Positivo"')Percent
Participación de cada grupo en el totalcount() / overall_sum(count())Percent
Fuera del rango de temperaturacount(kql='temperatura > 4 or temperatura < 0') / count()Percent
Primera vez (por ejemplo, entrevistados que nunca participaron)count(kql='ya-participo : "No"') / count()Percent
Saldo a partir de una lectura de espacio vacío (capacidad menos el vacío medido)500 - last_value('espacio-vacio', kql='espacio-vacio : *')Number
Ocupación porcentual de un tanque(500 - last_value('espacio-vacio', kql='espacio-vacio : *')) / 500Percent
Porcentaje sobre el máximo de puntossum(puntos) / sum('puntos-posibles')Percent
Promedio ponderado de dos notas (peso 2 y peso 1)(average('nota-practica') * 2 + average('nota-teorica')) / 3Number
No conformidades por auditoríasum('cant-nc') / count()Number
Último valor ignorando recolecciones sin la lectura

last_value trae el valor de la recolección más reciente. Si esa recolección no tiene el campo completo, el resultado queda vacío. El filtro kql='campo : *' hace que la función considere solo las recolecciones con el campo completo.

Porcentajes: formato Percent o sufijo %

Una tasa calculada por división (por ejemplo, 0.25) debe usar el formato Percent, que muestra 25%. Un campo que ya viene multiplicado por 100 desde el formulario (por ejemplo, 85) debe usar el formato Number con sufijo %. Mezclar los dos genera valores como 0,85% o 8.500%.

Variación respecto del período anterior​

IndicadorFórmulaFormato
Variación porcentual respecto del mes anterioraverage('perc-total') / average('perc-total', shift='1M') - 1Percent
Diferencia en puntos respecto del mes anterioraverage('perc-total') - average('perc-total', shift='1M')Number
Recolecciones respecto del mismo período del año anteriorcount() / count(shift='1y') - 1Percent

En una tarjeta, coloque el valor actual como métrica principal y la variación como métrica secundaria, con color por valor (verde para positivo, rojo para negativo).

División por cero

Si el período anterior no tiene recolecciones, la división no tiene resultado y el gráfico muestra un valor vacío. Es lo esperado. Para evitar el vacío, elija un período en que los dos intervalos tengan recolecciones.


Valor fijo​

La pestaña Static value define un número fijo en una dimensión. Se usa principalmente para:


Opciones avanzadas de una métrica​

En Advanced, dentro de cada métrica:

OpciónQué hace
Filter byAplica un filtro solo a esa métrica. Vea Filtro en una métrica.
Time shiftCalcula la métrica desplazada en el tiempo. Vea Comparar con el período anterior.
Reduced time rangeUsa solo el tramo final del período (por ejemplo, la última hora), útil para lecturas "actuales" en tableros de seguimiento.

Cuándo calcular en el formulario​

Algunas reglas funcionan mejor en el propio formulario, como campo calculado, que en una fórmula del tablero:

  • Reglas con varias condiciones sobre la misma recolección ("positivo si A o al menos dos entre B, C y D").
  • Clasificaciones que deben aparecer en la respuesta y en los informes del formulario (por ejemplo, "Aprobado" o "Rechazado").
  • Puntajes por etiqueta, como sumByTag y avgByTag.

El resultado llega listo al índice, y el tablero solo tiene que contar, sumar o promediar. Vea Campos calculados y etiquetas.