8. Les champs

Vue Sources et acquisition, page Champs.

Ici tu choisis les champs qui seront enregistrés, tu leur donnes un nom et une unité, et tu dis à AstroTools comment reconnaître une valeur valide.

La page Champs, source NINA : quelques champs cochés, le champ focuser.Position sélectionné et son détail en bas (libellé, unité, valeurs valides, valeur « pas de mesure »)

8.1 Le haut de la page

Source : [▾] : la source dont tu vois les champs. Elle suit la source choisie dans la page Sources (et inversement). Le choix (toutes les sources) montre les champs de toutes les sources ensemble ; la colonne Appareil dit alors à quelle source ils appartiennent (nina.camera, pegasus.uranus).
Rafraîchir : la même chose qu'Interroger dans la page Sources : relit les appareils cochés et met les valeurs à jour. Avec (toutes les sources), les sources actives sont interrogées l'une après l'autre. Le texte à côté donne le bilan : « 448 champ(s) rafraîchi(s) sur 448 connu(s) en 510 ms ».
Arrêter et Réponses brutes… : comme dans la page Sources.

8.2 La grille des champs

Colonne	Contenu
Enreg.	coché : ce champ sera enregistré pendant l'acquisition. Décoché par défaut
Appareil	l'alias de l'appareil (ou `source.alias` avec toutes les sources)
Chemin	l'emplacement du champ dans la réponse (`temperature.temperature`, `RMSError.Total.Arcseconds`)
Libellé, Unité	ce que tu as saisi dans le détail (section 8.4)
Type	détecté dans la réponse : nombre, booléen, date, texte, liste, objet, vide
Valeur	la valeur de la dernière interrogation ; en italique avec « (remplacée) » si c'est ta valeur par défaut
État de la valeur	reçue, remplacée ou invalide (raison) (section 8.3)
Statut	connu, nouveau, absent de la réponse, non observé, type changé (section 8.3)

Au-dessus de la grille, le compteur « Champs : x affichés sur y », et le choix des champs affichés :

Tous, Cochés (seront enregistrés), Nouveaux, Utilisables en graphique : les choix rapides ;
Perso et Sélections… : tes propres sélections (chapitre 9) ;
Rechercher : ne garde que les champs dont le libellé, le chemin ou l'identifiant contient le texte tapé (majuscules et accents ignorés : temperature ciel trouve « Température ciel ») ; ✖ vide la zone. La recherche s'ajoute au choix du dessus.

Cocher les bons champs : pense « ce que je voudrai voir sur un graphique demain matin ». Une même grandeur ne se coche que dans une source (chapitre 5, section 5.6).

8.3 États et statuts

L'état de la valeur dit si la valeur lue est utilisable :

État	Sens
reçue	la vraie valeur, valide
remplacée	la valeur reçue manque ou est invalide : ta valeur par défaut est utilisée à la place
invalide (raison)	la valeur est rejetée et il n'y a pas de valeur par défaut. Raisons : absente, mauvais type, valeur « pas de mesure », hors plage, dépendance non remplie

Une valeur remplacée n'est jamais une mesure : AstroTools garde séparément la valeur brute, l'état, la raison et la valeur utilisée, pour que les graphiques puissent plus tard distinguer ou exclure les remplacements.

Le statut dit ce que la dernière interrogation a appris du champ :

Statut	Sens
connu	déjà connu, présent dans la dernière réponse
nouveau	apparu à la dernière interrogation
absent de la réponse	l'appareil a répondu, mais sans ce champ (exemple : `LastGuideStep` quand le guidage est arrêté)
non observé	l'appareil n'a pas répondu (ou n'est pas connecté) : on ne sait rien de ce champ cette fois
type changé	le type de la valeur a changé (un nombre devenu texte) : vérifie ses réglages

Une interrogation ne supprime jamais rien : un champ absent ou non observé garde sa description et sa case cochée.

8.4 Le détail d'un champ

Clique une ligne : son détail s'affiche en bas.

Case	Rôle
Libellé	le nom affiché du champ, dans l'interface et sur les graphiques (« Température ciel »). Vide = l'identifiant brut
Unité	°C, %, hPa, mag/arcsec², ″…
Utilisable en graphique	coché par défaut pour un nombre, un booléen ou une date ; décoche les nombres qui n'ont pas de sens sur un graphique (révision, numéro de port). Grisé pour un texte
Valeur par défaut	la valeur utilisée à la place quand le champ manque ou est invalide. Vide = pas de remplacement
Valeurs « pas de mesure »	les valeurs bidon envoyées par l'appareil quand il n'a pas de mesure, séparées par `;` (exemple : `9999.9999` ou `-999;0`)
Min valide, Max valide	la plage plausible ; en dehors, la valeur est invalide (exemple : qualité du ciel de 5 à 22,5 mag/arcsec²). Vide = pas de limite
Dépend de	section 8.5

Libellé et unité se saisissent ici, pas dans la grille. Ce que tu saisis est appliqué automatiquement quand tu changes de ligne, de choix, de page ou de source, quand tu interroges ou enregistres (barre d'état : « Réglages du champ appliqués (pas encore enregistrés) »). Le bouton Appliquer au champ est facultatif.

Les valeurs se tapent dans le type du champ : un nombre (12,5 ou 12.5), vrai / faux pour un booléen. Une valeur refusée affiche un message (« Valeur par défaut : valeur attendue de type nombre. », « Le min valide doit être inférieur ou égal au max valide. ») et la ligne reste sélectionnée tant que tu ne l'as pas corrigée.

N'oublie pas Enregistrer à la fin.

8.5 Les dépendances

Une dépendance dit : « ce champ n'est valable que si une autre variable de la même source remplit une condition ». Exemple : le point de rosée de la sonde externe de l'UPBv3 n'a de sens que si la sonde est présente.

Dépend de : choisis la variable, puis la condition :

Condition	Vraie quand…
présente	la variable est dans la réponse
valide	la variable est reçue et valide
égale à	la variable vaut exactement la valeur donnée, dans son type (`vrai`, `1`, `Uranus`)

Si la condition n'est pas remplie, le champ est « invalide (dépendance non remplie) », ou « remplacée » s'il a une valeur par défaut.

Règles :
- La condition regarde la vraie valeur reçue, jamais une valeur de remplacement : une valeur par défaut ne rend jamais une autre mesure valide par ricochet.
- « Égale à » compare des valeurs du même type : vrai n'est pas égal au texte "true" ni au nombre 1.
- Une boucle (A dépend de B, B dépend de A) est refusée : « Dépendance refusée : elle créerait une boucle avec … ».

8.6 Exemple complet : la température du ciel de l'Uranus

Page Champs, source Pegasus, Rechercher sky.
Clique le champ de température du ciel. Dans le détail : Libellé Température ciel, Unité °C.
Si l'Uranus envoie 9999.9999 quand il n'a pas de mesure : Valeurs « pas de mesure » 9999.9999.
Coche Enreg. sur la ligne.
Enregistrer. La barre d'état dit « Sources enregistrées ».