Graphiques

La barre d'outils que chaque graphique porte et ce que fait chaque bouton, les volets d'échelle, de statistiques et de lignes de référence, la fenêtre de graphique détachée, où les graphiques apparaissent dans l'application, et le moteur unique derrière eux tous.

Afficher en Markdown

Chaque graphique de l'application est dessiné par un seul moteur (ECharts) au travers d'une seule vue de graphique, quoi qu'il l'ait mis à l'écran : les composants Graphique en courbes, Graphique en barres et Graphique circulaire d'un tableau de bord, la carte Voies d'un volet d'unité, le graphique en direct d'un essai sur la page Process, le graphique de datalog d'un essai enregistré dans les Historiques, l'aperçu du profil d'une recette dans une recette ou une procédure, l'aperçu de critère d'une évaluation, et les deux fenêtres détachées ci-dessous. Ce qui diffère entre eux, c'est l'endroit d'où vient le paramétrage, jamais le dessin : une lacune dans les données est toujours un trou dans la courbe, jamais un pont, et chaque nombre et chaque instant que le graphique écrit suivent la localisation propre à la station. Le rapport PDF rend le même dessin sans aucun des outils de cette page.

Un graphique porte une rangée de boutons au-dessus de son tracé : la même barre partout, à qui l'on dit graphique par graphique quels boutons dessiner. Sur un composant de tableau de bord, cette liste est la section Boîte à outils de ses propriétés (L'éditeur de tableau de bord); une surface qui n'a personne à qui demander (un essai enregistré, un aperçu de recette) offre tous les outils qu'un graphique temporel peut honorer. Sans aucun outil, aucune barre n'est dessinée.

Bouton (son infobulle)	Ce qu'il fait	Offert sur	Activé par défaut sur une vue
Ouvrir dans une autre fenêtre	Ouvre le même graphique dans une fenêtre à lui (voir plus bas). Seulement là où le graphique a une adresse à lui : un essai enregistré dans les Historiques, un profil de recette. Jamais sur un graphique posé sur une vue.	Essais enregistrés, profils de recette	non offert
Sélectionner une zone à agrandir	Arme le zoom par sélection de cadre : le glissement suivant sur le tracé cadre la boîte qu'il dessine au lieu de faire un panoramique. Le bouton reste allumé tant qu'il est armé.	Graphiques temporels	oui
Réinitialiser le zoom	Ramène le cadre à tout ce qui est tracé.	Graphiques temporels	oui
Régler l'échelle à la main	Ouvre le volet d'échelle ci-dessous. Allumé tant que quelque chose est figé, de sorte qu'une échelle qui a cessé de suivre les données le dise sans être ouverte.	Graphiques temporels	non
Minimum, moyenne et maximum de la fenêtre affichée	Ouvre le volet de statistiques ci-dessous. Mesuré seulement tant que le volet est ouvert.	Graphiques temporels	non
Tracer une ligne de référence	Ouvre le volet des lignes de référence ci-dessous. Allumé tant qu'une ligne est tracée.	Graphiques temporels	non
Enregistrer le PNG	Télécharge le dessin en PNG au double de la résolution de l'écran, sur le fond du thème, nommé d'après le titre du graphique (« chart » quand il n'en a pas).	Tous les graphiques	oui
Copier le PNG	Met le même PNG dans le presse-papiers. Un navigateur qui refuse les écritures dans le presse-papiers ne fait rien, en silence.	Tous les graphiques	oui
Afficher ou masquer des séries	Ouvre une liste des séries tracées avec une case à cocher chacune, lue directement sur le graphique; décocher masque une série tant que la vue reste ouverte. « Aucune série » quand rien n'est tracé.	Graphiques temporels	oui
L'infobulle est désactivée / L'infobulle est activée	Active ou désactive l'affichage au survol. Il s'ouvre désactivé, de sorte qu'une main qui traverse le tracé ne le couvre jamais d'une boîte que personne n'a demandée; le choix dure le temps de la session.	Graphiques temporels	oui
Plein écran	Remplit la fenêtre avec ce seul graphique, par le plein écran d'élément du navigateur; appuyer de nouveau, ou Échap, rend la fenêtre. Sur un tableau de bord déjà en plein écran, il agrandit le graphique, et Échap quitte le graphique avant de quitter le tableau de bord.	Tous les graphiques	oui

Un Graphique en barres ou circulaire ne peut honorer que la paire PNG et Plein écran : une comparaison lue à cet instant n'a pas d'axe à parcourir, pas de fenêtre à mesurer et rien sur quoi poser une ligne. Un seul volet est ouvert à la fois, et un appui ailleurs le ferme.

Le zoom et le panoramique eux-mêmes sont le réglage Déplacement du graphique (un cadre fixe, la molette et le glissement, ou la molette et le glissement plus une barre de déplacement sous le tracé qui montre où le cadre se situe dans tout l'enregistrement); un graphique à sous-graphiques empilés déplace tous les sous-graphiques ensemble, parce qu'ils partagent un seul axe du temps. Un geste ne touche jamais à ce qui est conservé : le graphique dessine ce qui atteint le plan de travail depuis la plage visible, alors un zoom avant révèle toujours les données réelles, et une marque de coin peut dire si l'image est la mesure ou une réduction de celle-ci (Graphique en courbes).

Régler l'échelle à la main

Le volet fige une période de l'axe du temps et une plage de l'axe des valeurs, chaque côté indépendamment. Chaque champ valide quand vous le quittez; un champ vide est un côté laissé libre, qui s'ajuste encore de lui-même.

Champ	Ce qu'il accepte
Période / Période (s depuis maintenant) / Échantillons	Les deux extrémités de l'axe du temps, demandées dans les mots dans lesquels l'axe est dessiné : deux sélecteurs de date et d'heure sur un axe d'horloge, deux nombres de secondes sur un axe relatif, deux nombres d'échantillons sur un axe d'échantillons.
Axe des valeurs, minimum et maximum	Les extrémités de l'axe des valeurs propre au graphique. Sur un graphique à sous-graphiques empilés, c'est la règle du sous-graphique du haut seulement; la période du temps déplace tous les sous-graphiques ensemble.
Automatique (un par axe)	Rend cet axe au cadre que le graphique avait construit : une fenêtre glissante glisse de nouveau, un axe écrit avec des extrémités figées y revient, un axe écrit sans aucune revient à son ajustement libre. Grisé tant que rien n'est figé sur cet axe.
Charger la fenêtre affichée	Remplit les quatre champs depuis le cadre réellement à l'écran, après tous les zooms et panoramiques que vous avez faits, de sorte que figer ce que vous regardez coûte un seul appui.

Le figement appartient à ce graphique sur cette connexion : il n'est jamais enregistré avec la vue, un autre navigateur qui regarde le même graphique a le sien, et fermer la vue le libère. Un cadre figé qui ne contient aucun échantillon se dessine tout de même, et le dit sous le tracé : « Rien n'a été mesuré dans l'échelle que vous avez figée. »

Minimum, moyenne et maximum

Le volet est un tableau avec une ligne par série tracée (une série que l'auteur de la vue a désactivée n'est pas sur la vue et n'est pas dans le tableau; une série masquée par la légende y est encore), colorée de son encre, avec Minimum, Moyenne et Maximum sur les échantillons contenus dans la fenêtre affichée, écrits comme la station écrit les nombres. La ligne au-dessus du tableau dit de quelle fenêtre il s'agit : « La fenêtre affichée, jusqu'à l'échantillon le plus récent. » ou « La fenêtre affichée. L'échantillon le plus récent est au-delà de son bord droit. » quand vous êtes remonté dans l'historique. L'infobulle d'une ligne dit combien des échantillons de la fenêtre étaient des lectures; une lacune compte comme un échantillon que la fenêtre contenait et comme rien dans les trois nombres, de sorte qu'aucune moyenne ne soit prise au travers d'un trou. Une ligne sans rien à lire écrit des lacunes et dit de quel silence il s'agit : « Rien de cette série n'a été échantillonné dans la fenêtre affichée. » ou « Chaque échantillon de cette série dans la fenêtre affichée est une lacune. » Les nombres suivent les données en direct tant que le volet est ouvert et sont mesurés sur les échantillons eux-mêmes, jamais sur le dessin réduit.

Les lignes de référence

Une ligne de référence est une ligne posée à une valeur en travers du tracé, ou à un instant de haut en bas, avec des mots pour dire pourquoi elle est là et une couleur pour la distinguer de la suivante. Le volet énumère ce qui est tracé, chaque ligne avec son ✕, et Tout retirer; sous la liste, un petit formulaire trace la suivante :

Champ	Ce qu'il accepte
Quel axe	À une valeur, ou l'axe du temps dans ses propres mots : À un instant (un sélecteur de date et d'heure), À une seconde (depuis maintenant) ou À un échantillon. Changer d'axe vide la position, puisqu'une valeur et un instant ne sont pas le même nombre.
Où la ligne se pose	La position sur cet axe. Tracer la ligne est grisé tant qu'elle n'en contient pas une.
Ce que la ligne dit	Un texte facultatif dessiné sur la ligne.
La couleur de la ligne	Un sélecteur de couleur; une ligne démarre en ambre.
Tracer la ligne	La trace. La position et le texte se vident pour la ligne suivante; l'axe et la couleur restent.

Les lignes appartiennent au graphique que vous avez devant vous et à rien d'autre : elles ne sont pas enregistrées, l'auteur de la vue n'en est jamais informé, une autre connexion ne les voit pas, et fermer la vue y met fin. Un repère qui doit survivre au regard appartient à un essai, où le fichier propre à l'essai l'enregistre (Essais et commentaires).

La fenêtre de graphique détachée

Ouvrir dans une autre fenêtre ouvre la route propre au graphique dans une nouvelle fenêtre : une vraie fenêtre de l'application sur la station, un nouvel onglet dans un navigateur distant. Appuyer de nouveau ramène la fenêtre existante au premier plan au lieu d'en ouvrir une deuxième. Deux routes existent :

Route	Ce qu'elle montre	Ouverte depuis
`/chart/run/{id}`	Le graphique de datalog d'un essai enregistré, rechargé depuis le fichier d'essai : ses séries, ses repères, ses commentaires et les plages admises de sa procédure telle qu'elle est configurée en ce moment. « Essai introuvable » quand l'identifiant ne résout rien.	Le graphique d'un essai dans les Historiques
`/chart/recipe/{id}`	Le profil en échelons, rampes et paliers d'une recette, reconstruit depuis les modèles conservés. « Recette introuvable » quand l'identifiant ne résout rien.	L'éditeur de recette et l'aperçu de recette d'une procédure

La fenêtre se rend sans l'enveloppe : pas de barre de navigation, pas de barre de titre, pas de barre d'état, juste une barre supérieure avec le titre du graphique et Synchroniser X avec le graphique principal (« Refléter le zoom et le panoramique de l'axe X avec le graphique principal »), activé par défaut, au-dessus du graphique avec toute sa barre d'outils. Tant que la synchronisation est active, la fenêtre rejoint un canal identifié par sa route et suit le zoom et le panoramique du graphique principal sur l'axe du temps; désactivée, elle se déplace toute seule. Chaque route exige ce qui admet une identité à ce qu'elle dessine : la fenêtre d'un essai demande Voir les historiques, la permission même qui admet l'explorateur des essais enregistrés d'où elle est ouverte, et la fenêtre d'une recette demande la politique propre à la page Process, qu'ouvre n'importe lequel des quatre interrupteurs de Process ou Voir les historiques. Un rôle qui n'a pas ce que sa propre route demande, ou un rôle rétrogradé pendant que la fenêtre est ouverte, ne peut pas lire ce graphique par son adresse. La fenêtre est en lecture seule : les commentaires et les repères se modifient dans les Historiques, pas ici.

Ce que les outils ne font pas

Rien dans la barre ne change la vue : une série masquée, un figement, une ligne et l'état de l'infobulle sont tous l'état de ce graphique sur cette connexion, et une vue rouverte demain s'ouvre nette. Rien dans la barre n'atteint un rapport : le PDF rend le dessin que son propre producteur construit, sans figements, sans lignes et sans outils. La barre n'exporte aucune donnée, seulement des images : les nombres d'un essai sortent par les exports des Historiques. Et la barre n'offre aucun outil que le dessin ne peut pas honorer : une comparaison de catégories n'obtient jamais ni zoom, ni échelle, ni statistiques, ni lignes, et un graphique posé sur une vue n'obtient jamais une fenêtre à lui.