Graphiques

La barre d'outils que porte chaque graphique et ce que fait chaque bouton, les panneaux 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 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 du datalog d'un essai enregistré dans Historiques, l'aperçu du profil d'une recette dans une recette ou une procédure, l'aperçu du critère d'une évaluation, et les deux fenêtres détachées ci-dessous. Ce qui diffère entre eux, c'est d'où vient la configuration, jamais le tracé : 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 tracé 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 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é, l'aperçu d'une recette) offre tous les outils qu'un graphique temporel peut honorer. Sans aucun outil, aucune barre n'est tracée.

Bouton (son infobulle)	Ce qu'il fait	Proposé sur	Actif 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 propre : un essai enregistré dans Historiques, un profil de recette. Jamais sur un graphique posé sur une vue.	Essais enregistrés, profils de recette	non proposé
Sélectionner une zone à agrandir	Arme le zoom par rectangle : le glissement suivant sur le tracé encadre le rectangle qu'il dessine au lieu de déplacer la vue. 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 panneau 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 qu'on l'ouvre.	Graphiques temporels	non
Minimum, moyenne et maximum de la fenêtre affichée	Ouvre le panneau de statistiques ci-dessous. Mesuré seulement tant que le panneau est ouvert.	Graphiques temporels	non
Tracer une ligne de référence	Ouvre le panneau 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 tracé en PNG à deux fois 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 la lecture au survol. Elle s'ouvre désactivée, 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 la session.	Graphiques temporels	oui
Plein écran	Remplit la fenêtre avec ce seul graphique, par le plein écran d'élément du navigateur ; l'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 un Graphique circulaire ne peut honorer que la paire PNG et le 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 panneau est ouvert à la fois, et un appui n'importe où ailleurs le ferme.

Le zoom et le déplacement eux-mêmes sont le réglage Déplacement du graphique (une fenêtre fixe, molette et glissement, ou molette et glissement plus une barre de navigation sous le tracé qui montre où le cadre se situe dans tout l'enregistrement) ; un graphique à sous-graphiques empilés les déplace tous ensemble, parce qu'ils partagent un seul axe du temps. Un geste ne touche jamais à ce qui est enregistré : le graphique dessine ce qui atteint le plan de travail depuis la plage visible, donc un zoom avant révèle toujours les données réelles, et une marque dans le 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 panneau 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 continue de s'ajuster tout seul.

Champ	Ce qu'il prend
Période / Période (s à partir de maintenant) / Échantillons	Les deux bouts de l'axe du temps, demandés dans les mots dans lesquels l'axe est tracé : deux sélecteurs de date et 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 bouts 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 seule ; la période de 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 bouts tenus y retourne, un axe écrit sans aucun retourne à son ajustement libre. Grisé tant que rien n'est figé sur cet axe.
Charger la fenêtre affichée	Remplit les quatre champs à partir du cadre réellement à l'écran, après chaque zoom et chaque déplacement que vous avez faits, de sorte que figer ce que vous regardez coûte un appui.

Le figeage 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 des échantillons 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 panneau est un tableau d'une ligne par série tracée (une série que l'auteur de la vue a coupée n'est pas sur la vue et n'est pas dans le tableau ; une série masquée avec la légende y est encore), coloriée de son encre, avec Mini, Moyenne et Maxi 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, donc aucune moyenne n'est prise par-dessus un trou. Une ligne qui n'a 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 panneau est ouvert et sont mesurés sur les échantillons eux-mêmes, jamais sur le tracé réduit.

Les lignes de référence

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

Champ	Ce qu'il prend
Quel axe	À une valeur, ou l'axe du temps dans ses propres mots : À un instant (un sélecteur de date et heure), À une seconde (à partir de maintenant) ou À un échantillon. Changer l'axe vide la position, puisqu'une valeur et un instant ne sont pas le même nombre.
Où va la ligne	La position sur cet axe. Tracer la ligne est grisé tant qu'elle n'en contient pas.
Ce que dit la ligne	Texte facultatif tracé sur la ligne.
La couleur de la ligne	Un sélecteur de couleur ; une ligne démarre en orangé.
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 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. Une annotation 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. L'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 du datalog d'un essai enregistré, rechargé depuis le fichier d'essai : ses séries, ses annotations, ses commentaires et les plages approuvées de sa procédure telle qu'elle est configurée aujourd'hui. « Essai introuvable » quand l'identifiant ne résout rien.	Le graphique d'un essai dans Historiques
`/chart/recipe/{id}`	Le profil Échelon, Rampe et Palier d'une recette, reconstruit depuis les modèles enregistré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 s'affiche sans le shell : pas de barre de navigation, pas de barre de titre, pas de barre d'état, juste une barre en haut avec le titre du graphique et Synchroniser X avec le graphique principal (« Refléter le zoom et le déplacement de l'axe X sur le graphique principal »), activée par défaut, au-dessus du graphique avec sa barre d'outils complète. Tant que la synchronisation est active, la fenêtre rejoint un canal désigné par sa route et suit le zoom et le déplacement du graphique principal sur l'axe du temps ; désactivée, elle navigue 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 le navigateur 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 qui le perd 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 annotations se modifient dans Historiques, pas ici.

Ce que les outils ne font pas

Rien dans la barre ne change la vue : une série masquée, un figeage, 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 tracé que son propre producteur construit, sans figeages, sans lignes et sans outils. La barre n'exporte aucune donnée, seulement des images : les nombres d'un essai sortent par les exports d'Historiques. Et la barre n'offre aucun outil que le tracé ne peut pas honorer : une comparaison de catégories ne reçoit jamais de zoom, d'échelle, de statistiques ni de lignes, et un graphique posé sur une vue ne reçoit jamais de fenêtre à lui.