# Tarjeta de KPI

> Referencia del componente de panel de control Tarjeta de KPI, su minigráfica y su distribución, las estadísticas de la ventana, la retención y todas sus propiedades del editor.

La **Tarjeta de KPI** escribe grande un punto numérico, con una minigráfica opcional debajo y
estadísticas opcionales de la ventana mostrada al lado. La tarjeta recolecta sus propias muestras
por el recolector de series en vivo de la estación, así que abre sobre una ventana llena en lugar
de sobre un dibujo vacío. Cuando el punto no tiene lectura, la tarjeta muestra la marca de hueco
(`—`) y ninguna unidad; las bandas declaradas tiñen la lectura según dónde caiga, y una lectura que
ninguna banda reclama no toma color alguno. `NaN` es una lectura, no un hueco: la tarjeta escribe
esa palabra junto a su unidad y, como `NaN` no tiene lugar en una escala, ninguna banda la tiñe y
la diferencia muestra la marca de hueco.

## Datos {#data}

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Dirección | La dirección de Logic con raíz del punto numérico que se muestra. El campo sugiere desde la lista viva de puntos, filtrada a puntos numéricos, y muestra la lectura actual del punto en cuanto se nombra. | dirección | vacía |

## Formato {#format}

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Unidad | Sufijo de unidad opcional escrito junto al valor. | texto | vacía |
| Decimales | Decimales fijos para los visores (el titular, las estadísticas y la diferencia por igual). En blanco, el titular de un punto cuyo tipo es un número entero se escribe sin fracción, y cualquier otro con los decimales de la estación; el mínimo y el máximo de la ventana, lecturas de ese mismo punto, siguen al titular, mientras que el promedio toma los decimales de la estación, porque un promedio de números enteros casi nunca es entero. En blanco, la referencia y la diferencia también siguen los decimales del punto, como el titular: ninguno en un número entero, los de la estación en cualquier otro. | De 0 a 15 | en blanco usa la preferencia de la estación |
| Dígitos | Cuántas posiciones reserva el titular antes del separador decimal; una lectura que las rebasa se marca (`####`) con la lectura completa en la información emergente. Un punto que contesta con palabras (una orden, un lote, una bandera) nunca lleva esa marca: lo que el campo no puede sostener termina en puntos suspensivos (…), con la lectura completa en la información emergente. | De 1 a 20 | en blanco reserva 5 |
| Tamaño de letra | Si la celda decide el tamaño de letra o si el operador lo indica. | Tan grande como permita la celda · Un tamaño que yo indico | Tan grande como permita la celda |
| Puntos | El tamaño indicado, dibujado literalmente en cualquier celda. Sale solo en el modo indicado. | De 9 a 144 | 12 |
| Se lee como | Cómo se escriben los visores. | Número · Porcentaje · Duración | Número |
| El valor cuenta | Qué significa una unidad del valor mientras el formato es una duración. | Segundos · Milisegundos · Minutos | Segundos |
| Mostrar el mín | Escribe el mínimo de la ventana mostrada en la fila de estadísticas. | encendido / apagado | encendido |
| Mostrar el máx | Escribe el máximo de la ventana mostrada. | encendido / apagado | encendido |
| Mostrar el promedio | Escribe el promedio de la ventana mostrada. | encendido / apagado | apagado |
| Mostrar la diferencia respecto a la referencia | Escribe qué tan lejos está la lectura de la referencia declarada, como `Δ` bajo el valor, con la referencia misma en la información emergente. No dice nada mientras no hay ninguna referencia declarada: una diferencia contra nada no es una lectura. | encendido / apagado | apagado |

Las estadísticas y la diferencia son segundas lecturas de ese mismo valor, escritas con la
declaración propia de la tarjeta; se quedan en el tamaño chico de la tarjeta sea cual sea el
tamaño de letra del titular.

Las estadísticas se escriben en la letra más chica que dibuja un panel de control, así que una tarjeta
demasiado angosta para toda su línea en ese tamaño nunca corta una estadística a la mitad de su
número: la línea queda detrás de la marca `####`, con todas las estadísticas en su información
emergente. El espacio que pide la línea sale de la declaración (**Dígitos** y **Decimales**), no
de las lecturas en pantalla.

## Minigráfica {#mini-chart}

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Dibuja | Qué dibuja la tarjeta bajo la lectura. El valor, su calidad y la banda en la que cae son los mismos se dibuje lo que se dibuje. | Una línea sobre la ventana · La distribución de las muestras · Nada | Una línea sobre la ventana |
| Clases | En cuántas clases iguales corta la distribución el rango observado. Sale solo en la distribución. | De 2 a 40 | 10 |
| Sobre (muestras) | Cuántas de las muestras recolectadas más nuevas cuenta la distribución. Enmarca la distribución igual que la ventana enmarca la minigráfica; más de las que sostiene el búfer cuenta lo que hay, porque las clases son de lecturas observadas y de nada más. | De 2 a 20 000 | 120 |
| Acento | De dónde viene el color de la minigráfica. Es identidad, no significado: las bandas se quedan con la última palabra sobre las clases de una distribución. | La tinta de siempre · Un color · Un punto de color | La tinta de siempre |
| Claro / Oscuro | El acento como un par claro y oscuro, los dos indicados porque el tema en marcha decide cuál mitad está en pantalla. Sale solo mientras el acento es un color. | `#RRGGBB` cada uno | `#5470C6` los dos |
| Punto de color | La dirección de Logic con raíz de un punto de Color al que sigue el acento. Sale solo mientras el acento es un punto de color. | dirección | vacía |

Una distribución cuenta solo las muestras buenas y finitas, así que la mala calidad se lee como
menos muestras contadas, exactamente igual que se lee como un hueco en una línea. Cuando todas
las muestras contadas leyeron ese mismo valor, hay una sola clase que las contiene a todas. La
tarjeta rotula la distribución con lo que contó.

## Histórico {#history}

Dos perillas distintas, iguales a las del [Gráfico de líneas](component-line-chart): la ventana es
lo que enmarca la tarjeta, y la retención es lo que guarda la estación detrás. Las muestras viven
en memoria; reiniciar la aplicación empieza la recolección de nuevo.

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Conservar | Qué significan los números de retención. | solo la ventana · un tramo de tiempo · un número de muestras | solo la ventana |
| Conservar durante (s) | El tramo que se guarda mientras la retención es un tramo de tiempo. | De 5 a 604 800 (7 días) | 600 |
| Conservar (muestras) | El conteo que se guarda mientras la retención es un número de muestras. | De 2 a 20 000 | 2000 |

La estación concede la retención dentro de tres topes: 20 000 muestras por punto, 60 000 por
componente y 200 000 para la estación entera. Una retención que un tope no pudo conceder entera se
dice en la propia tarjeta, no solo en el editor, para que un operador en un cliente de solo
lectura nunca lea un historial más corto sin nada que lo explique. Cuando el tope de la propia
estación ya está gastado, la tarjeta no recolecta nada y lo dice: "La estación ya guarda todo el
historial que permite, así que esta serie no recolecta nada. Acorte la retención de otro gráfico
para hacer espacio.".

## Avanzado {#advanced}

Una sección plegada para los dos campos que casi ninguna tarjeta toca.

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Ventana (s) | La ventana deslizante que cubren la minigráfica y las estadísticas. | De 5 a 86 400 (1 día) | 60 |
| Muestrear cada (ms) | La cadencia de muestreo propia de la tarjeta. | De 100 (el ciclo) a 3 600 000 (1 h) | 500 |

## Escala {#scale}

La sección **Escala** compartida declara las bandas y la referencia.

- Cada **banda** cubre todo hasta su límite, desde donde terminó la banda que está encima de
  ella; el tono (Neutro, Información, Correcto, Precaución, Crítico) tiñe el titular, y una banda
  redactada escribe su nombre en la fila de estadísticas, lo único que el color no puede decir.
- La **referencia** es contra lo que se mide la diferencia: nada, un valor fijo, o un punto que
  se mueve con la receta.