Datalogs

Les configurations d'enregistrement d'un modèle : un instantané par intervalle, les voies qu'il capture, et l'ordre des colonnes que chaque essai suit.

Afficher en Markdown

Un datalog est une configuration d'enregistrement réutilisable du modèle. Il déclare ce qu'un essai note : un instantané par intervalle, portant chaque voie que le datalog liste, chaque valeur appariée à la qualité sous laquelle elle a été lue (Bonne ou Indisponible). Il ne déclare rien de la façon dont le modèle se dessine : un graphique est un composant sur un tableau de bord, pas un réglage d'ici. Les datalogs vivent sous Process > Modèles > modèle > Réglage > Datalogs et exigent la permission Modifier recettes et évaluations.

Un modèle tient autant de datalogs qu'il lui en faut. Une procédure en désigne un par son étape Enregistrer, et c'est cette référence qui fait qu'un essai enregistre : une procédure sans datalog n'enregistre aucun échantillon et ne peut porter aucune évaluation, parce qu'une évaluation juge sur des lignes enregistrées. Les commandes Instantané et Évaluer maintenant d'un volet enregistrent aussi par un datalog, une ligne à la fois.

Le dossier Datalogs

Sélectionner la ligne Datalogs ouvre la page du dossier (« Des configurations d'enregistrement réutilisables : un intervalle d'instantané périodique et les voies capturées dans chaque essai qui en référence une. ») avec une carte par datalog, par son nom ; cliquer sur une carte l'ouvre et le X le retire. Sans aucun, la page indique « Aucun datalog pour l'instant. Ajoutez-en un. »

Commande	Ce qu'elle fait	Grisée quand (situation)	Non dessinée quand (rôle)
Nouveau datalog (barre de détail, dossier sélectionné ; clic droit Ajouter un datalog)	Ajoute `Datalog <n>` à 1000 ms sans aucune colonne, et le sélectionne.	Une unité quelconque tient un essai, ou le runtime est arrêté.	Sans Modifier recettes et évaluations.

La page du datalog

L'en-tête porte le nom et la ligne « Ce qui est enregistré : un instantané périodique contenant toutes les voies sélectionnées, à l'intervalle configuré. » Chaque champ s'enregistre automatiquement.

Enregistrement

Champ	Ce que c'est	Valeurs / défaut	Effet
Nom	Le nom du datalog dans l'arborescence, dans le sélecteur Enregistrer d'une procédure et dans les sélecteurs d'instantané d'un volet.	Texte libre ; `Datalog <n>` à la création.	Renomme la ligne.
Intervalle d'instantané (ms)	À quelle fréquence un instantané est enregistré. La ligne sous le champ dit « À quelle fréquence un instantané est enregistré. 50 ms est le plus rapide qu'un essai enregistre. »	Un nombre entier de millisecondes, 50 ou plus ; 1000 par défaut. Une valeur plus courte est refusée sous le champ (« Saisissez un nombre d'au moins 50. ») et la zone revient à ce qu'elle contenait.	Fixe la cadence d'enregistrement de chaque essai et de chaque instantané qui emploie ce datalog.

Voies

« Les voies du modèle enregistrées pendant l'essai. Ce sont elles qui définissent les colonnes de l'essai. » L'en-tête de la carte porte Nouvelle voie, qui ajoute une colonne, et la grille tient une ligne par colonne enregistrée.

Colonne	Ce que c'est	Valeurs / défaut
Voie	La voie du modèle que cette colonne enregistre, sous la forme `Ch<number> · <name>`.	Seules les voies lisibles sont proposées (Lecture seule et Lecture et écriture) : une voie en Écriture seule n'est jamais échantillonnée, donc une colonne posée sur elle resterait vide. Une nouvelle ligne démarre sur la première voie lisible du modèle ; quand le modèle n'en a aucune, la ligne est ajoutée avec un sélecteur vide.
Actions de ligne	Monter la voie, Descendre la voie (les extrémités restent grisées), Retirer (qui demande : Supprimer la colonne ? le nom de la voie, Ceci retire la colonne du datalog. Cette action est irréversible.).

L'ordre des lignes est l'ordre des colonnes : c'est lui que suivent le fichier d'essai, le CSV et les feuilles XLSX, donc les deux flèches décident de l'allure d'un export. Un déplacement que la station refuse remet la ligne où elle était. La grille ne vous empêche pas de lister la même voie sur deux lignes ; chaque ligne devient une colonne à part.

Rien d'autre n'est déclaré ici. Le nom, l'unité physique, le type et l'encre de tracé de chaque colonne viennent de la voie elle-même. Renommer une voie réécrit cette référence en même temps que toutes les autres du modèle, et retirer une voie balaie sa colonne après une confirmation qui compte ce qui part.

Où un datalog est employé

Surface	Ce qu'elle fait du datalog
L'étape Enregistrer d'une procédure	Enregistre par lui pendant chaque essai de la procédure. La ligne de l'étape dit ce que cela représente : « Enregistre 6 voies toutes les 500 ms », et pour une procédure Temporelle « …, environ 180 échantillons par voie. » Une procédure sans datalog se lit « Rien n'est enregistré : cet essai ne laisse aucun datalog. »
La carte Commandes uniques d'un volet	Instantané enregistre une ligne par le datalog choisi comme un essai Instantané né et terminé dans les Historiques ; Évaluer maintenant enregistre une ligne et la juge contre une évaluation dont le datalog enregistre les voies.
Une évaluation	Ne juge que des voies que le datalog de la procédure enregistre : un critère dont la voie (ou la voie de référence) n'est pas une colonne de ce datalog ne peut pas être jugé, et la page de l'évaluation le dit.
Une occurrence armée pendant un essai	Lit les colonnes enregistrées, donc une voie que le datalog n'enregistre pas lui est indisponible pendant l'essai. Une procédure qui arme une occurrence sur une voie que ce datalog laisse de côté est refusée, comme l'est celle qui arme une occurrence et n'enregistre rien du tout.

Retirer le datalog

Retirer le datalog se tient dans le groupe de danger de la barre de détail avec le datalog sélectionné, sur son menu contextuel, et comme le X sur la carte de la page du dossier. Il demande d'abord : Supprimer « X » ? Ceci retire le datalog et les colonnes qu'il enregistre. Cette action est irréversible. Chaque procédure qui enregistrait par lui vide sa référence Enregistrer et survit. Il exige Modifier recettes et évaluations et est grisé sous le verrou d'ingénierie et le runtime arrêté.

Ce qu'un essai en fait

Le démarrage fige la disposition des voies du datalog dans le fichier d'essai : les colonnes, dans l'ordre, chacune avec son numéro, son nom, l'alias en vigueur sur l'unité, son unité physique et son encre de tracé résolue. L'essai les garde à travers chaque modification ultérieure du datalog, et même après la suppression du modèle lui-même. Chaque top enregistre un instantané au niveau de l'application contenant toutes les colonnes : une source indisponible ou une valeur non convertible est stockée comme une lacune marquée Indisponible, tandis qu'une valeur correctement reçue telle qu'un NaN ou une sentinelle physique reste Bonne. Le reste du cycle de vie est sur Essais et commentaires ; parcourir et exporter ce qui a été enregistré relève des Historiques.

Ce qu'un datalog ne fait pas

Il ne dessine rien. La façon dont un modèle montre ce qu'il enregistre est un tableau de bord ou la carte Voies d'un volet.
Il n'enregistre rien par lui-même. Un datalog qu'aucune procédure ne référence et qu'aucun instantané ne déclenche n'enregistre aucune ligne.
Il n'a aucune variante par unité : chaque unité enregistre les mêmes colonnes, sur ses propres liaisons.
Il ne filtre, ne moyenne et ne compresse rien : une ligne par intervalle, toutes les colonnes, telles que lues.