# Gráfico de líneas

> Referencia del componente Gráfico de líneas, sus series, ejes y trazados apilados, la ventana y la retención, la fidelidad del dibujo y la caja de herramientas.

El **Gráfico de líneas** sigue puntos a lo largo del tiempo: cada serie lee una dirección de Logic,
muestreada a la cadencia propia del gráfico hacia el recolector de series en vivo de la estación,
así que el gráfico abre sobre una ventana llena en lugar de sobre un eje vacío. El mismo dibujo
sirve al gráfico grabado de un ensayo en [Process](process) y en [Históricos](histories); lo que
añade un panel de control es de dónde viene la configuración: las propiedades propias de este
componente.

## Contenido {#content}

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Título del gráfico | Encabezado opcional dibujado dentro del trazado. Es el encabezado propio del gráfico, no el título de esquina del componente (ese vive en la sección Apariencia compartida). | texto | vacío |

## Serie {#series}

Una tarjeta por serie, en el orden declarado. **Añadir serie** añade una; cada tarjeta lleva:

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Dirección | La dirección de Logic con raíz que lee la serie. El campo sugiere de la lista de puntos en vivo, filtrada a puntos numéricos, y muestra la lectura actual del punto una vez nombrado. | dirección | vacío |
| Nombre | Cómo llaman a la serie la leyenda y la información emergente. | texto | en blanco recae en la dirección |
| Color de la serie | La tinta de la línea como `#RRGGBB`. | color hexadecimal | en blanco toma el turno de la paleta |
| Decimales | Con cuántas cifras se escriben las lecturas de esta serie bajo el cursor. Por serie, porque los canales de un gráfico no se leen con la misma precisión: una presión con dos cifras junto a un recuento que no tiene ninguna. | de 0 a 15 | en blanco usa la preferencia de la estación |
| Unir la línea a través de los huecos | Lo que hace la línea donde esta serie no se leyó. Desactivado, la línea se corta en el agujero: la imagen honesta, porque la estación no tiene nada para ese tramo. Activado, se lleva recta a través, que es como se lee una consigna que simplemente se mantuvo entre escrituras. | activado / desactivado | desactivado |
| Trazado | En cuál de los trazados apilados del gráfico se dibuja la serie. Se pide solo mientras el gráfico tiene trazados bajo el suyo. | Trazado 1 (el propio del gráfico) · de Trazado 2 a Trazado 4 (los apilados) | Trazado 1 |
| Eje | Contra qué eje de valores se escala la serie: el primero o el segundo. Se pide solo dentro del trazado propio del gráfico y mientras existe un segundo eje; una serie de un trazado apilado tiene el eje único de ese trazado. | primero · segundo | primero |
| Dibujar esta serie | Si la serie llega siquiera al lienzo. Se guarda, así que un canal dejado fuera de la imagen sigue fuera la próxima vez que se abra el sinóptico: el gesto de mostrar y ocultar de la caja de herramientas es para mirar, y esto es para escribir el sinóptico. | activado / desactivado | activado |

## Gráfico {#chart}

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Forma | La forma que toma cada serie sobre el eje: una medición continua es una línea, un total bajo ella es un área, un valor que se mantiene hasta que se vuelve a escribir es un escalón, y una cantidad por intervalo son barras en el tiempo. | Línea · Área · Escalón · Barras en el tiempo | Línea |
| Leyenda | Dónde se sitúa la leyenda. | encima del trazado · debajo del trazado · ninguna | encima del trazado |
| Navegación | Hasta dónde puede recorrer el operador el eje de tiempo: una ventana fija que no mueve nada, la rueda y el arrastre sobre el trazado, o la rueda y el arrastre más una barra de navegación bajo el trazado que muestra dónde cae la ventana. | ventana fija · rueda y arrastre · rueda y barra de navegación | rueda y arrastre |

## Ejes {#axes}

Todos los ejes son una tarjeta: un nombre, una unidad (añadida al nombre entre corchetes), un
recuento de divisiones y, en los ejes de valores, unos extremos retenidos y un borde.

**Eje de tiempo**

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Cuenta en | Cómo presenta el eje las posiciones de las muestras: el tiempo transcurrido respecto al borde de la ventana, las marcas de tiempo del reloj de pared (con el formato del idioma y formatos de la estación), o el número de muestra a secas. | el tiempo desde que se abrió la ventana · el reloj · el número de muestra | el tiempo desde que se abrió la ventana |
| Nombre / Unidad | El nombre y la unidad del eje. | texto | vacío |
| Marcas | Cuántas divisiones se le piden al eje. Un recuento indicado es una indicación que el motor honra tan de cerca como permiten los valores redondos, no una promesa de tantas marcas. | de 2 a 20 | en blanco (automático) |

**Eje de valores** (y el **Segundo eje de valores** opcional, para las series cuya escala no tiene
nada que ver con la primera; sin él, todas las series comparten la única escala que hay)

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Nombre / Unidad / Marcas | Como en el eje de tiempo. | | |
| Mín / Máx | Los extremos en los que se retiene la escala. Dejado a su aire, un eje de valores se reajusta en cada muestra, así que la línea más alta está siempre en lo alto de la ventana y nada se puede comparar con lo de hace un minuto; retener un extremo lo detiene. Cada extremo se retiene por su cuenta: un suelo a solas conserva la línea del cero mientras el techo respira. | números | en blanco (automático) |
| Dibujado sobre | En qué borde del trazado se pone la regla. | izquierda · derecha | izquierda |

**Espacio junto al trazado.** Un eje de valores sin nombre ni unidad se queda solo con un margen
fino junto a sus números, sea cual sea el ancho del gráfico; con nombre o unidad, se queda con el
espacio que necesita su nombre girado. Un segundo eje de valores dibujado en el mismo borde se
pone más allá de los números y el nombre del primero. Cuando el gráfico se dibuja más estrecho de
lo que necesitan juntos sus ejes de valores y un trazado legible, el segundo eje de valores deja
de escribir sus números: sus series conservan su propia escala y sus lecturas siguen en la
información emergente. Ensanchar el gráfico devuelve los números.

## Trazados apilados {#stacked-plots}

Dos cantidades leídas en el mismo instante no tienen por qué compartir una regla: un trazado
apilado bajo el propio del gráfico recibe una escala propia y el mismo eje de tiempo, así que la
temperatura y el caudal se leen uno bajo el otro en lugar de apretados sobre la regla del otro. Un
gráfico tiene como mucho **cuatro trazados de alto**: el suyo más hasta tres apilados bajo él; la
tarjeta de cada trazado apilado lleva su eje (nombre, unidad, marcas, extremos retenidos, borde) y:

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Altura | Lo alto que se dibuja el trazado frente al propio del gráfico, que es 1. | de 0,25 a 4 | 1 |

Una serie declara en su propia tarjeta en qué trazado aterriza.

## Evaluación {#evaluation}

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Dibujar el rango aprobado del ensayo en curso | Dibuja, por detrás de las series, la banda aprobada del ensayo que la unidad está ejecutando ahora mismo. Los límites vienen de la evaluación del procedimiento que esté ejecutando la unidad, y un límite que sigue a un canal de referencia se mueve con él. No nombra ninguna unidad propia: la unidad es la que ya leyó la serie, en el sinóptico de un modelo llega cuando una unidad abre el sinóptico, y un sinóptico que no lee ninguna unidad no tiene ningún ensayo al que seguir. | activado / desactivado | desactivado |

Así es como un gráfico de un sinóptico sigue a un procedimiento en marcha; el gráfico de un ensayo
grabado en Históricos ya lleva las bandas de su propio ensayo.

Una banda lleva el nombre de su criterio, escrito en la primera de sus esquinas que ninguna línea
del gráfico cruza, empezando por la esquina superior derecha. Donde las líneas la cruzan en todas
las esquinas y en el centro de ambos extremos, la banda se dibuja sin su nombre.

## Histórico {#history}

Dos perillas distintas: la ventana es lo que encuadra el gráfico, y la retención es lo que la
estación guarda por detrás. Un gráfico puede guardar diez minutos y encuadrar el último, así que
navegar hacia atrás recorre lo que se guardó en lugar de encontrar un eje vacío. Las muestras viven
en memoria; reiniciar la aplicación empieza la recogida de nuevo.

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Mostrar | Lo que muestra la ventana al abrirse: una ventana deslizante que sigue a la muestra más nueva, o todo lo que la estación guardó para el gráfico, por lejos que llegue. | una ventana deslizante · todo lo guardado | una ventana deslizante |
| Ventana (s) | El tramo que muestra una ventana deslizante. Se pide solo mientras la ventana se desliza. | de 5 a 86.400 (1 día) | 60 |
| Muestrear cada (ms) | La cadencia de muestreo propia del gráfico. Cambiarla empieza un búfer nuevo desde ahora, porque una cadencia es parte de la identidad de una serie recogida. | de 100 (el ciclo) a 3.600.000 (1 h) | 500 |
| 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 por serie mientras la retención es un tramo de tiempo. | de 5 a 604.800 (7 días) | 600 |
| Conservar (muestras) | El recuento que se guarda por serie mientras la retención es un número de muestras. | de 2 a 20.000 | 2.000 |

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 en conjunto. Una retención que un tope no pudo conceder
entera se dice bajo el propio gráfico, no solo en el editor. Cuando el tope propio de la estación
ya está gastado, una serie nueva no recoge nada en absoluto y lo dice: "La estación ya guarda todo
el histórico que permite, así que esta serie no recoge nada. Acorte la retención de otro gráfico
para hacer sitio.".

## Fidelidad y rendimiento {#fidelity-and-performance}

Cuántos datos llegan al lienzo: el ajuste más consecuente del gráfico. Dibujar todas las muestras
se atasca a medida que crecen los canales y la ventana; reducir sin decirlo es peor. La reducción
ocurre **en el momento de dibujar y nunca en lo que se guarda**, y es **adaptativa**: el gráfico
cuenta los puntos de dentro del intervalo visible, y por debajo del umbral la reducción desaparece;
ampliar descubre siempre los datos de verdad.

Un **preajuste** rellena todos los campos de una vez; tocar un solo campo convierte el conjunto en
Personalizado por sí solo, porque no se guarda nada junto a los valores.

| Preajuste | Qué escribe |
|---|---|
| Fidelidad máxima | Umbral 100.000 (más allá de lo que resuelve cualquier lienzo: no reducir nunca), conservar los picos, símbolos hasta 1.000 puntos, dibujar fuera de la ventana, sin animación, modo mostrado en la esquina. |
| Equilibrado | Los valores con los que nace un gráfico (los de abajo). |
| Rendimiento máximo | Umbral 400, promediar cada intervalo, sin símbolos, nada dibujado fuera de la ventana, sin animación, sin marca de modo. |
| Personalizado | No es una elección: la lectura que se muestra cuando los campos no coinciden con ninguno de los conjuntos con nombre. |

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Dibujar todas las muestras hasta | Cuántos puntos de dentro del intervalo visible hacen que la reducción se apague por debajo. Cuenta la imagen entera: todas las series dibujadas juntas. | de 100 a 100.000 | 2.000 |
| Por encima, conservar | Qué reducción se ejecuta por encima del umbral, nombrada por lo que conserva: el mínimo *y* el máximo de cada intervalo (un pico que duró una muestra no se puede descartar), el punto que conserva la silueta de la curva, o la media de cada intervalo, la más barata y la que aplana un pico. | Conservar los picos · Conservar la forma · Media | Conservar los picos |
| Un símbolo por muestra hasta | Cuántos puntos visibles pueden llevar todavía un símbolo cada uno; cero no los dibuja nunca. Un símbolo solo significa algo mientras la reducción está apagada. | de 0 a 5.000 | 200 |
| Dibujar lo que queda fuera de la ventana | Si lo que está fuera del intervalo visible se dibuja siquiera (a grandes rasgos: vuelve a ser el dato de verdad en cuanto se encuadra). | activado / desactivado | activado |
| Animar el dibujo | Si el dibujo se anima. Desactivado, porque unos datos en tiempo real que se deslizan cuestan más de leer. | activado / desactivado | desactivado |
| Decir en la esquina en qué modo está el gráfico | Una marca discreta en la esquina que dice si el sinóptico muestra la medición o una reducción de ella. Ruido en un sinóptico de operación, imprescindible en uno de análisis. | activado / desactivado | desactivado |

Una estimación bajo los campos dice lo que cuesta la configuración, en vivo a medida que se
escribe.

## Caja de herramientas {#toolbox}

La sección **Caja de herramientas** elige qué botones recibe el operador en este gráfico, así que
un sinóptico de operación en el que el operador no debe mover la escala deja de llevar la barra de
herramientas de un sinóptico de análisis. Sin ninguna marcada, no se dibuja ninguna barra de
herramientas.

| Herramienta | Qué hace | En el conjunto por defecto |
|---|---|---|
| Seleccionar un área para ampliar | Arma el zoom de selección por caja sobre el trazado. | sí |
| Restablecer la ampliación | Devuelve la ventana a todo lo trazado. | sí |
| Fijar la escala a mano | Fija a mano el periodo de tiempo y el intervalo de valores, o devuelve cualquiera de los dos al ajuste. El botón se queda encendido mientras hay algo fijado. Una ventana fijada que no contiene ninguna muestra lo dice bajo el dibujo en lugar de leerse como un gráfico que se paró. | no |
| Mínimo, media y máximo de la ventana mostrada | Abre un panel con el valor más bajo, el medio y el más alto de cada serie dentro de la ventana mostrada. Se mide solo mientras el panel está abierto. | no |
| Dibujar una línea de referencia | Dibuja una línea a un valor o a un instante. Las líneas viven solo mientras el sinóptico siga abierto (no se guarda nada) y el botón se queda encendido mientras hay alguna línea dibujada. | no |
| Guardar PNG | Descarga el dibujo como un PNG. | sí |
| Copiar PNG | Pone el dibujo en el portapapeles como un PNG. | sí |
| Mostrar u ocultar series | Muestra u oculta una serie sin editar el sinóptico. | sí |
| Activar y desactivar la información emergente | Activa y desactiva la información emergente del puntero. | sí |
| Pantalla completa | Llena la ventana con este gráfico. | sí |

Mientras la Navegación está en ventana fija, la lista deja fuera Seleccionar un área para ampliar y
Restablecer la ampliación, y la barra de herramientas no los dibuja: una ventana que nada mueve no tiene ampliación
a la que respondan. Sus marcas se conservan, así que dejar que la ventana vuelva a moverse devuelve
los dos botones.

## En el sinóptico de un modelo {#on-a-models-screen}

En un sinóptico definido sobre un modelo de Process, los campos de dirección de las series
encabezan con los canales abstractos del modelo: elegir uno vincula el canal y deja la unidad para
cuando una unidad abra el sinóptico. Los puntos propios de la estación conservan su sitio por
detrás de ellos: el sinóptico de un modelo puede leer uno legítimamente.