Gráficos

La barra de herramientas que lleva todo gráfico y qué hace cada botón, los paneles de escala, de estadísticas y de líneas de referencia, la ventana de gráfico desprendida, dónde aparecen los gráficos en la aplicación, y el único motor que hay detrás de todos.

Ver como Markdown

Todos los gráficos de la aplicación los dibuja un solo motor (ECharts) a través de una sola vista de gráfico, sea lo que sea lo que los puso en pantalla: los componentes Gráfico de líneas, Gráfico de barras y Gráfico circular de un panel de control, la tarjeta Canales de un panel de unidad, el gráfico en vivo de una corrida en la página Process, el gráfico de datalog de una corrida grabada en Históricos, la vista previa del perfil de una receta en una receta o en un procedimiento, la vista previa de criterio de una evaluación, y las dos ventanas desprendidas de más abajo. Lo que cambia entre ellos es de dónde viene la configuración, nunca el dibujo: un hueco en los datos siempre es un hueco en la línea, nunca un puente, y cada número y cada instante que escribe el gráfico siguen el propio idioma y formatos de la estación. El reporte en PDF dibuja lo mismo sin ninguna de las herramientas de esta página.

Un gráfico lleva una fila de botones sobre su trazado: la misma barra en todas partes, a la que se le dice por gráfico qué botones dibujar. En un componente de panel de control, esa lista es la sección Herramientas de sus propiedades (El editor de paneles de control); una superficie sin nadie a quien preguntarle (una corrida grabada, la vista previa de una receta) ofrece todas las herramientas que un gráfico de tiempo puede honrar. Sin ninguna herramienta no se dibuja barra.

Botón (su información emergente)	Qué hace	Se ofrece en	Encendido de forma predeterminada en un sinóptico
Abrir en otra ventana	Abre ese mismo gráfico en una ventana propia (véase más abajo). Solo donde el gráfico tiene una dirección propia: una corrida grabada en Históricos, el perfil de una receta. Nunca en un gráfico colocado sobre un sinóptico.	Corridas grabadas, perfiles de receta	no se ofrece
Seleccionar un área para acercar	Arma el acercamiento por caja: el siguiente arrastre sobre el trazado enmarca la caja que dibuja en lugar de desplazar. El botón se queda encendido mientras está armado.	Gráficos de tiempo	sí
Restablecer el zoom	Regresa el marco a todo lo que está trazado.	Gráficos de tiempo	sí
Ajustar la escala a mano	Abre el panel de escala de más abajo. Encendido mientras hay algo fijado, así que una escala que dejó de seguir a los datos lo dice sin que haya que abrirlo.	Gráficos de tiempo	no
Mínimo, promedio y máximo de la ventana mostrada	Abre el panel de estadísticas de más abajo. Se mide solo mientras el panel está abierto.	Gráficos de tiempo	no
Dibujar una línea de referencia	Abre el panel de líneas de referencia de más abajo. Encendido mientras hay alguna línea dibujada.	Gráficos de tiempo	no
Guardar PNG	Descarga el dibujo como PNG al doble de la resolución de pantalla, sobre el fondo del tema, con el nombre del título del gráfico ("chart" cuando no tiene ninguno).	Todos los gráficos	sí
Copiar PNG	Pone ese mismo PNG en el portapapeles. Un navegador que rechaza las escrituras al portapapeles no hace nada, en silencio.	Todos los gráficos	sí
Mostrar u ocultar series	Abre una lista de las series trazadas con una casilla cada una, leída directo del gráfico; desmarcar una esconde esa serie mientras el sinóptico siga abierto. "Sin series" cuando no hay nada trazado.	Gráficos de tiempo	sí
La etiqueta emergente está apagada / La etiqueta emergente está encendida	Enciende o apaga la lectura que sale al pasar por encima. Abre apagada, para que una mano que cruza el trazado nunca lo tape con una caja que nadie pidió; la elección dura la sesión.	Gráficos de tiempo	sí
Pantalla completa	Llena la ventana con este solo gráfico, por la pantalla completa de elemento del navegador; presionarlo de nuevo, o Esc, regresa la ventana. En un panel de control que ya está a pantalla completa, amplía el gráfico, y Esc sale del gráfico antes de salir del panel de control.	Todos los gráficos	sí

Un Gráfico de barras o un Gráfico circular solo pueden honrar el par de PNG y Pantalla completa: una comparación leída en este instante no tiene eje que recorrer, ni ventana que medir, ni nada sobre lo que tender una línea. Solo hay un panel abierto a la vez, y una pulsación en cualquier otro lugar lo cierra.

Acercar y desplazar son, en sí, el ajuste Navegación del gráfico (un marco fijo, rueda y arrastre, o rueda y arrastre más una barra de navegación bajo el trazado que muestra dónde se sienta el marco dentro de toda la grabación); un gráfico con trazados apilados mueve todos los trazados juntos, porque comparten un solo eje de tiempo. Un gesto nunca toca lo que está guardado: el gráfico dibuja lo que llega al lienzo desde el rango visible, así que acercarse siempre revela los datos reales, y una marca de esquina puede decir si la imagen es la medición o una reducción de ella (Gráfico de líneas).

Ajustar la escala a mano

El panel fija un periodo del eje de tiempo y un rango del eje de valor, cada lado por su cuenta. Todos los campos confirman al salir de ellos; un campo vacío es un lado que se deja libre, que se sigue ajustando solo.

Campo	Qué admite
Periodo / Periodo (s desde ahora) / Muestras	Los dos extremos del eje de tiempo, pedidos con las palabras con las que está dibujado el eje: dos selectores de fecha y hora en un eje de reloj, dos números de segundos en un eje relativo, dos conteos de muestras en un eje de muestras.
Eje de valor, mínimo y máximo	Los extremos del propio eje de valor del gráfico. En un gráfico con trazados apilados, esta es la regla del trazado de arriba a solas; el periodo de tiempo mueve todos los trazados juntos.
Automático (uno por eje)	Le regresa ese eje al marco que construyó el gráfico: una ventana deslizante vuelve a deslizarse, un eje escrito con extremos sostenidos regresa a ellos, y uno escrito sin ninguno regresa a su ajuste libre. Atenuado mientras no hay nada fijado en ese eje.
Cargar la ventana mostrada	Llena los cuatro campos con el marco que de verdad está en pantalla, después de cada acercamiento y de cada desplazamiento que usted hizo, así que fijar lo que está mirando cuesta una pulsación.

La fijación es de este gráfico en esta conexión: nunca se guarda con el sinóptico, otro navegador que mira ese mismo gráfico tiene la suya, y cerrar el sinóptico la suelta. Un marco fijado que no contiene ninguna de las muestras igual se dibuja, y lo dice bajo el trazado: "No se midió nada dentro de la escala que usted fijó."

Mínimo, promedio y máximo

El panel es una tabla con una fila por serie trazada (una serie que el autor del sinóptico apagó no está en el sinóptico y no está en la tabla; una escondida con la leyenda sí está), coloreada con su tinta, con Mínimo, Promedio y Máximo sobre las muestras que hay dentro de la ventana mostrada, escritos como escribe números la estación. La línea que va sobre la tabla dice cuál es esa ventana: "La ventana mostrada, hasta la muestra más reciente." o "La ventana mostrada. La muestra más reciente queda más allá de su borde derecho." cuando usted caminó hacia atrás en el histórico. La información emergente de una fila dice cuántas de las muestras de la ventana fueron lecturas; un hueco cuenta como una muestra que la ventana tuvo y como nada en los tres números, así que ningún promedio se saca cruzando un hueco. Una fila que no tiene nada que leer escribe huecos y dice de qué silencio se trata: "No se muestreó nada de esta serie en la ventana mostrada." o "Todas las muestras de esta serie en la ventana mostrada son huecos." Los números siguen a los datos vivos mientras el panel está abierto y se miden sobre las muestras mismas, nunca sobre el dibujo reducido.

Líneas de referencia

Una línea de referencia es una línea puesta en un valor a lo ancho del trazado, o en un instante a lo alto, con palabras que dicen por qué está ahí y un color para distinguirla de la siguiente. El panel enumera lo que está dibujado, cada línea con su ✕, y Quitar todas; bajo la lista, un formulario pequeño dibuja la siguiente:

Campo	Qué admite
Qué eje	En un valor, o el eje de tiempo con sus propias palabras: En un instante (un selector de fecha y hora), En un segundo (desde ahora) o En una muestra. Cambiar el eje vacía la posición, porque un valor y un instante no son el mismo número.
Dónde va la línea	La posición en ese eje. Dibujar la línea queda atenuado hasta que tenga una.
Qué dice la línea	Texto opcional dibujado sobre la línea.
El color de la línea	Un selector de color; una línea empieza en ámbar.
Dibujar la línea	La dibuja. La posición y el texto se vacían para la siguiente línea; el eje y el color se quedan.

Las líneas son del gráfico que usted tiene enfrente y de nada más: no se guardan, al autor del sinóptico nunca se le avisa, otra conexión no las ve, y cerrar el sinóptico las termina. Una anotación que tiene que sobrevivir a la mirada es de una corrida, donde el archivo de la propia corrida la registra (Corridas y comentarios).

La ventana de gráfico desprendida

Abrir en otra ventana abre la ruta propia del gráfico en una ventana nueva: una ventana de verdad de la aplicación en la estación, y una pestaña nueva en un navegador remoto. Presionarlo otra vez trae al frente la ventana que ya existe en lugar de abrir una segunda. Existen dos rutas:

Ruta	Qué muestra	Se abre desde
`/chart/run/{id}`	El gráfico de datalog de una corrida grabada, releído del archivo de la corrida: sus series, sus anotaciones, sus comentarios y las bandas aprobadas de su procedimiento tal como están configuradas ahora. "Corrida no encontrada" cuando el id no resuelve a nada.	El gráfico de una corrida en Históricos
`/chart/recipe/{id}`	El perfil de Escalón, Rampa y Meseta de una receta, reconstruido a partir de los modelos guardados. "Receta no encontrada" cuando el id no resuelve a nada.	El editor de recetas y la vista previa de receta de un procedimiento

La ventana se dibuja sin el shell: sin barra de navegación, sin barra de título, sin barra de estado, solo con una barra de arriba con el título del gráfico y Sincronizar la X con el gráfico principal ("Reflejar el acercamiento y el desplazamiento del eje X con el gráfico principal"), encendido de forma predeterminada, sobre el gráfico con su barra de herramientas completa. Mientras la sincronización está encendida, la ventana entra a un canal identificado por su ruta y sigue el acercamiento y el desplazamiento del gráfico principal en el eje de tiempo; apagada, navega por su cuenta. Cada ruta exige lo que admite a una identidad en lo que dibuja: la ventana de una corrida exige Ver los históricos, el mismo permiso que admite al navegador de corridas grabadas desde el que se abre, y la ventana de una receta exige la política propia de la página Process, que abre cualquiera de los cuatro interruptores de Process o Ver los históricos. Un rol sin lo que pide su propia ruta, o uno degradado con la ventana abierta, no puede leer ese gráfico por su dirección. La ventana es de solo lectura: los comentarios y las anotaciones se editan en Históricos, no aquí.

Lo que las herramientas no hacen

Nada de la barra cambia el sinóptico: una serie escondida, una fijación, una línea y el estado de la etiqueta emergente son todos estado de este gráfico en esta conexión, y un sinóptico reabierto mañana abre limpio. Nada de la barra llega a un reporte: el PDF dibuja lo que construye su propio productor, sin fijaciones, sin líneas y sin herramientas. La barra no exporta datos, solo imágenes: los números de una corrida salen por las exportaciones de Históricos. Y la barra no ofrece ninguna herramienta que el dibujo no pueda honrar: una comparación de categorías nunca recibe acercamiento, escala, estadísticas ni líneas, y un gráfico sobre un sinóptico nunca recibe una ventana propia.