Files
aimsight-tools/GUIDE.md
T

41 KiB
Raw Blame History

Lire les données

Le guide du harnais de lecture : suivi par l'analyste ; amélioré par le tool-builder (dépôt agents), seul à écrire ici.

Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; son propre mouvement est compensé grâce à des cibles de référence, supposées fixes. Ce mouvement, la pose de la caméra (pan, tilt, rotation en degrés, scale, sigma0 du recalage, dans camera/), se lit avant les capteurs : il explique une grande part de ce qui bouge sur les courbes (D-073). Ce guide dit comment lire les données d'une station : ce que montrent les courbes et les images, moment par moment. Il ne dit pas ce qu'elles veulent dire : catégorie, event connu, hypothèse et verdict sont l'affaire de celui qui t'appelle.

À lire d'abord

  • labeling/connaissances/colonnes-des-deplacements.md : formats des exports et sens des colonnes (en premier) ;
  • labeling/connaissances/les-trous.md ;
  • sur une station dont l'export porte les métriques de qualité d'image (peak à snr : la ligne « Qualité d'image de l'export » d'inventaire.py), labeling/connaissances/metriques-de-qualite.md.

Les outils

Lance-les depuis la racine du dépôt appelant, où tools/, data/ et labeling/ sont des liens. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges.

Commande Ce qu'elle rend
python3 tools/scripts/inventaire.py <dossier> [--debut T] [--fin T] [--fichiers] Fichiers par type (au-delà de 5 par type : le nombre, le premier et le dernier ; --fichiers pour la liste complète, à n'utiliser que pour chercher un fichier précis), ce que contient chaque source sur la fenêtre (colonnes de l'export, de la pose et de quality/, avec le nombre de lignes qui ont une valeur, « vide » sinon ; noms des métriques système de metrics/ ; images et images différentielles ; des noms et des comptes, jamais de valeurs), images : par suites d'écarts égaux entre deux images (à 5 min près, sur la fenêtre si elle est donnée ; une ligne par changement d'écart : un trou se date par ses deux images), poses de la caméra (nombre, période, instants de mesure sans recalage), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) : ces comptes portent sur toute la période. Avec --debut/--fin (sur un lot : ceux du lot), une section de plus pour la fenêtre : les pas absents datés (pour tous les capteurs, ou lesquels manquent), par capteur, les mesures rejetées datées (suites de pas consécutifs), puis le nombre de références retenues par la compensation (inlier = 1) à chaque instant et les suites datées où des références ne le sont pas, lesquelles et pourquoi (r rejetée, 0 écartée par la compensation, vide). Une mesure est rejetée quand son error_value dépasse le seuil du capteur, références comprises. Quand pattern_type est vide, un capteur est une référence s'il porte reproj_err ou inlier (la ligne « pattern_type vide pour N capteurs » le dit) ; une colonne de l'export que tous les capteurs ne portent pas dit combien la portent. Quand inlier est vide sur la fenêtre, les références retenues sont lues sur reproj_err rempli (le titre le dit) ; une marque autre que r ou vide est la valeur d'inlier (ex. -1). « Relevés en double » : un export (souvent nommé d'après le projet du client) dont les relevés sont déjà dans les autres ; avec 0 valeur différente, il ne change rien à la lecture, sinon les outils gardent celui du dernier fichier dans l'ordre des noms. Une suite qui finit le même jour n'écrit que l'heure de sa fin. La ligne « Qualité d'image de l'export (peak à snr) » dit si les six métriques de qualité sont remplies (alors qualite.py) ou vides. Sur un mois, la sortie avec --debut/--fin dépasse ce qu'un appel affiche : lis chaque section par un tube vers grep (ex. `
python3 tools/scripts/resume.py <dossier> [--colonne C] [--stat median|min|max] [--pas 1h] [--niveau periode|fenetre] [--capteurs A,B] [--debut T] [--fin T] [--instants T1,T2] [--marque] Niveau habituel de chaque capteur (médiane, MAD, min, max) sur toute la période, ou sur la fenêtre --debut/--fin avec --niveau fenetre (pour un lot : un changement de niveau dans le lot ne se compare pas à des semaines d'autres mesures), puis un tableau par pas de temps. Colonnes : error_value, corr_x, corr_y, relative_x, relative_y, x, y, sigma0, reproj_err, et les six métriques de qualité d'image peak, flux, sharpness, fwhm, dominance, snr (valeurs brutes ; face à une référence calme, qualite.py). L'en-tête des capteurs se répète toutes les 24 lignes. --marque : * après la valeur quand une mesure du pas est rejetée (x, y, error_value d'une mesure rejetée restent remplis), o quand une mesure du pas a inlier = 0. --instants T1,T2 : seulement les pas qui contiennent ces instants (les valeurs de tous les capteurs à quelques heures choisies). Avec --pas égal à la cadence, --niveau fenetre --marque, c'est la table par instant et par capteur d'une colonne : une colonne par lancement
.venv/bin/python tools/scripts/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D] Un PNG des séries ; chaque --zone est grisée ; il imprime son chemin. Colonnes : celles de resume.py, métriques de qualité comprises (valeurs brutes). Regarde-le avec Read : tu lis mieux un graphique qu'un tableau
`.venv/bin/python tools/scripts/ensemble.py [--colonnes x,y,sigma0] [--colonne error_value] [--pas 15min] [--k 5] [--min 5] [--residus corr_x,corr_y,error_value non] [--hors T1/T2] [--autres] [--rigide BASE [--sans A,B] [--suivre A,B]] [--table T1/T2
`python3 tools/scripts/plages.py [--colonnes error_value,corr_x,corr_y] [--k 5] [--fusion 1h] [--min-mesures 1] [--hors T1/T2] [--glissant N DUREE] [--instants N] [--capteurs A,B] [--debut T] [--fin T]`
.venv/bin/python tools/scripts/jours.py <dossier> [--colonnes corr_x,corr_y,error_value] [--nuit 20-3] [--k 5] [--jours 2] [--pas 15min] [--capteurs A,B] [--bornes [--lissage N] [--fraction F]] [--debut T] [--fin T] [--sortie D] Ce qui revient d'un jour à l'autre, sur les mesures acceptées seulement. 1. Niveau de chaque nuit (heures --nuit H1-H2 UTC, à cheval sur minuit, datée du jour où elle commence), par capteur et par colonne : médiane, MAD, nombre de mesures, et le bruit propre ; puis, d'une nuit à la suivante, la marche (différence des médianes, en unités et en bruits) et où elle se place (« entre A et B » : là où la suite des mesures de nuit des deux nuits se coupe le mieux entre les deux niveaux ; B au début de la nuit suivante : la coupure tombe de jour, entre les deux nuits). Une marche de quelques bruits, une dérive d'une nuit à l'autre, et deux colonnes qui marchent au même instant s'y lisent, même quand le capteur a plusieurs niveaux dans le lot. 2. Jours superposés : PNG parheure-, un petit graphique par capteur, en abscisse l'heure du jour, une courbe par jour, chaque mesure moins le niveau de la dernière nuit commencée (nuit grisée, cadre du 1er au 99e centile, le titre dit combien de mesures sortent du cadre) ; table : par créneau de --pas de l'heure du jour, les capteurs dont l'écart dépasse --k bruits, du même côté, au moins --jours jours, avec le nombre de jours et la médiane de ces écarts. Ce qui revient chaque jour à la même heure, sur un capteur ou plusieurs, s'y groupe, même quand cela ne dure qu'une à trois mesures. 3. Bornes de chaque jour, avec --bornes : pour la médiane des cibles de chaque colonne et pour la pose de la caméra (pan, tilt, rotation, scale, sigma0, si camera/ existe), l'écart au niveau de la nuit qui précède chaque jour (un jour va de la fin d'une nuit à la fin de la suivante ; avec --capteurs, la médiane de ces capteurs, avec un seul, le sien). Par jour : nombre de mesures, la première et la dernière ; premier et dernier instant au-delà de --k bruits, avec la mesure juste avant et juste après, au pas natif ; max et min signés avec leur instant ; la suite de mesures au-delà de --k bruits qui entoure le plus grand des deux ; la nuit suivante moins la nuit de référence. Un jour sans mesure le dit ; une nuit de référence qui n'est pas la précédente est nommée. Chaque ligne de jour commence par le nom court de sa suite (corr_x, pose_tilt…) : sur un mois, `
.venv/bin/python tools/scripts/metriques.py <dossier> [--noms A,B] [--pas 1h] [--stat median|min|max] [--contre temperature] [--lissage 24h] [--metriques-seules] [--debut T] [--fin T] [--sortie D] Les métriques système de metrics/ (une valeur par heure), jamais les identifiants (SIM_CCID, ip*). Imprime les métriques disponibles avec leur nombre de valeurs sur la fenêtre (« vide » : aucune), puis une table par pas de --pas : temperature (médiane des composants sensor_*_deg_c, celle que lisent les détecteurs), chaque métrique de --noms (défaut : les *_deg_c et BusVoltage), puis, sauf --metriques-seules, cib_corr_x, cib_corr_y (médiane sur les cibles de corr moins le niveau propre de chaque cible, mesures acceptées) et la pose brute de la caméra (cam_pan … cam_sigma0) ; une case vide est sautée, une métrique texte (link, BatteryState, last_sync) est rendue telle quelle. Puis, par colonne : pas remplis, min et max avec leur instant ; la corrélation r et la pente de chaque colonne sur --contre (avec --lissage 24h, sur sa moyenne glissante, colonne <contre>_lisse) ; les suites datées de pas sans aucune métrique. Un PNG : températures sur un panneau (médiane en noir), chaque autre métrique sur le sien, puis cib_corr_x, cib_corr_y et la pose, trait coupé sur un trou. Regarde-le avec Read
.venv/bin/python tools/scripts/stations.py <dossier> <dossier> [...] [--colonnes temperature,cam_tilt,cam_rotation,cam_scale,cib_corr_x,cib_corr_y] [--pas 1h] [--stat median|min|max] [--table T1/T2|non] [--debut T] [--fin T] [--sortie D] Plusieurs stations sur une même ligne de temps (stations voisines, même bâtiment). Colonnes possibles : temperature (comme metriques.py), cam_pan … cam_sigma0 (pose brute), cib_corr_x, cib_corr_y (comme metriques.py), rej_cibles, rej_refs (nombre de cibles, de références rejetées, le plus grand du pas). Imprime par station la période, la cadence et le nombre d'instants ; puis les trous : les suites de pas sans mesure ou sans température, avec les stations où elles manquent (un trou commun à plusieurs stations sur une seule ligne) ; puis la table par pas (une colonne STATION:colonne chacune, tabulations ; --table comme ensemble.py) ; puis, par colonne et par paire de stations, r des valeurs et r des pas d'une valeur à la suivante (un mouvement commun se voit sur les pas, une tendance commune sur les valeurs), avec n. PNG stations : un panneau par colonne, un trait par station (température brute, le reste moins sa médiane), et une bande par station des pas sans mesure. Prends --pas égal à la cadence la plus lente des stations ; sur un mois à 1h, lis d'abord avec --table non. Regarde-le avec Read
python3 tools/scripts/qualite.py <dossier> [--calme T1/T2,T3/T4] [--commun] [--table M] [--pas 15min] [--seuil 0.5] [--capteurs A,B] [--debut T] [--fin T] ; ... --etiquettes F [--numeros 3,7] [--marge 60] [--bords] ; ... --etiquettes F --hors [--min 1] [--sauf "Thermal displacement"] ; .venv/bin/python tools/scripts/qualite.py <dossier> --figure [--metriques flux,snr,dominance] [--etiquettes F] [--zone T1/T2 ...] [--sortie D] ; python3 tools/scripts/qualite.py --essai Les six métriques de qualité d'image (peak, flux, sharpness, fwhm, dominance, snr ; définitions : labeling/connaissances/metriques-de-qualite.md), sur les stations qui les ont (sinon : « Aucune métrique de qualité », et rien d'autre). Chaque mesure devient un rapport à la référence calme de son capteur : la médiane de la métrique sur ses mesures des fenêtres --calme, à la même heure UTC du jour (sans --calme : tout le dossier) ; 1 = comme la référence, < 1 plus bas, > 1 plus haut ; pour fwhm et dominance, c'est la hausse qui dit une image dégradée ; mesures rejetées comprises. Sans option : le peak maximal du dossier, puis par capteur (r = référence) les mesures rejetées, pk/max (peak médian sur la fenêtre divisé par ce maximum : à 1, la tache touche le plafond de l'image, son peak ne bouge plus et sa sharpness suit l'exposition : lis plutôt flux, snr), et pour chaque métrique le rapport médian et l'extrême avec son instant ; puis la médiane des cibles et des références. --commun : par pas, la médiane des rapports des cibles / des références pour chaque métrique (ce qui touche toute la scène, visibilité ou turbulence ; --pas 1d pour voir en un écran sur quels jours la référence tient). --table M : par pas, le rapport de M de chaque capteur (* : une mesure rejetée), leur médiane et combien passent --seuil (sous, ou au-dessus de 1/--seuil pour fwhm, dominance) : une cible qui s'éteint et revient. --etiquettes F (un JSON par ligne, debut, fin, categorie) : par étiquette numérotée, le rapport médian des cibles et des références sur l'heure d'avant, la plage et l'heure d'après (cib 0.96|0.26|0.79, --marge minutes), puis les capteurs touchés sur la plage (flux ou snr sous --seuil, ou dominance au-dessus de 1/--seuil), avec leur pire flux, du plus bas au plus haut ; --bords : par instant de la plage élargie, le nombre de capteurs touchés et la médiane des cibles de flux, snr, dominance (< dans la plage), pour dater le premier et le dernier instant dégradé. --hors : les suites d'instants qu'aucune étiquette ne couvre (hors familles --sauf) où au moins --min capteurs sont touchés, avec les capteurs et leur pire flux : des candidats aux étiquettes oubliées, à vérifier sur corr_x, corr_y. --figure (au lieu des tables) : PNG qualite-commun (un panneau par métrique, échelle log : médiane des cibles en noir, des références en rouge, bande grise du 10e au 90e centile des cibles : une gêne de toute la scène déplace la médiane, une occultation de quelques cibles ne déplace que le bas de la bande) et un PNG qualite-<métrique> par --metriques (un petit graphique par capteur, références en rouge) ; --etiquettes y grise chaque étiquette d'une couleur par famille, --zone des plages. Regarde les PNG avec Read
.venv/bin/python tools/scripts/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--contraste [MIN,MAX]] [--fixe] [--zone X,Y,L,H] [--sortie D] Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (x, y) du capteur à chaque heure (le centre du cadre est écrit sous chaque vignette : quand x, y sautent, le cadre se déplace d'autant, et une tache qui entre dans le cadre semble apparaître) ; --fixe garde pour chaque capteur le cadre de la première heure et marque d'une croix rouge les x, y de chaque heure ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre ; imprime pour chaque vignette le fond (médiane), le 99e centile et le pic (niveaux de gris 0 à 255) ; sans image à l'heure demandée, prend la plus proche et imprime l'écart (l'heure réelle est dans le titre). Une tache faible ou déformée est invisible telle quelle : --contraste MIN,MAX met toutes les vignettes en gris avec le même étirement (sans valeur : du 1er centile au maximum de la planche, écrasé par un pixel saturé ; choisis alors MIN,MAX d'après le fond et le pic imprimés, ex. 10,40), --rayon 30 à 50 grossit ; compare la forme et le pic avant, pendant et après un épisode, à la même heure de la journée. Regarde-la avec Read : une image entière lue par Read est réduite, un petit réflecteur y devient illisible. Un cadre que le bord de l'image coupe est signalé (« cadre coupé par le bord de l'image (L × H px) ») : sur certaines stations, x, y ne sont pas des pixels (valeurs proches de 0) et le cadre tombe dans le coin ; regarde alors la scène par --zone. --zone X,Y,L,H (pixels de l'image d'origine : coin haut gauche, largeur, hauteur, comme gif.py) : la même zone à chaque heure, côte à côte (jusqu'à 4 par ligne), même étirement avec --contraste ; --capteurs devient facultatif, et ceux qui sont donnés sont marqués d'une croix et de leur nom. Pour la scène autour des cibles (objet au premier plan, phares, éclairage), préfère-la à un grand --rayon. Chaque vignette est rendue un pixel pour un pixel jusqu'à 1000 px de côté, mais Read réduit un PNG large : avec un grand --rayon ou une grande --zone, trois ou quatre heures par planche
.venv/bin/python tools/scripts/gif.py <dossier> --debut T --fin T [--largeur 720] [--duree 700] [--max 150] [--zone X,Y,L,H] [--sortie D] Un GIF des images de la caméra entre --debut et --fin inclus, recadrées au besoin sur --zone, mises à --largeur px, date et heure UTC écrites en bas à droite ; au-delà de --max images, --max à intervalle régulier ; imprime l'heure de chaque image, puis le chemin et la taille du GIF. Sert à joindre la scène à une réponse au client ; Read ne lit pas un GIF : pour regarder, vignettes.py --zone
ls <dossier>/images/ | grep <AAAAMMJJ>T<HHMM>Z, puis Read sur le fichier trouvé (Read ne prend pas de motif) L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo)

--sortie <dossier> : là où celui qui t'appelle range tes figures ; il te le donne.

Conventions

  • Instants : 2026-01-01T00:00Z ; une heure sans fuseau est lue en UTC ; --fin inclut la minute indiquée. Sur un lot, --debut et --fin du lot.
  • Bash ne sert qu'à lancer ces outils, ls, grep et date, une commande par appel, sans boucle for (un tube vers grep est permis) : les permissions sont accordées commande par commande. Si le répertoire courant n'est pas la racine du dépôt, cd <racine> && <commande> compte pour une commande. N'écris aucun autre script. Celui qui t'appelle peut ajouter des commandes à cette liste.
  • Une sortie trop longue pour un appel (au-delà de quelques centaines de lignes, coupée à l'affichage) : raccourcis-la d'abord par les options de l'outil (--table non puis --table T1/T2, --min-mesures, --capteurs, --colonnes, une fenêtre plus courte), ou lis-en une section par un tube vers grep (| grep -A40 '^Titre', | grep '^pose_tilt '). Si tu dois la relire plusieurs fois, range-la dans le dossier de sortie dans le même appel (<commande> > <sortie>/<nom>.txt) et lis ce fichier par Read (offset, limit) ou par grep : pas de head, tail, sed, cut. Les outils créent eux-mêmes leur dossier de sortie : pas de mkdir.
  • Un nom de capteur qui porte une apostrophe (COLH20''', REFP''21) se met entre guillemets doubles dans le shell : --capteurs "COLH20'''",COLI22.
  • Chaque PNG se regarde avec Read : un PNG que tu n'as pas regardé n'a rien montré.
  • Métriques de qualité d'image (qualite.py) : elles disent pourquoi une mesure se dégrade, là où error_value dit seulement qu'elle se dégrade ; elles prouvent une cause et nomment les cibles touchées. Ce qu'elles ont montré sur LENZSPITZE (à confirmer sur chaque station) : flux coupé (près de 0) sur un groupe de cibles, les autres intactes, le temps d'une à quelques mesures : ces cibles sont cachées (la liste se lit sur le flux à chaque fois, pas sur la liste habituelle ; une cible cachée peut rester sous son seuil d'erreur, et son point est faux) ; flux en baisse sur toute la scène, plus fort sur les cibles lointaines : visibilité réduite ; sharpness en baisse et dominance en hausse, flux entier : l'image tremble (turbulence) ; rien ne bouge : ni l'image ni la vue, à chercher dans le mouvement. Un flux entier dément une occultation. fwhm, tronquée au disque, bouge peu ; sur une tache au plafond (pk/max à 1), elle baisse quand la tache s'assombrit. La référence calme décide de tout : prends --calme sur des heures calmes du même régime de l'image que la plage lue. Quand l'éclairage ou l'exposition change (après un trou, une intervention), une référence de l'autre côté fausse les rapports d'un facteur deux ou trois : --commun --pas 1d sur le lot montre ce changement (médianes des cibles et des références loin de 1 des jours entiers, puis à 1) ; prends alors une référence de chaque côté et lis chaque côté avec la sienne. Les jours calmes sont souvent des jours de cycle thermique : une lecture du thermique contre eux est circulaire.
  • Une mesure rejetée (error_value au-dessus du seuil) n'est pas une mesure : la station vide les corr d'une cible rejetée, mais laisse ceux d'une référence rejetée, souvent absurdes ; les outils les vident (corr, plages, résidus, sauts ne portent que sur les mesures acceptées). Quand la compensation ne retient que deux références, leur corr vaut 0 (à 1e-13 près) : elle passe exactement par elles ; leur bruit s'imprime 0 et leurs écarts en bruits « - » ; ne lis rien dans ces valeurs, lis les références par x, y (ensemble.py --rigide) et error_value. Ses x, y restent : avant de citer un saut de x, y, regarde s'il est marqué (rejetée) ; une mesure rejetée ne se cite pas comme un mouvement.

La méthode

  1. Inventaire : ce qui est disponible, ce qui manque (fichiers, ce que contient chaque source, images, poses de la caméra, période, cadence, capteurs). Une colonne remplie que les outils ne montrent pas ou une source qu'aucun outil ne lit (images_diff/) reste une donnée : sache qu'elle existe. Les six colonnes de qualité d'image (peak à snr), remplies sur les caméras récentes, se lisent par qualite.py. metrics/ se lit par metriques.py : une coupure des mesures se lit face aux pas sans métrique et à la tension (--noms BusVoltage,BusCurrent,Power,BatteryPercent --metriques-seules sur la coupure) ; des métriques toutes vides (« vide » sur chaque nom) sont une donnée absente, pas une température stable. Sur un lot, relance-le avec --debut/--fin du lot : les pas absents et les rejets du lot, datés ; ceux de la période entière ne disent rien du lot. Lis les rejets des références autant que ceux des cibles : un capteur rejeté aux mêmes heures chaque jour fait un moment à lui seul (dis sa part de mesures rejetées et ses heures, jour par jour) ; quand c'est une référence, dis avec combien de références la compensation tourne alors (la liste des références retenues). Quand plusieurs cibles sautent ensemble d'un pas, ou que la compensation tombe (pas de pose), regarde d'abord dans cette liste quelles références ont été perdues à cet instant.
  2. Large d'abord : ensemble.py sur le lot, d'abord (sur un lot de plus de quelques jours, avec --table non, puis --table T1/T2 sur les jours à lire) ; la pose de la caméra en premier (panneaux du haut, colonnes cam_ de la table) : quand la caméra tourne (pan, tilt, rotation), change d'échelle (scale), quand son recalage se dégrade (sigma0) et quand elle n'est pas recalée (trait coupé, instants sans pose), datés au pas natif ; chaque moment des capteurs se lit ensuite face à elle : pendant un mouvement ou un trou de recalage, ou caméra immobile. La pose est calculée à partir des références globales : un changement de pose (ou une montée de sigma0) ne se lit comme un mouvement de la caméra que si les cibles bougent aussi dans l'image ; regarde, sur les panneaux x, y, les traits des références face au trait noir des cibles seules (et la colonne x_cibles, y_cibles de la table). Si seules des références bougent dans l'image et que les cibles restent immobiles, ce sont ces références qui ont bougé : la pose et les corr de toutes les cibles en sont faussés, sans mouvement brut des cibles ; dis quelles références et de combien. Si tout bouge ensemble, références et cibles, c'est la caméra ou la scène ; regarde alors si les corr reviennent. Dès que la pose tourne ou change d'échelle, l'écart à la médiane ne dit plus qui bouge seul (chaque capteur s'en écarte selon sa place dans l'image) : avant d'écrire « tout bouge ensemble », relance avec --rigide BASE, BASE un instant calme avant le premier mouvement, et lis le PNG rigide et sa table : une référence dont le résidu reste loin du 10e-90e centile des cibles, ou un reproj_err des références qui ne revient pas, veut dire que la compensation reste faussée par ces références et que les paliers de corr en viennent en partie ; dis lesquelles, de combien, jusqu'à quand ; un |résidu| des cibles qui monte dit qu'elles ne bougent pas comme un bloc. Puis la médiane de x, y (position brute, références comprises), les références une à une, les cibles seules et sigma0 disent ce qui bouge dans l'image, avant de lire corr ; lis la table imprimée (heure, valeur) pour dater le début, la fin et le retour du mouvement et pour voir un niveau qui ne revient pas, et ne les devine pas sur l'axe du PNG : un creux de corr qui suit un mouvement de la médiane brute est le reste de la compensation, pas un mouvement propre des capteurs touchés ; les petits multiples d'error_value montrent un palier durable d'un capteur, le compte les instants où beaucoup de capteurs montent ensemble. Sur tout lot, sans attendre un soupçon, regarde les PNG residus (corr_x, corr_y, error_value) : chaque capteur face à son propre niveau, c'est là que se voient un capteur seul qui monte ou descend, un corr qui dérive de quelques centièmes, un palier propre à un capteur sous un mouvement commun ; la table dit de combien (en bruits) et quand. Pour séparer, sur une cible dont corr baisse sous un mouvement commun fort, un reste de compensation d'un mouvement propre, relance avec --autres (le reste partagé disparaît, la pente sur x, y commun dit s'il est proportionnel). Sur un lot de plus de deux jours, lance ensuite jours.py (avant de lire les pas isolés de plages.py) : ce qui revient chaque jour à la même heure se lit d'abord sur ses PNG parheure et sa table par créneau, et fait un moment par heure du jour (dis quels capteurs, combien de jours sur combien, l'ampleur, ce que fait la pose de la caméra à cette heure-là), pas un moment par jour ni rien du tout parce que chaque pas est court ; puis lis sa table des niveaux de nuit, pour tout capteur qui a déjà fait un palier ou dont --hors ne suffit pas (plusieurs niveaux dans le lot) : chaque marche d'une nuit à l'autre se date par son « entre A et B », et une marche d'error_value et une de corr au même instant se relient ; une dérive lente se lit d'une nuit à l'autre. Pour ce qui revient chaque jour et s'étiquette jour par jour (cycle thermique, réchauffement et refroidissement), relance jours.py --bornes plutôt que de fixer les mêmes heures pour tous les jours : chaque jour se date sur sa ligne, la suite autour de l'extrême pour le cycle, le max et le min pour un aller et un retour (le matin et l'après-midi) ; les mesures « avant » et « après » donnent les bornes au pas natif (à une cadence de 1 h ou de 4 h, un événement va de la mesure d'avant à celle d'après). Prends --nuit sur des heures où la pose et error_value sont retombées (figure parheure) : si le premier dépassement tombe au début du jour (« avant - ») et le dernier à sa fin chaque jour, la nuit choisie n'est pas calme ; change --nuit ou passe à --capteurs pour les cibles qui portent le cycle. Quand la caméra dérive toute la nuit, prends une nuit courte juste avant le matin (--nuit 3-5 : le niveau est celui du repos qui précède le départ) ; sur une suite bruitée ou piquée de points isolés, ajoute --lissage 5 ; quand le seuil en bruits ne mord pas (jamais dépassé, ou dépassé tout le jour), --fraction 0.3 ; lis alors la suite autour de l'extrême, pas le premier et le dernier dépassement. Une ligne « 1 mesures » est un pic, pas un cycle. Quand celui qui t'appelle te donne plusieurs stations voisines, pose-les sur une même ligne de temps par stations.py (températures, poses, corr des cibles, rejets et trous communs, aux mêmes heures) avant de comparer leurs moments. Quand la pose ou les corr des cibles dérivent sur plusieurs jours, ou bougent sans cycle jour/nuit, lance metriques.py sur le lot : la température face à cib_corr_x, cib_corr_y et à la pose, sur le PNG, puis r et la pente ; sur une station où la température varie peu et vite (intérieur), relance avec --lissage 24h. Un r ne dit pas une cause : dis-le comme une valeur, avec la fenêtre où il est calculé. --pas 1d --stat min (ou max) donne le minimum ou le maximum de chaque jour. Sur une station qui a les métriques de qualité d'image, lance qualite.py --commun --pas 1d sur le lot (choix de la référence calme, voir Conventions), puis qualite.py --figure avec cette référence : la médiane du flux des cibles et des références date les heures de visibilité réduite, la bande grise qui plonge seule, les occultations ; avec un fichier d'étiquettes, --etiquettes F --hors donne les instants dégradés qu'aucune étiquette ne couvre. Puis graphique.py sur tous les capteurs, error_value puis corr_x, corr_y (ou relative_x, relative_y), références et cibles ; resume.py sur ces colonnes avec un pas large (6h ou 1d).
  3. Puis zoome : resume.py à 15min (--stat max pour le pic réel d'un capteur), et graphique.py sur les fenêtres et les capteurs qui bougent.
  4. Chaque capteur face à son propre niveau habituel (sa médiane et sa MAD), jamais à un seuil absolu ; sur un lot, le niveau se calcule sur le lot (--niveau fenetre, ensemble.py), pas sur la période entière.
  5. Chaque moment retenu se date et se mesure au pas natif de 15 min : début, fin et maximum lus sur la table à 15 min (ensemble.py par défaut, resume.py --pas 15min), jamais sur un tableau à l'heure ; lis aussi ensemble.py --min 1 pour les capteurs seuls, et plages.py sur le lot (d'abord avec --min-mesures 6) pour avoir, par capteur, début, fin, extrême et plus grand saut au pas natif (relance-le avec --hors autour d'un épisode long pour dater son retour au niveau, ne conclus pas « ne revient pas » sans l'avoir lu ; quand le lot a une dérive longue ou plusieurs paliers (les plages se comptent par centaines, ou une moitié du lot est « hors niveau »), relance-le avec --glissant (quelques mesures, ou une durée de quelques heures à un jour selon la cadence) et --instants 2 : les écarts brefs sous la dérive sortent seuls, et la liste par instant dit quels capteurs s'écartent ensemble, lesquels sont rejetés et ce que font les références à cet instant ; un écart de toutes les cibles avec les références au même instant se lit face à la pose de la caméra), et les tables de x, y sur les fenêtres où ils s'agitent. Sur une station qui a les métriques de qualité, pour chaque moment : qualite.py --table flux --capteurs … (ou --etiquettes F --numeros N --bords sur une étiquette) dit quelles cibles sont cachées (flux coupé) ou voilées, de quel instant à quel instant ; écris-les par leur nom.
  6. Les images : vignettes (avec --contraste pour une cible faible) espacées, une toutes les 2 à 3 h, plus serrées là où les courbes bougent, toujours avec un capteur témoin non touché, à une heure avant, pendant et après (à la même heure de la journée si possible) ; quand x, y d'un capteur sautent entre deux vignettes (centre du cadre écrit sous chacune), relance avec --fixe avant de dire qu'une tache apparaît ou disparaît ; l'image entière pour la scène (occultation, éclairage, météo).

Ce que la lecture rend

Une ligne par moment. Un moment : un capteur ou un groupe de capteurs qui sort de son niveau habituel pendant une fenêtre que tu peux dater.

Début Fin Capteurs Colonnes Ce que je vois Images
  • Capteurs : références ou cibles, combien, lesquels.
  • Ce que je vois : la forme (pic d'un pas, palier, montée lente, agitation), l'ampleur face au niveau habituel (en MAD ou en fois la médiane), le retour à la normale ou non, ce que font les autres capteurs, ce que fait la caméra au même moment (pose qui bouge, de combien, ou immobile ; recalage absent ; « pas de camera/ » si le dossier n'en a pas).
  • Images : ce que montrent les vignettes et l'image entière à ce moment, ou « pas d'image ».

Heures en UTC.