# Gráficos

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

Todos los gráficos de la aplicación los dibuja un mismo motor (ECharts) a través de una misma
vista de gráfico, lo haya puesto en pantalla lo que lo haya puesto: los componentes
[Gráfico de líneas](component-line-chart), [Gráfico de barras](component-bar-chart) y
[Gráfico circular](component-pie-chart) de un panel de control, la tarjeta Canales de un
[panel de unidad](view-unit-panels), el gráfico en vivo de un ensayo en la página Process, el
gráfico de datalog de un ensayo grabado en [Históricos](histories), la vista previa del perfil de
una receta en una [receta](process-recipes) o en un procedimiento, la vista previa del criterio de
una [evaluación](process-evaluations), y las dos ventanas desacopladas de más abajo. Lo que cambia
de uno a otro es de dónde viene la configuración, nunca el dibujo: un hueco en los datos es siempre
un agujero en la línea, nunca un puente, y todos los números y todos los instantes que escribe el
gráfico siguen el propio [idioma y formatos](settings-localization) de la estación. El informe PDF
renderiza el mismo dibujo sin ninguna de las herramientas de esta página.

## La barra de herramientas {#the-toolbar}

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 **Caja de herramientas** de sus propiedades
([El editor de paneles de control](view-editor#toolbox)); una superficie a la que no hay a quién
preguntar (un ensayo grabado, la vista previa de una receta) ofrece todas las herramientas que un
gráfico de tiempo puede honrar. Sin ninguna herramienta no se dibuja ninguna barra de herramientas.

| Botón (su información emergente) | Qué hace | Se ofrece en | Activado por defecto en un sinóptico |
|---|---|---|---|
| Abrir en otra ventana | Abre el mismo gráfico en una ventana propia (véase más abajo). Solo donde el gráfico tiene una dirección propia: un ensayo grabado en Históricos, un perfil de receta. Nunca en un gráfico colocado en un sinóptico. | Ensayos grabados, perfiles de receta | no se ofrece |
| Seleccionar un área para ampliar | Arma el zoom de selección por caja: el próximo arrastre sobre el trazado encuadra la caja que dibuja en lugar de desplazar. El botón se queda encendido mientras está armado. | Gráficos de tiempo | sí |
| Restablecer la ampliación | Devuelve la ventana a todo lo trazado. | Gráficos de tiempo | sí |
| Fijar 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 necesidad de abrirlo. | Gráficos de tiempo | no |
| Mínimo, media 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 un 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. El registro de acciones responde "El gráfico se ha copiado como imagen."; cuando el navegador rechaza la escritura dice "El navegador ha rechazado el portapapeles, así que el gráfico no se ha copiado.", y cuando no tiene portapapeles "Este navegador no ofrece portapapeles, así que el gráfico no se ha copiado." | Todos los gráficos | sí |
| Mostrar u ocultar series | Abre una lista de las series trazadas con una casilla cada una, leída directamente del gráfico; desmarcarla esconde una serie mientras el sinóptico siga abierto. "Sin series" cuando no hay nada trazado. | Gráficos de tiempo | sí |
| La información emergente está desactivada / La información emergente está activada | Activa o desactiva la lectura al pasar el puntero. Abre desactivada, así que una mano que cruza el trazado no lo tapa nunca 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 único gráfico, por la pantalla completa de elemento del navegador; al pulsarlo otra vez, o con Esc, se devuelve 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 la pareja de PNG y Pantalla
completa: una comparación leída en este instante no tiene ningún eje que recorrer, ninguna ventana
que medir y nada sobre lo que poner una línea. Un gráfico de líneas cuya Navegación está en
ventana fija no recibe ni Seleccionar un área para ampliar ni Restablecer la ampliación, estén
marcados o no: una ventana que nada mueve no tiene ampliación a la que respondan, y los dos
vuelven cuando la ventana vuelve a moverse. Solo hay un panel abierto a la vez, y una pulsación
en cualquier otro sitio lo cierra. En un gráfico demasiado bajo para un panel, el panel termina
dentro del gráfico y se desplaza para mostrar lo que no le cabe, y en un gráfico estrecho los
botones que ocupan todo el ancho del formulario de un panel
(**Cargar la ventana mostrada**, **Dibujar la línea**) parten su texto en dos líneas en lugar de
salirse por el borde.

Ampliar y desplazar son en sí mismos el ajuste **Navegación** del gráfico (una ventana fija, la
rueda y el arrastre, o la rueda y el arrastre más una barra de navegación bajo el trazado que
muestra dónde cae la ventana dentro de todo el registro); un gráfico con trazados apilados mueve
todos los trazados a la vez, porque comparten un mismo eje de tiempo. Un gesto no toca nunca lo que
está guardado: el gráfico dibuja lo que llega al lienzo desde el intervalo visible, así que ampliar
descubre siempre los datos de verdad, y una marca en la esquina puede decir si la imagen es la
medición o una reducción de ella
([Gráfico de líneas](component-line-chart#fidelity-and-performance)).

## Fijar la escala a mano {#set-the-scale-by-hand}

El panel fija un periodo del eje de tiempo y un intervalo del eje de valores, cada lado de forma
independiente. Todos los campos se confirman al salir de ellos; un campo vacío es un lado dejado
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 recuentos de muestras en un eje de muestras. |
| Eje de valores, mínimo y máximo | Los extremos del propio eje de valores del gráfico. En un gráfico con trazados apilados, esta es solo la regla del trazado de arriba; el periodo de tiempo mueve todos los trazados a la vez. |
| Automática (una por eje) | Devuelve ese eje a la ventana que construyó el gráfico: una ventana deslizante vuelve a deslizarse, un eje escrito con extremos retenidos vuelve a ellos, y uno escrito sin ninguno vuelve a su ajuste libre. Atenuada mientras no hay nada fijado en ese eje. |
| Cargar la ventana mostrada | Rellena los cuatro campos con la ventana que hay realmente en pantalla, después de todos los zooms y desplazamientos que usted hizo, así que fijar lo que está mirando cuesta una pulsación. |

La fijación pertenece a este gráfico en esta conexión: no se guarda nunca con el sinóptico, otro
navegador que mira el mismo gráfico tiene la suya, y cerrar el sinóptico la libera. Una ventana
fijada que no contiene ninguna de las muestras se dibuja igualmente, y lo dice bajo el trazado: "No
se ha medido nada dentro de la escala que ha fijado."

## Mínimo, media y máximo {#minimum-average-and-maximum}

El panel es una tabla con una fila por serie trazada (una serie que el autor del sinóptico desactivó
no está en el sinóptico ni en la tabla; una escondida con la leyenda sí), coloreada con su tinta,
con **Mínimo**, **Media** y **Máximo** sobre las muestras de dentro de la ventana mostrada,
escritos como escribe los números la estación. La línea de encima de 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 ha retrocedido por el histórico. La información
emergente de una fila dice cuántas de las muestras de la ventana eran lecturas; un hueco cuenta
como una muestra que la ventana contenía y como nada en los tres números, así que no se toma
ninguna media a través de un agujero. Una fila sin nada que leer escribe huecos y dice de qué
silencio se trata: "No se ha muestreado nada de esta serie en la ventana mostrada." o "Todas las
muestras de esta serie en la ventana mostrada son un hueco." Los números siguen los datos en tiempo
real mientras el panel está abierto y se miden sobre las propias muestras, nunca sobre el dibujo
reducido.

## Líneas de referencia {#reference-lines}

Una línea de referencia es una línea a un valor a través del trazado, o a un instante a lo largo de
él, con palabras que dicen por qué está ahí y un color que la distingue de la siguiente. El panel
enumera lo que hay dibujado, cada una con su ✕, y **Quitar todas**; bajo la lista, un pequeño
formulario 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 de eje vacía la posición, ya que 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 contiene 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 línea siguiente; el eje y el color se quedan. |

Las líneas pertenecen al gráfico que tiene usted delante y a nada más: no se guardan, al autor del
sinóptico no se le dice nunca, otra conexión no las ve, y cerrar el sinóptico las termina. Una
anotación que tiene que sobrevivir a la mirada pertenece a un ensayo, donde el propio archivo del
ensayo la registra ([Ensayos y comentarios](process-runs)).

## La ventana de gráfico desacoplada {#the-detached-chart-window}

**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, una pestaña nueva en un navegador remoto. Al pulsarlo otra
vez trae al frente la ventana que ya existe en lugar de abrir una segunda. Hay dos rutas:

| Ruta | Qué muestra | Se abre desde |
|---|---|---|
| `/chart/run/{id}` | El gráfico de datalog de un ensayo grabado, recargado desde el archivo del ensayo: sus series, sus anotaciones, sus comentarios y las bandas aprobadas de su procedimiento tal como están configuradas ahora. "Ensayo no encontrado" cuando el id no resuelve a nada. | El gráfico de un ensayo en [Históricos](histories) |
| `/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 la receta de un procedimiento |

La ventana se renderiza sin el shell: sin barra de navegación, sin barra de título, sin barra de
estado, solo una barra superior con el título del gráfico y **Sincronizar X con el gráfico
principal** ("Reflejar la ampliación y el desplazamiento del eje X con el gráfico principal"), activado
por defecto, sobre el gráfico con su barra de herramientas completa. Mientras la sincronización
está activada, la ventana se une a un canal identificado por su ruta y sigue el zoom y el
desplazamiento del gráfico principal en el eje de tiempo; desactivada, navega por su cuenta. Cada
ruta exige lo que admite a una identidad en lo que dibuja: la ventana de un ensayo exige Ver los
históricos, el mismo permiso que admite al navegador de ensayos grabados 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 que no tiene 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 {#what-the-tools-do-not-do}

Nada de la barra de herramientas cambia el sinóptico: una serie escondida, una fijación, una línea y el estado de
la información emergente son todos estado de este gráfico en esta conexión, y un sinóptico que se
vuelva a abrir mañana abre limpio. Nada de la barra llega a un informe: el PDF renderiza el dibujo
que construye su propio productor, sin fijaciones, sin líneas y sin herramientas. La barra no
exporta ningún dato, solo imágenes: los números de un ensayo salen por las exportaciones de
[Históricos](histories). Y la barra no ofrece ninguna herramienta que el dibujo no pueda honrar:
una comparación de categorías no recibe nunca zoom, ni escala, ni estadísticas, ni líneas, un
gráfico de líneas sujeto a una ventana fija no recibe nunca los dos botones de ampliación, y un
gráfico de un sinóptico no recibe nunca una ventana propia.