Files
Support-Agent/.claude/skills/lire-les-donnees/SKILL.md
T

8.5 KiB

name, description
name description
lire-les-donnees Lire un dossier de données de déplacement d'une station AIMsight, courbes et images, avec les outils de lecture — ce qu'ils rendent et comment s'en servir. Suivi par l'analyste (critiquer-lot), l'agent de diagnostic et le lecteur de /aiguiser ; amélioré par /aiguiser.

Lire les données

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 skill 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, cas connu, hypothèse et verdict sont l'affaire de celui qui t'appelle.

À lire d'abord

  • docs/domaine/colonnes-des-deplacements.md : formats des exports et sens des colonnes (en premier) ;
  • docs/domaine/pieges-des-donnees.md.

Les outils

Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges.

Commande Ce qu'elle rend
python3 agents/diagnostic/outils/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), images (heures couvertes), 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) et, par capteur, les mesures rejetées datées (suites de pas consécutifs)
python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median|min|max] [--pas 1h] [--niveau periode|fenetre] [--capteurs A,B] [--debut T] [--fin T] 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
.venv/bin/python agents/diagnostic/outils/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. Regarde-le avec Read : tu lis mieux un graphique qu'un tableau
.venv/bin/python agents/diagnostic/outils/ensemble.py <dossier> [--colonnes x,y,sigma0] [--colonne error_value] [--pas 1h] [--k 5] [--min 5] [--residus corr_x,corr_y,error_value] [--hors T1/T2] [--capteurs A,B] [--debut T] [--fin T] [--sortie D] Tous les capteurs ensemble, chacun face à sa médiane et sa MAD sur la fenêtre. Deux PNG : commun (médiane entre capteurs de x, y, sigma0 : ce que fait la caméra, avec la dispersion entre capteurs en bande grise ; et, à chaque pas, le nombre de capteurs dont --colonne dépasse sa médiane de plus de --k MAD) et multiples (un petit graphique par capteur, une échelle chacun : un palier d'un seul capteur s'y voit). Imprime aussi la table de la médiane commune (une ligne par pas de --pas : l'heure et l'écart à la médiane de la fenêtre de x, y, sigma0) avec le minimum et le maximum de chaque colonne et leur instant, puis les instants où au moins --min capteurs dépassent ensemble, avec leurs noms. Trois PNG de plus, residus-corr_x, residus-corr_y, residus-error_value (--residus) : un petit graphique par capteur de la colonne moins le niveau propre du capteur (sa médiane sur la fenêtre ; avec --hors T1/T2, celle du reste de la fenêtre, hors du moment lu), une échelle chacun, zéro en pointillé : un écart de quelques centièmes sur corr, caché dans les bandes parallèles de graphique.py, s'y voit ; imprime pour chaque capteur le niveau, le bruit propre (médiane des écarts entre deux mesures) et l'écart min/max par pas avec leur instant, en unités et en bruits. Les graduations du PNG « commun » sont toutes les 1 à 12 h selon la fenêtre. Pour dater un début, une fin ou un retour à 15 min près, relance sur la fenêtre utile avec --pas 15min. Regarde les PNG avec Read
.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--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 ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. Regarde-la avec Read : une image entière lue par Read est réduite, un petit réflecteur y devient illisible
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.
  • Chaque PNG se regarde avec Read : un PNG que tu n'as pas regardé n'a rien montré.

La méthode

  1. Inventaire : ce qui est disponible, ce qui manque (fichiers, images, période, cadence, capteurs). 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.
  2. Large d'abord : ensemble.py sur le lot, d'abord ; la médiane de x, y (position brute, références comprises) et sigma0 dit ce que la caméra fait, 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. 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 à 1h ou 15min, 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. Les images : vignettes 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) ; 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.
  • Images : ce que montrent les vignettes et l'image entière à ce moment, ou « pas d'image ».

Heures en UTC.