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 consigne : un instantané par intervalle, portant chaque voie que le datalog liste, chaque valeur appariée à la qualité à laquelle elle a été lue (Bonne ou Indisponible). Il ne déclare rien sur 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 demandent la permission Modifier recettes et évaluations.

Un modèle dé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 du tout : 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 elles 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 nom; cliquer sur une carte l'ouvre et le X la 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 colonne, et le sélectionne.	Une unité dé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 de lui-même.

Enregistrement

Champ	Ce que c'est	Valeurs / défaut	Effet
Nom	Comment le datalog s'appelle dans l'arbre, 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. Un nom vide est refusé (« Un datalog doit porter un nom. »).	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 (« Entrez un nombre d'au moins 50. ») et la boîte 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 contient 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 `Voie <numéro> · <nom>`.	Seules les voies lisibles sont offertes (Lecture seule et Lecture et écriture) : une voie en Écriture seule n'est jamais échantillonnée, donc une colonne sur une telle voie resterait vide. Une ligne neuve commence 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 (demande « Supprimer la colonne » : le nom de la voie, « Ceci retire la colonne du datalog. »).

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

Rien d'autre n'est déclaré ici. Le nom, l'unité physique, le type et l'encre de graphique de chaque colonne viennent de la voie elle-même. Renommer une voie réécrit cette référence avec 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 donne : « Enregistre 6 voies toutes les 500 ms », et pour une procédure en mode temporel « …, environ 180 échantillons par voie. » Une procédure sans datalog indique « 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 selon une évaluation dont le datalog enregistre les voies.
Une évaluation	Ne juge que les 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, tout comme une procédure 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 sous forme de X sur la carte de la page du dossier. Il demande d'abord (« Supprimer le datalog », « Ceci retire le datalog et les colonnes qu'il enregistre. »). Chaque procédure qui enregistrait par lui vide sa référence Enregistrer et survit. Il demande Modifier recettes et évaluations et est grisé sous le verrou d'ingénierie et sous 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 graphique résolue. L'essai les conserve à travers chaque modification ultérieure du datalog, et même après que le modèle lui-même a été supprimé. Chaque tic enregistre un instantané au niveau de l'application contenant toutes les colonnes : une source indisponible ou une valeur non convertible est stockée comme un vide marqué Indisponible, tandis qu'une valeur correctement reçue comme NaN ou une sentinelle physique reste Bonne. Le reste du cycle de vie se trouve dans Essais et commentaires; consulter et exporter ce qui a été enregistré, c'est les historiques.

Ce qu'un datalog ne fait pas

Il ne dessine rien. Comment un modèle montre ce qu'il enregistre relève d'un tableau de bord ou de 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 ni ne compresse : une ligne par intervalle, toutes les colonnes, telles que lues.