Make diagnostic reports short, evidence-backed and anomaly-only (D-047)
Reports become a folder with rapport.md and its figures: a verdict, one short section per anomaly (series plot with shaded window, full-resolution image crops around the sensors), constant behaviour in one line each. graphique.py gains --zone and --sortie; new vignettes.py crops images at the sensors' raw x/y. Old reports removed; the blind rescan of PS des Coudres finds the single anomaly flagged by the specialist (REF_G/REF_D). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4b937da95b
commit
2a39335fb5
12 files changed
+259
-253
No files matched your search
@@ -15,12 +15,12 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
|
||||
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
||||
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
||||
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues pour une station (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
|
||||
- **Agent de diagnostic (D-046)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport dans `agents/diagnostic/rapports/` ; déplacements et images seulement ; testé à l'aveugle sur PS des Coudres, deux rapports à valider. L'enquête par API (D-042) reste un document.
|
||||
- **Agent de diagnostic (D-046)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D`. L'enquête par API (D-042) reste un document.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : l'utilisateur valide les deux rapports de PS des Coudres (points à valider au §7 de sa spec : classification, effet sur les cibles, cycle de `corr_y`).
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) et voit avec le spécialiste si les pics de `REF_G` et `REF_D` biaisent la compensation (marche de `corr_x` de BJ_G).
|
||||
|
||||
## Analyses (domaine Energy)
|
||||
|
||||
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
### Fichiers
|
||||
|
||||
- `README.md` (40 l) : point d'entrée pour un humain.
|
||||
- `docs/decisions.md` (518 l, D-001 à D-046) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/decisions.md` (530 l, D-001 à D-047) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
@@ -122,7 +122,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
- `docs/temperature/` : domaine Temperature (D-040), sans matrice ; guide dans `guide/` (D-041). `domaine/point-de-depart.md` : zones thermiques, carte supposée (Jetson Nano) et ses limites, constats sur trois stations, pistes, questions au spécialiste ; fiche dans `analyses/`.
|
||||
- `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vit à part, dans `agents/`.
|
||||
- `docs/agents/enquete-a-la-demande.md` (233 l) : enquête à la demande sur un événement de mesure (D-042), même cadre ; harnais (§3), déroulé (§4), sortie et règle d'asymétrie (§5), étapes (§6), questions ouvertes (§9).
|
||||
- `docs/agents/agent-diagnostic.md` : spec de l'agent de diagnostic (D-046) ; code dans `agents/diagnostic/` (`instructions.md`, `outils/`, `rapports/`). Appel : `@agent-diagnostic data/<STATION>/ [question]`, (en terminal, `claude --agent diagnostic` charge `CLAUDE.md` : pas à l'aveugle).
|
||||
- `docs/agents/agent-diagnostic.md` : spec de l'agent de diagnostic (D-046, D-047) ; code dans `agents/diagnostic/` (`instructions.md`, `outils/`, `rapports/`, un dossier par rapport avec ses figures). Appel : `@agent-diagnostic data/<STATION>/ [question]`, (en terminal, `claude --agent diagnostic` charge `CLAUDE.md` : pas à l'aveugle).
|
||||
- `docs/displacement/cadrage.md` (156 l) : séries optiques (D-044) : événements externes et correction des courbes ; règles de correction (§3), chaîne en trois étapes (§4), données nécessaires (§5), étapes (§6), questions ouvertes (§7).
|
||||
- `docs/aimsight/` : documentation AIMsight d'origine, en anglais, non modifiée. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Agent de diagnostic
|
||||
|
||||
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère ce qui sort de l'ordinaire, l'explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
|
||||
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère les anomalies, les montre (graphiques, vignettes des images), les explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
|
||||
|
||||
## L'appeler
|
||||
|
||||
@@ -11,13 +11,13 @@ Un sous-agent Claude Code qui diagnostique les données d'une station : il repè
|
||||
|
||||
## Ce qu'il rend
|
||||
|
||||
Un rapport par diagnostic dans `rapports/` (sources lues, inventaire, un bloc par événement, constats permanents), et un résumé dans la conversation. La section « Validation » du rapport est à remplir : un rapport validé deviendra un cas.
|
||||
Un dossier par diagnostic dans `rapports/` : `rapport.md` (verdict, une section courte par anomalie avec ses figures, « Hors anomalie », annexe) et ses figures PNG ; un résumé dans la conversation. La section « Validation » du rapport est à remplir : un rapport validé deviendra un cas.
|
||||
|
||||
## Contenu du dossier
|
||||
|
||||
- `instructions.md` : sa méthode, ses règles et le format du rapport. C'est ici qu'on corrige son comportement.
|
||||
- `outils/` : `inventaire.py`, `resume.py`, `graphique.py` (et `donnees.py`, la lecture commune). Ils rendent des valeurs, pas des verdicts. Le graphique demande matplotlib (`.venv`).
|
||||
- `rapports/` : ses rapports.
|
||||
- `outils/` : `inventaire.py`, `resume.py`, `graphique.py`, `vignettes.py` (recadrage des images autour des capteurs), et `donnees.py`, la lecture commune. Ils rendent des valeurs, pas des verdicts. Le graphique et les vignettes demandent matplotlib (`.venv`).
|
||||
- `rapports/` : ses rapports, un dossier chacun.
|
||||
|
||||
## Limites
|
||||
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
# Instructions de l'agent de diagnostic
|
||||
|
||||
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves ce qui sort de l'ordinaire, tu l'expliques avec des preuves, et tu dis ce qui reste non établi. Tu ne modifies rien.
|
||||
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves les anomalies, tu les montres, tu les expliques avec des preuves et tu dis ce qui reste non établi, en peu de mots. Tu ne modifies rien.
|
||||
|
||||
## 1. La demande
|
||||
|
||||
Tu reçois un dossier de `data/` (ex. `data/PS_DES_COUDRES/`) et, parfois, une question.
|
||||
|
||||
- **Sans question : scan.** Trouve les événements de toute la période et explique chacun.
|
||||
- **Sans question : scan.** Trouve les anomalies de toute la période et explique chacune.
|
||||
- **Avec une question : enquête.** Concentre-toi sur la fenêtre et les capteurs concernés ; la période entière sert de référence.
|
||||
- Si le dossier n'existe pas ou ne contient aucun export « advanced », dis-le dans ta réponse et n'écris pas de rapport.
|
||||
|
||||
@@ -25,6 +25,7 @@ Pour un long fichier AIMsight, trouve la section avec `grep -n '^#' <fichier>`,
|
||||
|
||||
**Ne lis rien d'autre** : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les autres documents du projet, ni les rapports de `agents/diagnostic/rapports/`. Ils peuvent contenir des conclusions sur ces données ; ton diagnostic doit partir des données. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
|
||||
|
||||
## 3. Tes outils
|
||||
|
||||
Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges.
|
||||
@@ -33,74 +34,92 @@ Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdi
|
||||
|---|---|
|
||||
| `python3 agents/diagnostic/outils/inventaire.py <dossier>` | Fichiers par type, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) |
|
||||
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), 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]` | Un PNG des séries ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
||||
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image de la caméra à cette heure (UTC). Les colonnes `x` et `y` (pixels) situent chaque capteur sur l'image |
|
||||
| `.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/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/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) |
|
||||
|
||||
Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie <dossier du rapport>` (§6), ils deviennent des preuves du rapport.
|
||||
|
||||
Instants : `2026-01-01T00:00Z` (une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script.
|
||||
|
||||
## 4. Déroulé
|
||||
|
||||
Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
||||
|
||||
1. **Inventaire** (`inventaire.py`) : ce qui est disponible, ce qui manque, et ce que ce manque empêche de conclure (par exemple, sans métriques système, un arrêt de la station ne peut pas être écarté).
|
||||
2. **Repérage** : commence large, puis zoome.
|
||||
- `graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` avec un pas large (6h ou 1d), puis 1h ou 15min sur les fenêtres intéressantes ;
|
||||
- compare chaque capteur **à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu ;
|
||||
- un seuil de repérage (ex. « au-dessus de médiane + 6 MAD ») est un choix d'exploration : annonce-le, et ne t'en sers jamais comme critère de conclusion.
|
||||
3. **Faits**, pour chaque événement repéré :
|
||||
3. **Tri : anomalie ou non.**
|
||||
- Une **anomalie** : un capteur ou un groupe de capteurs sort de son propre comportement habituel pendant une fenêtre que tu peux dater.
|
||||
- Une même signature (mêmes capteurs, même forme), même répétée, est **une seule** anomalie : ses occurrences vont dans la même section.
|
||||
- **Pas une anomalie** : ce qui ne change pas de toute la période (un réglage, un capteur toujours rejeté, un cycle jour/nuit régulier) ; faute d'avant et d'après, on ne peut pas le comparer à un état normal. Une ligne en « Hors anomalie », sans hypothèses ni enquête. Un point isolé qui revient au pas suivant n'est pas non plus une anomalie à lui seul.
|
||||
- Classe les anomalies par importance : ampleur face au niveau habituel, nombre de capteurs, répétition, effet sur les déplacements corrigés. Une station saine en a peu, souvent aucune ; n'allonge pas la liste.
|
||||
4. **Faits**, pour chaque anomalie :
|
||||
- début, fin, durée ; capteurs touchés : cibles ou références, combien, lesquels, ensemble ou non ;
|
||||
- amplitude face au niveau habituel ; retour à la normale ;
|
||||
- déplacement associé (`corr_x`, `corr_y`) ou non ; mesures rejetées ;
|
||||
- images autour de l'instant, s'il y en a : regarde au moins une image pendant et une hors de l'événement, à la même heure de la journée si possible.
|
||||
4. **Hypothèses** : prends-les dans les familles de la section 12 du contexte support, plus le mouvement réel de l'ouvrage. Pour chacune, ce qui la soutient et ce qui la contredit.
|
||||
5. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ?
|
||||
6. **Rapport** (§6), puis ta réponse (§7).
|
||||
- images, s'il y en a : `vignettes.py` sur les capteurs touchés **et un capteur témoin non touché**, à une heure avant, pendant et après l'anomalie (à la même heure de la journée si possible) ; l'image entière pour la scène.
|
||||
5. **Hypothèses** : prends-les dans les familles de la section 12 du contexte support, plus le mouvement réel de l'ouvrage. Pour chacune, ce qui la soutient et ce qui la contredit.
|
||||
6. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ?
|
||||
7. **Preuves** : pour chaque anomalie, refais les figures qui la montrent, cette fois avec `--sortie` vers le dossier du rapport (§6) :
|
||||
- un graphique de la série qui la montre le mieux, sur une fenêtre qui laisse voir le niveau habituel autour, l'anomalie grisée (`--zone`), avec au moins un capteur non touché pour comparer ;
|
||||
- la planche de vignettes, s'il y a des images pendant l'anomalie ;
|
||||
- deux ou trois figures au plus par anomalie. Regarde chacune (Read) : une figure qui ne montre pas clairement le constat ne va pas dans le rapport.
|
||||
8. **Rapport** (§6), puis ta réponse (§7).
|
||||
|
||||
## 5. Règles
|
||||
|
||||
- Vocabulaire de preuve, et seulement lui : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`. Pas de pourcentage de confiance.
|
||||
- Sépare fait observé (lu dans les données), fait dérivé (calculé), contexte donné par l'utilisateur, hypothèse et inconnu.
|
||||
- Aucun chiffre ni seuil sans source : chaque fait cite la commande qui l'a produit.
|
||||
- Aucun chiffre ni seuil sans source : chaque fait du rapport a sa commande, dans le bloc « Commandes » de son anomalie.
|
||||
- Ne construis rien sur `inlier` (binaire). `sigma0` ne suffit jamais seul. Un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage. Une référence cohérente n'est pas forcément fixe.
|
||||
- Un trou n'est pas forcément une coupure : acquisition, traitement, transport et affichage sont des couches distinctes.
|
||||
- Toute heure est en UTC.
|
||||
- « Rien d'anormal » est une conclusion valable.
|
||||
- Lecture seule : tu n'écris que ton rapport.
|
||||
- **Écris court.** Des phrases simples ; des chiffres arrondis (deux chiffres significatifs) ; pas de valeurs pas à pas, la figure les montre. Le corps du rapport (jusqu'à « Hors anomalie » compris) tient en 40 lignes environ, figures comprises.
|
||||
- Lecture seule : tu n'écris que ton rapport et ses figures.
|
||||
- Rapport en français ; termes AIMsight en anglais (classifications, noms de colonnes).
|
||||
|
||||
## 6. Le rapport
|
||||
|
||||
Écris-le dans `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>.md` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJTHHMMZ>_<STATION>_<sujet>.md`. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon.
|
||||
Un dossier par rapport : `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>/` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJTHHMMZ>_<STATION>_<sujet>/`. Le rapport s'y écrit dans `rapport.md`, à côté de ses figures (`--sortie` vers ce dossier) ; il les cite par leur nom de fichier. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon.
|
||||
|
||||
```markdown
|
||||
# Diagnostic <STATION> : <scan | sujet de la question>
|
||||
# <STATION> : <scan | sujet de la question>
|
||||
|
||||
- **Date du diagnostic** : AAAA-MM-JJ (UTC)
|
||||
- **Données** : <dossier> ; mesures du <début> au <fin> (UTC)
|
||||
- **Demande** : scan | « <question> »
|
||||
- **Modèle** : <ton modèle>
|
||||
<dossier> ; mesures du <début> au <fin> (UTC) · <scan | « question »> · <ton modèle> · diagnostic du AAAA-MM-JJ
|
||||
|
||||
## Sources lues
|
||||
- <chaque document et fichier ouvert>
|
||||
## Verdict
|
||||
<2-3 phrases : la station fonctionne-t-elle normalement ? Les anomalies, par importance, une ligne chacune. Ou : aucune anomalie.>
|
||||
|
||||
## Inventaire
|
||||
- **Disponible** : …
|
||||
- **Manquant** : … ; ce que ça empêche de conclure : …
|
||||
## A1 : <titre court> (<début> → <fin> UTC ; <occurrences s'il y en a plusieurs>)
|
||||
<Constat, 2-3 phrases : quels capteurs, combien de fois leur niveau habituel, combien de temps, retour à la normale ou non ; ce que font les autres capteurs.>
|
||||
|
||||
## Événements
|
||||

|
||||
*<Légende, une ligne : ce qu'il faut y voir.>*
|
||||
|
||||
### E1 : <titre court> (<début> → <fin> UTC)
|
||||
- **Classification** : la principale (une seconde si elle s'applique aussi), parmi : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, rien d'anormal, indéterminé
|
||||
- **Cause probable** : buée ou eau | occlusion | turbulence | éclairage | inconnue (seulement pour une cause externe à l'ouvrage)
|
||||
- **Couche** : la couche de la chaîne de dépendance (section 4 du contexte support)
|
||||
- **Niveau de preuve** : …
|
||||
- **Preuves** :
|
||||
- <fait> (observé | dérivé) : `<commande>`
|
||||
- **Réfutation** : hypothèse principale ; fait cherché pour la contredire ; résultat (`<commande>`)
|
||||
- **Alternatives** : autres explications, et pourquoi elles ne sont pas écartées
|
||||
- **Inconnus** : …
|
||||
- **Prochaine vérification** : la plus discriminante : une donnée à obtenir ou une observation à faire par un humain ; pas de nouveau réglage chiffré (seuil) sans source
|
||||

|
||||
*<Légende, une ligne.>* (Ou, sans image pendant l'anomalie : « Pas d'image pendant l'anomalie. »)
|
||||
|
||||
## Constats permanents
|
||||
- <ce qui dure toute la période, ex. un capteur toujours rejeté>
|
||||
- **Classification** : <la principale, parmi : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, indéterminé> · **Niveau de preuve** : … · **Cause probable** : <buée ou eau | occlusion | turbulence | éclairage | inconnue>
|
||||
- **Réfutation** : <le fait cherché pour contredire l'hypothèse principale> → <ce que tu as trouvé>
|
||||
- **Non établi** : <le principal inconnu, et les alternatives non écartées> ; **à vérifier** : <la vérification la plus discriminante, par un humain ou une donnée à obtenir ; pas de nouveau réglage chiffré sans source>
|
||||
|
||||
<details><summary>Commandes</summary>
|
||||
|
||||
- <fait> (observé | dérivé) : `<commande>`
|
||||
|
||||
</details>
|
||||
|
||||
## Hors anomalie
|
||||
- <une ligne par point, trois au plus : ce qui dure toute la période ou relève du fonctionnement normal>
|
||||
|
||||
## Annexe
|
||||
- **Sources lues** : <chaque document et fichier ouvert ; le contexte fourni par l'environnement sans que tu l'aies ouvert>
|
||||
- **Données** : <disponible> ; **manquant** : <…> ; ce que ça empêche de conclure : <…>
|
||||
- **Seuil de repérage** : <celui que tu as utilisé>
|
||||
|
||||
## Validation (à remplir par l'utilisateur)
|
||||
- **Verdict** : accepté tel quel | corrigé
|
||||
@@ -108,6 +127,8 @@ Instants : `2026-01-01T00:00Z` (une heure sans fuseau est lue en UTC ; `--fin` i
|
||||
- **Diagnostic final** :
|
||||
```
|
||||
|
||||
Sans anomalie : le verdict le dit, et il n'y a pas de section A1.
|
||||
|
||||
## 7. Ta réponse
|
||||
|
||||
Après avoir écrit le rapport, réponds en 5 à 10 lignes : les événements trouvés (classification, niveau de preuve), les constats permanents, le principal inconnu, et le chemin du rapport.
|
||||
Après avoir écrit le rapport, réponds en 3 à 5 lignes : le verdict, les anomalies (classification, niveau de preuve), le chemin du rapport.
|
||||
@@ -2,7 +2,9 @@
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/
|
||||
[--capteurs CAPTEUR_A,CAPTEUR_B] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
|
||||
Un panneau par colonne, une courbe par capteur, heures UTC. Imprime le chemin du PNG (out/diagnostic/).
|
||||
[--zone DEBUT/FIN ...] [--sortie DOSSIER]
|
||||
Un panneau par colonne, une courbe par capteur, heures UTC ; chaque --zone est grisée.
|
||||
Imprime le chemin du PNG (out/diagnostic/, ou --sortie : le dossier du rapport, pour une figure de preuve).
|
||||
"""
|
||||
import argparse
|
||||
import os
|
||||
@@ -20,6 +22,14 @@ RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)
|
||||
COLONNES = ("error_value", "corr_x", "corr_y", "relative_x", "relative_y", "x", "y", "sigma0", "reproj_err")
|
||||
|
||||
|
||||
def zone(texte):
|
||||
"""'2026-10-13T01:00Z/2026-10-13T03:00Z' -> (début, fin)."""
|
||||
debut, sep, fin = texte.partition("/")
|
||||
if not sep:
|
||||
raise argparse.ArgumentTypeError(f"zone invalide : {texte!r} (ex. 2026-10-13T01:00Z/2026-10-13T03:00Z)")
|
||||
return instant(debut), instant(fin)
|
||||
|
||||
|
||||
def borne(t, defaut):
|
||||
return t.strftime("%Y%m%dT%H%MZ") if t else defaut
|
||||
|
||||
@@ -31,6 +41,8 @@ def main():
|
||||
a.add_argument("--colonnes", default="error_value,corr_x,corr_y")
|
||||
a.add_argument("--debut", type=instant)
|
||||
a.add_argument("--fin", type=instant)
|
||||
a.add_argument("--zone", type=zone, action="append", default=[], help="fenêtre à griser, DEBUT/FIN (répétable)")
|
||||
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du PNG")
|
||||
o = a.parse_args()
|
||||
|
||||
par = charger(o.dossier)
|
||||
@@ -59,6 +71,8 @@ def main():
|
||||
ms = series[s] # une valeur vide devient NaN : la courbe s'interrompt au lieu de relier le trou
|
||||
ax.plot([m["t"] for m in ms], [float("nan") if m[col] is None else m[col] for m in ms], ".-", ms=2, lw=0.7,
|
||||
color=couleurs[i % len(couleurs)], label=s)
|
||||
for debut, fin in o.zone:
|
||||
ax.axvspan(debut, fin, color="0.85", zorder=0)
|
||||
ax.set_ylabel(col)
|
||||
ax.grid(alpha=0.3)
|
||||
axes[0, 0].legend(loc="upper left", bbox_to_anchor=(1.0, 1.0), fontsize=8)
|
||||
@@ -66,10 +80,9 @@ def main():
|
||||
station = os.path.basename(os.path.normpath(o.dossier))
|
||||
fig.suptitle(f"{station} : {', '.join(colonnes)} (heures UTC)")
|
||||
|
||||
dossier_sortie = os.path.join(RACINE, "out", "diagnostic")
|
||||
os.makedirs(dossier_sortie, exist_ok=True)
|
||||
os.makedirs(o.sortie, exist_ok=True)
|
||||
qui = "-".join(noms) if o.capteurs else "tous"
|
||||
sortie = os.path.join(dossier_sortie, f"{station}_{'-'.join(colonnes)}_{qui}_"
|
||||
sortie = os.path.join(o.sortie, f"{station}_{'-'.join(colonnes)}_{qui}_"
|
||||
f"{borne(o.debut, 'debut')}_{borne(o.fin, 'fin')}.png")
|
||||
fig.savefig(sortie, dpi=100, bbox_inches="tight")
|
||||
print(sortie)
|
||||
|
||||
@@ -0,0 +1,68 @@
|
||||
"""Vignettes des images de la caméra autour de capteurs, à pleine résolution, pour l'agent de diagnostic.
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/vignettes.py data/PS_DES_COUDRES/
|
||||
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--sortie DOSSIER]
|
||||
Une ligne par capteur, une colonne par heure. Chaque vignette est centrée sur la position brute (x, y) du capteur
|
||||
dans l'export « advanced », lue à la mesure la plus proche de l'image ; les pixels ne sont pas retouchés, l'éclat
|
||||
se compare donc d'une vignette à l'autre. Imprime les positions utilisées, puis le chemin du PNG.
|
||||
"""
|
||||
import argparse
|
||||
import os
|
||||
import sys
|
||||
|
||||
import matplotlib
|
||||
|
||||
matplotlib.use("Agg")
|
||||
import matplotlib.pyplot as plt # noqa: E402
|
||||
|
||||
from donnees import charger, heure_image, instant, iso, trouver # noqa: E402
|
||||
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", ".."))
|
||||
|
||||
|
||||
def main():
|
||||
a = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
||||
a.add_argument("dossier")
|
||||
a.add_argument("--capteurs", required=True, help="liste séparée par des virgules")
|
||||
a.add_argument("--heures", required=True, help="heures des images, séparées par des virgules (UTC)")
|
||||
a.add_argument("--rayon", type=int, default=100, help="demi-côté de la vignette en pixels (défaut 100)")
|
||||
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du PNG")
|
||||
o = a.parse_args()
|
||||
|
||||
par = charger(o.dossier)
|
||||
images = {heure_image(p): p for p in trouver(o.dossier)["images"]}
|
||||
noms, heures = o.capteurs.split(","), [instant(h) for h in o.heures.split(",")]
|
||||
absents = [s for s in noms if s not in par]
|
||||
if absents:
|
||||
sys.exit(f"Capteurs inconnus : {', '.join(absents)}. Connus : {', '.join(sorted(par))}.")
|
||||
sans_image = [iso(h) for h in heures if h not in images]
|
||||
if sans_image:
|
||||
connues = sorted(h for h in images if h)
|
||||
sys.exit(f"Pas d'image à {', '.join(sans_image)}. Images : {len(connues)}, "
|
||||
f"de {iso(connues[0])} à {iso(connues[-1])}." if connues else f"Aucune image dans {o.dossier}.")
|
||||
|
||||
r = o.rayon
|
||||
fig, axes = plt.subplots(len(noms), len(heures), figsize=(2.6 * len(heures), 2.8 * len(noms)), squeeze=False)
|
||||
for j, h in enumerate(heures):
|
||||
img = plt.imread(images[h])
|
||||
for i, s in enumerate(noms):
|
||||
m = min((m for m in par[s] if m["x"] is not None), key=lambda m: abs(m["t"] - h))
|
||||
x, y = round(m["x"]), round(m["y"])
|
||||
print(f"{s} {iso(h)} : x={m['x']:.1f} y={m['y']:.1f} (mesure de {iso(m['t'])}), {os.path.basename(images[h])}")
|
||||
ax = axes[i, j]
|
||||
ax.imshow(img[max(y - r, 0):y + r, max(x - r, 0):x + r], interpolation="nearest")
|
||||
ax.set_title(f"{s} {h.strftime('%d/%m %H:%MZ')}", fontsize=9)
|
||||
ax.set_xticks([])
|
||||
ax.set_yticks([])
|
||||
station = os.path.basename(os.path.normpath(o.dossier))
|
||||
fig.suptitle(f"{station} : vignettes de {2 * r} px autour de chaque capteur (heures UTC)", fontsize=10)
|
||||
|
||||
os.makedirs(o.sortie, exist_ok=True)
|
||||
sortie = os.path.join(o.sortie, f"{station}_vignettes_{'-'.join(noms)}_"
|
||||
f"{'-'.join(h.strftime('%d%H%M') for h in heures)}.png")
|
||||
fig.savefig(sortie, dpi=100, bbox_inches="tight")
|
||||
print(sortie)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
BIN
Binary file not shown.
|
After Width: | Height: | Size: 227 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 116 KiB |
@@ -0,0 +1,47 @@
|
||||
# PS_DES_COUDRES : scan
|
||||
|
||||
data/PS_DES_COUDRES/ ; mesures du 2026-10-08T22:00Z au 2026-10-14T09:45Z (UTC) · scan · Claude Opus 5.5 · diagnostic du 2026-10-14
|
||||
|
||||
## Verdict
|
||||
La station mesure sans interruption (525 instants, aucune mesure rejetée hors PM_G). Une seule anomalie, deux nuits de suite : deux des trois références (REF_G, REF_D) se dégradent la nuit, la compensation se déforme et les déplacements corrigés de plusieurs cibles font des sauts qui reviennent quand les références se rétablissent.
|
||||
|
||||
## A1 : dégradation nocturne de REF_G et REF_D, la compensation suit (2026-10-13T01:15Z → 04:00Z ; 2026-10-13T23:45Z → 2026-10-14T05:00Z)
|
||||
L'`error_value` de REF_G passe de 0,084 (médiane, MAD 0,010) à 0,55-0,67, soit environ 45 à 55 MAD, en un pas ; celle de REF_D monte de 0,13 à 0,42 puis 0,69, juste sous son seuil de 0,7 : rien n'est rejeté, les deux références dégradées restent dans la solution. REF_CT et les cibles ne changent pas. Pendant ce temps, la position relative de REF_G se décale (`relative_x` −0,11 à −0,2, 2 à 3 MAD), `sigma0` monte jusqu'à 0,0054 (médiane 0,0038, environ 6 MAD) et le `corr_x` de REF_CT, un résidu d'habitude stable, fait un saut d'environ 9 MAD. Les cibles sautent au même pas que REF_G, dans les deux sens : BJ_G jusqu'à 0,34 (4 MAD), PBJ_C 0,25 (3 MAD). Les signes varient d'une cible à l'autre. Tout revient au niveau habituel vers 04:00Z, puis vers 05:30Z.
|
||||
|
||||

|
||||
*Dans les zones grisées : REF_G (bleu) et REF_D (orange) montent en `error_value`, le `relative_x` de REF_G se décale, et BJ_G et PBJ_C sautent en `corr_x` au même pas que REF_G, à la montée comme au retour.*
|
||||
|
||||

|
||||
*À 02:00Z, la tache de REF_G et celle de REF_D sont nettement plus petites et plus faibles. À 04:00Z, REF_G est rétablie et REF_D encore faible. REF_CT et BL_D (témoins) ne changent pas. Aucune image pour la première nuit (les images commencent le 13/10 à 12:00Z).*
|
||||
|
||||
- **Classification** : *camera/reference compensation event*, déclenché par une dégradation locale de deux références · **Niveau de preuve** : strongly supported · **Cause probable** : buée ou eau (consistent with : seulement la nuit, deux nuits de suite, seulement les deux références posées sur trépied à l'extérieur, d'après les vignettes de jour)
|
||||
- **Réfutation** : on a cherché un vrai mouvement, de l'ouvrage ou de la caméra, au moment des sauts → not observed. Le `relative_x` de REF_CT et celui de BL_D ne bougent pas aux transitions (01:00 → 01:15Z : −2,73 → −2,70 et −2,61 → −2,60). Les sauts s'inversent quand REF_G se rétablit (02:45Z, puis 03:45Z). Les cibles ne bougent pas toutes dans le même sens.
|
||||
- **Non établi** : la cause physique. Les deux références peuvent être couvertes de rosée, mais le hublot de la caméra peut aussi s'embuer sur les bords de l'image (REF_G à gauche, REF_D à droite), ou du givre se former : ces trois pistes restent ouvertes, faute de flux ou de SNR dans l'export « advanced ». L'ampleur en mm reste inconnue : l'unité de `corr_x`/`corr_y` n'est pas établie. **À vérifier** : regarder REF_G, REF_D et le hublot à l'aube, et confronter les deux nuits à l'humidité et au point de rosée du site. Les déplacements de ces deux fenêtres sont à signaler comme non fiables.
|
||||
|
||||
<details><summary>Commandes</summary>
|
||||
|
||||
- Niveaux habituels, montée de REF_G et REF_D, REF_CT stable (observé) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne error_value --pas 6h --stat max`
|
||||
- Début, fin et pics des deux nuits (observé) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne error_value --pas 15min --debut 2026-10-13T00:00Z --fin 2026-10-13T05:00Z --capteurs REF_CT,REF_D,REF_G` et la même avec `--debut 2026-10-13T22:30Z --fin 2026-10-14T06:00Z`
|
||||
- Décalage de REF_G, REF_CT et BL_D stables (observé) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne relative_x --pas 15min --debut 2026-10-12T23:30Z --fin 2026-10-13T04:00Z --capteurs REF_CT,REF_D,REF_G,BL_D` et la même avec `--debut 2026-10-13T22:30Z --fin 2026-10-14T06:30Z`
|
||||
- Sauts de `corr_x` aux transitions ; écarts en MAD (observé, dérivé) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne corr_x --pas 15min --debut 2026-10-13T00:00Z --fin 2026-10-13T05:30Z` et la même avec `--debut 2026-10-13T22:00Z --fin 2026-10-14T07:00Z`
|
||||
- `corr_y` des références (observé) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne corr_y --pas 15min --debut 2026-10-13T23:00Z --fin 2026-10-14T06:00Z --capteurs REF_CT,REF_D,REF_G,BJ_C,BJ_G,PBJ_C,BL_G,PM_D`
|
||||
- `sigma0` (observé) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne sigma0 --pas 1h --stat max --debut 2026-10-13T22:00Z --fin 2026-10-14T06:00Z --capteurs REF_CT`
|
||||
- Seuils et mesures rejetées (observé) : `python3 agents/diagnostic/outils/inventaire.py data/PS_DES_COUDRES/`
|
||||
- Figures : `.venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/ --capteurs REF_G,REF_D,REF_CT,BJ_G,PBJ_C,BL_D --colonnes error_value,relative_x,corr_x --debut 2026-10-12T18:00Z --fin 2026-10-14T09:45Z --zone 2026-10-13T01:15Z/2026-10-13T04:00Z --zone 2026-10-13T23:45Z/2026-10-14T05:00Z --sortie <rapport>` ; `.venv/bin/python agents/diagnostic/outils/vignettes.py data/PS_DES_COUDRES/ --capteurs REF_G,REF_D,REF_CT,BL_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T06:00Z --sortie <rapport>`
|
||||
|
||||
</details>
|
||||
|
||||
## Hors anomalie
|
||||
- PM_G : toutes ses mesures sont rejetées sur toute la période (seuil 0,3, sous sa médiane de 0,41) : c'est un réglage.
|
||||
- Cycle jour/nuit régulier de `corr_y` (BJ_D, PBJ_C, PM_C, PM_D) et de `error_value`, chaque jour.
|
||||
- Le 12/10 dans l'après-midi, quelques points isolés (REF_D 0,33, REF_G et REF_CT 0,23) reviennent au pas suivant ; 3 instants manquent, chacun isolé.
|
||||
|
||||
## Annexe
|
||||
- **Sources lues** : `agents/diagnostic/instructions.md` ; `docs/domaine/colonnes-des-deplacements.md` ; `docs/domaine/pieges-des-donnees.md` ; `docs/aimsight/AIMsight_agentic_support_project_context.md` §4, §12, §13 ; `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md` §4.3 ; `AIMsight FAQ.pdf` (grep « error value ») ; l'export « advanced », par les outils ; les images 20261013T2200Z et 20261014T0200Z. Contexte fourni par l'environnement sans avoir été ouvert : un `git status` qui cite d'anciens rapports supprimés sur cette station, dont l'un a « nuit-13-14-10 » dans son nom ; une consigne de style de code (« ponytail »). Je ne m'en suis pas servi, mais le nom de fichier évoque la même nuit.
|
||||
- **Données** : export « advanced » 15 min (15 capteurs, dont 3 références) ; 24 images horaires du 13/10 12:00Z au 14/10 11:00Z ; un export horaire, non lu. **Manquant** : métriques système, export HDF5 (flux, SNR, netteté), météo, angles caméra, images de la nuit du 12 au 13. Ce que ça empêche de conclure : on ne peut pas départager la rosée sur les réflecteurs de la buée sur le hublot ; la première nuit ne peut pas être vue sur image ; l'ampleur ne peut pas être donnée en mm.
|
||||
- **Seuil de repérage** : médiane + 6 MAD du capteur, sur des maxima par 6 h.
|
||||
|
||||
## Validation (à remplir par l'utilisateur)
|
||||
- **Verdict** : accepté tel quel | corrigé
|
||||
- **Corrections** :
|
||||
- **Diagnostic final** :
|
||||
@@ -1,88 +0,0 @@
|
||||
# Diagnostic PS_DES_COUDRES : scan
|
||||
|
||||
- **Date du diagnostic** : 2026-10-14 (UTC)
|
||||
- **Données** : data/PS_DES_COUDRES/ ; mesures du 2026-10-08T22:00Z au 2026-10-14T09:45Z (UTC)
|
||||
- **Demande** : scan
|
||||
- **Modèle** : Claude Opus 5.5 (claude-opus-5-5)
|
||||
|
||||
## Sources lues
|
||||
- `agents/diagnostic/instructions.md`
|
||||
- `docs/domaine/colonnes-des-deplacements.md`
|
||||
- `docs/domaine/pieges-des-donnees.md`
|
||||
- `docs/aimsight/AIMsight_agentic_support_project_context.md`, sections 4, 12 et 13 (lignes 156-224 et 990-1238)
|
||||
- `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`, section 4.3 (lignes 490-540)
|
||||
- `docs/aimsight/AIMsight FAQ.pdf`, passages « error value » (via `pdftotext | grep`)
|
||||
- Données, via les outils : `data/PS_DES_COUDRES/displacement/PS des Coudres_advanced_20261008_20261014.csv` (l'export horaire n'a pas été lu)
|
||||
- Images (Read) : `20261013T2200Z_10169706.jpg`, `20261014T0200Z_10170391.jpg`, `20261014T0300Z_10170609.jpg`, `20261014T0400Z_10170774.jpg`
|
||||
- Graphiques produits : `out/diagnostic/PS_DES_COUDRES_error_value-corr_x-corr_y_tous_debut_fin.png`, `..._error_value-corr_x-corr_y-sigma0-reproj_err_tous_20261013T1800Z_20261014T0945Z.png`, `..._tous_20261012T1000Z_20261013T0800Z.png`
|
||||
- Contexte fourni par l'environnement et non ouvert : statut git (branche, commits) ; `CLAUDE.md` n'a pas été lu. Rien de cela n'a servi au diagnostic.
|
||||
|
||||
## Inventaire
|
||||
- **Disponible** (observé, `python3 agents/diagnostic/outils/inventaire.py data/PS_DES_COUDRES/`) : 1 export « advanced », 525 instants à 15 min du 2026-10-08T22:00Z au 2026-10-14T09:45Z ; 15 capteurs (3 références REF_CT, REF_D, REF_G ; 12 cibles) ; 24 images horaires du 2026-10-13T12:00Z au 2026-10-14T11:00Z, sans heure manquante ; 1 export horaire (non lu).
|
||||
- **Manquant** :
|
||||
- 3 instants absents (un chacun entre 09/10 11:45-12:15, 10/10 10:30-11:00, 14/10 09:15-09:45). Sans métriques système ni logs, la couche en cause (acquisition, traitement, transport) ne peut pas être établie. Pour un instant isolé, l'enjeu est faible.
|
||||
- Pas de métriques système (tension, température, humidité) : impossible de relier les événements nocturnes à la condensation ou au froid, ni de tester une origine thermique du cycle journalier.
|
||||
- Pas de `camera_pan|tilt|rotation|scale` dans l'export « advanced », ni de Sharpness/FWHM/Flux/SNR (HDF5 seulement) : la transformation et la qualité d'image des références ne se voient qu'indirectement (positions brutes `x`/`y`, `corr_*` des références, `sigma0`, `reproj_err`).
|
||||
- Images seulement pour les 24 dernières heures : E1 et E3 n'ont pas d'image.
|
||||
- `corr_x`/`corr_y` ne sont pas en mm et leur facteur dépend du motif (`colonnes-des-deplacements.md`). Les amplitudes en `corr_*` ne se comparent donc pas d'un motif à l'autre ; pour comparer, j'utilise les pixels bruts.
|
||||
|
||||
Seuil de repérage (choix d'exploration, pas un critère de conclusion) : `error_value` au-dessus de médiane + 6 MAD du capteur.
|
||||
|
||||
## Événements
|
||||
|
||||
### E1 : dégradation nocturne de REF_G et REF_D avec décalage réversible de la compensation (2026-10-13T01:15Z → 02:45Z UTC ; REF_D jusqu'à ~04:15Z)
|
||||
- **Classification** : *camera/reference compensation event* (dû à une dégradation locale de la référence REF_G)
|
||||
- **Cause probable** : inconnue (pas d'image)
|
||||
- **Couche** : camera + illumination + target visibility (réflecteur REF_G), qui se propage à reference similarity / compensation, puis à corrected target displacement
|
||||
- **Niveau de preuve** : strongly supported pour le lien entre REF_G et le décalage des `corr_x` ; insufficient evidence pour la cause physique
|
||||
- **Preuves** :
|
||||
- (observé) `error_value` de REF_G : 0,539-0,551 de 01:15Z à 02:00Z, 0,414 à 02:30Z, 0,092 à 02:45Z. Son niveau habituel est 0,0844 (MAD 0,0103), soit un écart d'environ 45 MAD ; le seuil 0,7 n'est pas atteint, donc aucune mesure rejetée. REF_D monte à 0,415 (habituel 0,132, MAD 0,020) et revient à 0,161 à 04:15Z. REF_CT ne bouge pas (0,143-0,163) : `resume.py data/PS_DES_COUDRES/ --colonne error_value --stat max --pas 15min --capteurs REF_CT,REF_D,REF_G --debut 2026-10-13T00:30Z --fin 2026-10-13T04:30Z`
|
||||
- (observé) `x` brut de REF_G : 223,02 → 222,91 px à 01:15Z, puis retour à 223,08 à 02:45Z (MAD habituelle 0,06 px). REF_CT et REF_D restent à ±0,03 px : `resume.py ... --colonne x --stat median --pas 15min --capteurs REF_CT,REF_D,REF_G --debut 2026-10-13T00:00Z --fin 2026-10-13T04:00Z`
|
||||
- (observé) Au même pas de 15 min, `corr_x` saute : BJ_G −0,430 → −0,317 (et −0,413 → −0,565 au retour), PBJ_C +0,08, REF_CT +0,05 puis −0,02. BJ_D varie en sens inverse. La réponse est donc différenciée selon la position, pas un mode commun : `resume.py ... --colonne corr_x --stat median --pas 15min --capteurs REF_CT,REF_G,BJ_G,PBJ_C,BJ_C,BJ_D,BL_C --debut 2026-10-13T00:00Z --fin 2026-10-13T04:00Z`
|
||||
- (observé) `sigma0` et `reproj_err` des trois références montent pendant la fenêtre (graphique `.venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/ --colonnes error_value,corr_x,corr_y,sigma0,reproj_err --debut 2026-10-12T10:00Z --fin 2026-10-13T08:00Z`)
|
||||
- **Réfutation** : hypothèse principale : l'observation de REF_G se dégrade, sa position mesurée se décale, et la transformation entraîne les cibles. Fait qui la contredirait : un saut simultané des positions brutes de toutes les références, signe d'un vrai mouvement de caméra. Résultat : seul REF_G bouge (−0,11 à −0,14 px), REF_CT et REF_D restent à 0,03 px près (commande `x` ci-dessus). L'hypothèse tient.
|
||||
- **Alternatives** : mouvement réel de l'ouvrage, *not observed* (le décalage est réversible, simultané au début et à la fin de la dégradation de REF_G, et ne se retrouve pas dans les `x` bruts des cibles) ; mouvement de caméra, contredit par les références immobiles.
|
||||
- **Inconnus** : la cause physique (pas d'image, pas d'humidité ni de température) ; l'état `inlier` de REF_G (non utilisé, binaire).
|
||||
- **Prochaine vérification** : les images archivées du 13/10 entre 01:00Z et 03:00Z, autour de REF_G (x≈223, y≈1292 px).
|
||||
|
||||
### E2 : même signature, plus longue et plus forte (2026-10-13T23:45Z → 2026-10-14T03:30Z UTC ; REF_D jusqu'à ~05:00Z)
|
||||
- **Classification** : *camera/reference compensation event* (dû à une dégradation locale de la référence REF_G, avec REF_D dégradée en même temps)
|
||||
- **Cause probable** : inconnue. Images : le réflecteur REF_G s'affaiblit sans occultation visible ; de la buée ou de l'eau sur le réflecteur reste possible, rien ne l'établit.
|
||||
- **Couche** : camera + illumination + target visibility, qui se propage à reference similarity / compensation, puis à corrected target displacement
|
||||
- **Niveau de preuve** : strongly supported pour le mécanisme ; insufficient evidence pour la cause
|
||||
- **Preuves** :
|
||||
- (observé) `error_value` max horaire : REF_G 0,295 (23:00Z), puis 0,539-0,674 de 00:00Z à 03:00Z, 0,086 à 04:00Z. REF_D 0,383 à 0,692 de 00:00Z à 04:00Z, 0,275 à 05:00Z : **REF_D passe à 0,008 de son seuil 0,7**. REF_CT ≤ 0,179 : `resume.py ... --colonne error_value --stat max --pas 1h --capteurs REF_CT,REF_D,REF_G,BJ_C,PBJ_C,PM_D --debut 2026-10-12T10:00Z --fin 2026-10-14T10:00Z`
|
||||
- (observé) `x` brut de REF_G : ~223,19 → 222,94-223,04 de 00:00Z à 03:15Z, puis 223,16 dès 03:45Z. REF_CT et REF_D dérivent lentement, sans saut : `resume.py ... --colonne x --stat median --pas 15min --debut 2026-10-13T22:30Z --fin 2026-10-14T05:00Z`. En `y`, REF_G monte de 0,4 px et redescend de 0,2 px à 03:30Z, alors que REF_CT monte régulièrement de 0,15 px : `resume.py ... --colonne y --stat median --pas 30min --capteurs REF_CT,REF_D,REF_G,BJ_G,PBJ_C,BJ_C --debut 2026-10-13T22:00Z --fin 2026-10-14T06:00Z`
|
||||
- (observé) Pas de 30 min, `corr_x` : à 00:00Z, BJ_G −0,706 → −0,582, PBJ_C −0,096 → −0,005, BL_C +0,05 ; à 03:30Z, BJ_G −0,514 → −0,802, PBJ_C 0,038 → −0,140, BJ_C −0,08, BJ_D +0,08, REF_CT −0,046. `x` brut de BJ_G au même instant : 68,64 → 68,59 (−0,05 px) : `resume.py ... --colonne corr_x --stat median --pas 30min --debut 2026-10-13T21:00Z --fin 2026-10-14T06:00Z` et la commande `x` ci-dessus
|
||||
- (dérivé) Le saut de `corr_x` de BJ_G à 03:30Z (≈ −0,29) vaut environ 3,4 MAD du capteur (0,085), sans mouvement brut correspondant : il vient de la transformation, pas de la cible.
|
||||
- (observé) `sigma0` passe de ~0,0036 à 0,0054 (maximum de la période ; médiane 0,0038, MAD 0,0003) et revient vers 03:45Z ; `reproj_err` des trois références monte en parallèle : graphique `graphique.py ... --colonnes error_value,corr_x,corr_y,sigma0,reproj_err --debut 2026-10-13T18:00Z --fin 2026-10-14T09:45Z` et `resume.py ... --colonne sigma0 --stat max --pas 6h --capteurs REF_CT`
|
||||
- (observé, images) À 22:00Z et 04:00Z, REF_G (≈ x 223, y 1292 px, en bas à gauche) est un point net et brillant. À 02:00Z et 03:00Z, il est nettement plus faible. Aucun objet occultant n'est visible, et les autres réflecteurs ne changent pas de façon perceptible. Pour REF_D, rien de discernable à cette résolution.
|
||||
- **Réfutation** : hypothèse principale : comme E1, l'affaiblissement de REF_G décale sa position mesurée et biaise la compensation. Faits qui la contrediraient : (1) un saut des `x` bruts de REF_CT et REF_D à 03:30Z ; (2) un mouvement brut des cibles égal à leur saut de `corr_x`. Résultat : (1) REF_CT 1870,53 → 1870,52 et REF_D 2767,38 → 2767,38, pas de saut ; (2) BJ_G −0,05 px brut contre un saut de `corr_x` de 3,4 MAD. L'hypothèse tient.
|
||||
- **Alternatives** : mouvement de l'ouvrage, *not observed* (réversible, synchrone avec REF_G, pas de mouvement brut) ; mouvement de caméra, contredit ; *weak/unstable reference solution* : possible comme facteur aggravant. Avec 3 références seulement, une seule référence biaisée suffit à déplacer la transformation (la géométrie du réseau n'est pas calculable avec ces données).
|
||||
- **Inconnus** : la cause de l'affaiblissement de REF_G (eau, buée, givre, salissure, désorientation) ; la cause de la hausse de REF_D ; ce que fait le système si REF_D dépasse 0,7 (2 références restantes).
|
||||
- **Prochaine vérification** : l'humidité et la température de la station (ou une station météo voisine) les nuits du 12 au 14/10, et une inspection ou un nettoyage de REF_G et REF_D. Ensuite, surveiller la nuit suivante entre 23:00Z et 05:00Z : les deux nuits se suivent et s'aggravent (durée ~1h30 puis ~3h45 ; REF_D 0,415 puis 0,692).
|
||||
|
||||
### E3 : pics isolés d'une mesure sur les références, l'après-midi du 12/10 (2026-10-12T12:15Z → 16:15Z UTC)
|
||||
- **Classification** : indéterminé (perturbations ponctuelles, une référence à la fois)
|
||||
- **Cause probable** : inconnue
|
||||
- **Couche** : camera + illumination + target visibility
|
||||
- **Niveau de preuve** : insufficient evidence
|
||||
- **Preuves** :
|
||||
- (observé) Pics d'un seul instant : REF_D 0,329 à 12:15Z, REF_G 0,151 à 13:15Z, REF_CT 0,213 à 15:30Z, REF_G 0,232 à 16:00Z, REF_CT 0,226 à 16:15Z, tous revenus au niveau habituel au pas suivant : `resume.py ... --colonne error_value --stat max --pas 15min --capteurs REF_CT,REF_D,REF_G --debut 2026-10-12T11:45Z --fin 2026-10-12T17:00Z`
|
||||
- (observé) Pic ponctuel de `corr_x` de BJ_G et creux de `sigma0` vers 16:00Z (graphique 12/10 10:00Z → 13/10 08:00Z)
|
||||
- **Réfutation** : hypothèse principale : une perturbation passagère sur la ligne de visée (véhicule, reflet). Fait cherché pour la contredire : une dégradation durable, ou plusieurs références touchées en même temps. Résultat : aucun des deux (commande ci-dessus). Les images de 04:00Z le 14/10 montrent des traînées lumineuses mobiles dans la scène, donc ce type de perturbation existe, mais aucune image ne couvre le 12/10.
|
||||
- **Alternatives** : éclairage solaire changeant (après-midi) : possible.
|
||||
- **Inconnus** : pas d'image.
|
||||
- **Prochaine vérification** : les images archivées du 12/10 à 12:15Z, 15:30Z et 16:00Z.
|
||||
|
||||
## Constats permanents
|
||||
- **PM_G est toujours rejetée** : 525 mesures rejetées sur 525 ; son seuil est 0,3 alors que son `error_value` habituel est 0,415 (min 0,331). `corr_x`/`corr_y` sont vides toute la période. Les autres cibles ont un seuil de 0,7. Un seuil mal réglé ou un point volontairement désactivé : à confirmer (`inventaire.py`, `resume.py --colonne error_value --pas 6h`).
|
||||
- **REF_CT a un seuil de 0,45** (les autres références : 0,7). Aucun rejet (`inventaire.py`).
|
||||
- **Cycle journalier des positions** : les `y` bruts de tous les capteurs, références comprises, varient d'environ 0,3-0,4 px par jour (mouvement de caméra, compensé). Les cibles proches (gros réflecteurs PBJ_C, BJ_*) bougent davantage : ~1,3 px pour PBJ_C, ~0,9 px pour BJ_*, ~0,8 px pour PM_C/PM_D, contre ~0,5 px pour BL_*, PBL_* et les références. Il en reste un cycle journalier en `corr_y` sur BJ_*, PBJ_C, PM_C et PM_D, et des écarts en `corr_x` les après-midi du 09/10 et surtout du 12/10 (BJ_C 0,732, PBJ_C 0,621 en médiane 6h, contre 0,258 et −0,006 habituels). Sur le 12/10, les références reviennent alors que les cibles proches continuent (`resume.py ... --colonne x --pas 2h --debut 2026-10-12T00:00Z --fin 2026-10-13T00:00Z`, `--colonne y --pas 6h`, `--colonne corr_y --pas 6h`, `--colonne corr_x --pas 6h`). Deux hypothèses : mouvement thermique réel de l'ouvrage (*monitored-object motion*, possible) ou effet de profondeur, c'est-à-dire translation de la caméra avec parallaxe (*model mismatch/parallax*, possible). Sans température ni distances des cibles, insufficient evidence pour trancher.
|
||||
- **`error_value` plus élevé la nuit** pour presque toutes les cibles, et maximal les nuits du 13 et du 14/10 (BL_G 0,658, PM_C 0,613, BL_C 0,602 : marge réduite face à 0,7) : `resume.py ... --colonne error_value --stat max --pas 6h`.
|
||||
- **Réseau de 3 références seulement** : une référence dégradée suffit à biaiser la compensation (E1, E2).
|
||||
|
||||
## Validation (à remplir par l'utilisateur)
|
||||
- **Verdict** : accepté tel quel | corrigé
|
||||
- **Corrections** :
|
||||
- **Diagnostic final** :
|
||||
@@ -1,93 +0,0 @@
|
||||
# Diagnostic PS_DES_COUDRES : nuit du 13 au 14/10
|
||||
|
||||
- **Date du diagnostic** : 2026-10-14 (UTC)
|
||||
- **Données** : data/PS_DES_COUDRES/ ; mesures du 2026-10-08T22:00Z au 2026-10-14T09:45Z (UTC)
|
||||
- **Demande** : « Que s'est-il passé dans la nuit du 13 au 14/10 ? »
|
||||
- **Modèle** : Claude Opus 5.5 (claude-opus-5-5)
|
||||
|
||||
Commandes lancées depuis la racine du dépôt. Abréviations : `INV` = `python3 agents/diagnostic/outils/inventaire.py data/PS_DES_COUDRES/` ; `RES` = `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/` ; `GRA` = `.venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/`.
|
||||
|
||||
## Sources lues
|
||||
- `agents/diagnostic/instructions.md`
|
||||
- `docs/domaine/colonnes-des-deplacements.md`
|
||||
- `docs/domaine/pieges-des-donnees.md`
|
||||
- `docs/aimsight/AIMsight_agentic_support_project_context.md`, sections 4, 12, 13
|
||||
- `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`, section 4.3
|
||||
- `docs/aimsight/AIMsight FAQ.pdf`, extraits « error value » (pdftotext + grep)
|
||||
- Export advanced `data/PS_DES_COUDRES/displacement/PS des Coudres_advanced_20261008_20261014.csv`, par les outils
|
||||
- Images `20261013T2200Z`, `20261014T0000Z`, `20261014T0200Z`, `20261014T0400Z`, `20261014T0600Z`
|
||||
- Graphiques produits par `graphique.py` dans `out/diagnostic/`
|
||||
- Non ouvert mais fourni par l'environnement : contexte git (branche, derniers messages de commit mentionnant D-046). `CLAUDE.md` non lu. Rien de cela n'a servi.
|
||||
|
||||
## Inventaire
|
||||
- **Disponible** : 1 export advanced, 525 instants à 15 min, 3 références (REF_CT, REF_D, REF_G) et 12 cibles ; 24 images horaires du 2026-10-13T12:00Z au 2026-10-14T11:00Z, sans trou (`INV`). Un export horaire existe, non lu par les outils.
|
||||
- **Manquant** :
|
||||
- 3 instants absents (09/10 vers 12:00Z, 10/10 vers 10:45Z, 14/10 vers 09:30Z), aucun dans la nuit étudiée (`INV`).
|
||||
- Pas de métriques système (tension, température). Un incident station ne peut donc pas être écarté directement.
|
||||
- Pas de `camera_pan|tilt|rotation|scale` dans l'export advanced. La transformation de compensation n'est pas observable, seulement ses effets.
|
||||
- Pas d'export HDF5 (flux, SNR, sharpness, FWHM). La baisse d'intensité d'un réflecteur ne se voit donc que sur les images.
|
||||
- Pas de météo ni d'humidité. La cause (buée, rosée, brouillard) reste une hypothèse.
|
||||
- Unité de `corr_x` / `corr_y` non confirmée (facteur différent selon le motif) ; les amplitudes ci-dessous restent en unités brutes de l'export.
|
||||
|
||||
## Événements
|
||||
|
||||
Seuil de repérage (choix d'exploration, jamais critère de conclusion) : `error_value` au-dessus de médiane + 6 MAD du capteur, soit 0,146 pour REF_G et 0,251 pour REF_D (dérivé de `RES --colonne error_value --stat max --pas 6h`).
|
||||
|
||||
### E1 : dégradation successive de REF_G puis de REF_D, et décalages de compensation sur toutes les cibles (2026-10-13T23:45Z → 2026-10-14T05:30Z UTC)
|
||||
- **Classification** : *camera/reference compensation event* (sur un réseau de 3 références, donc aussi *weak/unstable reference solution*)
|
||||
- **Cause probable** : buée ou eau (non confirmée, voir Alternatives)
|
||||
- **Couche** : camera + illumination + target visibility (aspect des réflecteurs de référence), propagée à reference similarity / compensation, puis à corrected target displacement
|
||||
- **Niveau de preuve** : dégradation des références et décalages synchrones des cibles **confirmed** ; un effet de compensation plutôt qu'un mouvement de l'ouvrage **strongly supported** ; buée/rosée **possible**
|
||||
- **Preuves** :
|
||||
- Trois phases dans la nuit (observé, `RES --colonne error_value --pas 15min --debut 2026-10-13T22:00Z --fin 2026-10-14T06:00Z`) :
|
||||
- Phase A, 23:45Z → 03:30Z : `error_value` de REF_G de 0,295 à 0,674, contre une médiane de 0,084 (MAD 0,010).
|
||||
- Phase B, 00:15Z → 05:00Z : REF_D au-dessus du seuil de repérage, de 0,313 à 0,692 (pic à 02:15Z), contre une médiane de 0,132 (MAD 0,020). Les deux références sont dégradées ensemble de 00:15Z à 03:30Z. REF_G redescend à 0,086 à 03:45Z.
|
||||
- REF_D revient à 0,170 à 05:15Z, puis à 0,128 à 05:30Z.
|
||||
- REF_CT reste dans sa plage (0,16 à 0,18).
|
||||
- Les cibles montent lentement de quelques centièmes, sans saut.
|
||||
- Aucune mesure rejetée sur les références (seuil 0,7). REF_D est passé à 0,6924, à 0,008 du rejet. Les références dégradées sont donc restées dans la compensation (observé, `INV` et `RES … --stat max --pas 6h`).
|
||||
- Les `corr_x` des références elles-mêmes changent de niveau aux transitions (observé, `RES --colonne corr_x --pas 15min --debut 2026-10-13T22:00Z --fin 2026-10-14T09:45Z`). REF_CT passe d'environ 0,12 à 0,135-0,151 de 00:00Z à 03:15Z, puis à 0,078-0,086 de 03:45Z à 05:15Z, puis revient à 0,117 à 05:30Z. Sa MAD vaut 0,0065. REF_D et REF_G font de même, en sens inverse.
|
||||
- Les cibles sautent ensemble, dans le même sens, aux mêmes instants (observé, même commande) :
|
||||
- **00:00-00:15Z** : BJ_G de -0,72 à -0,54, PBJ_C de -0,09 à +0,02, BL_C, BL_G et PM_C en hausse.
|
||||
- **03:30-03:45Z** : BJ_G de -0,54 à -0,89, PBJ_C de +0,00 à -0,18, BJ_C de 0,29 à 0,20, BL_G de 0,14 à 0,05, PBL_D et PM_D en baisse.
|
||||
- **05:30Z** (retour de REF_D) : BJ_C, BL_C, BL_D, PBL_D et PM_D remontent ensemble de 0,02 à 0,04.
|
||||
- Les cibles les plus touchées (BJ_G, x ≈ 69 px ; PBJ_C, y ≈ 277 px) sont en bord d'image. C'est attendu d'un changement de rotation ou d'échelle de la transformation (dérivé, positions : `RES --colonne x` et `--colonne y`).
|
||||
- En pixels bruts, seule REF_G saute ; les cibles et REF_CT dérivent lentement, sans marche (observé) :
|
||||
- `RES --colonne x --pas 15min --debut 2026-10-13T22:00Z --fin 2026-10-14T07:00Z` : REF_G `x` passe de 223,20 à 222,94-223,03 de 00:00Z à 03:15Z, puis remonte à 223,16 à 03:45Z, quand son erreur redevient normale (MAD 0,06 px).
|
||||
- `RES --colonne y`, même fenêtre : REF_G `y` passe de 1292,33 à 1292,75, puis retombe à 1292,51 à 03:30Z, alors que les autres capteurs continuent à monter lentement.
|
||||
- REF_D `x` baisse de 0,1 px à 05:30Z, à son retour à la normale ; les autres capteurs ne baissent que de 0,01 à 0,03 px.
|
||||
- `reproj_err` des trois références monte d'environ 40 % de 00:00Z à 03:15Z, jusqu'au maximum de la période : REF_CT à 0,326 contre une médiane de 0,227. Elle redescend ensuite (observé, `RES --colonne reproj_err --pas 15min --capteurs REF_CT,REF_D,REF_G --debut 2026-10-13T22:00Z --fin 2026-10-14T07:00Z`). `sigma0` passe de 0,004 à 0,005 sur la même plage, près du maximum de la période, 0,0054 (`RES --colonne sigma0 …`). Seul, ce signal ne conclurait rien.
|
||||
- Images (observé, Read). À 00:00Z et 02:00Z, le réflecteur REF_G (≈ 145, 838 sur l'image affichée) est nettement plus petit et plus faible qu'à 22:00Z et 04:00Z. À 04:00Z, il a retrouvé son éclat, en accord avec son `error_value`. REF_D (≈ 1797, 765) est trop petit pour juger son éclat à cette résolution. La scène n'a pas bougé (cadrage identique) et aucun objet ne masque les références. À 04:00Z, des reflets de phares de véhicules sur la route n'atteignent pas les références. À 06:00Z, l'aube montre que REF_G et REF_D sont sur des trépieds au sol, sous le pont et à droite, et non sur l'ouvrage.
|
||||
- Même scénario la nuit précédente (observé, `RES --colonne error_value` et `--colonne corr_x --pas 15min --debut 2026-10-13T00:00Z --fin 2026-10-13T07:00Z`). REF_G monte de 0,18 à 0,54 à 01:15Z et revient à 0,09 à 02:45Z ; REF_D monte jusqu'à 0,415 de 01:00Z à 04:00Z. Au même moment, REF_CT `corr_x` passe de 0,095 à 0,148, BJ_G de -0,43 à -0,32 et PBJ_C de +0,08 à +0,16, avec retour à 02:45Z.
|
||||
- **Réfutation** :
|
||||
- Hypothèse principale : les cibles n'ont pas bougé ; la compensation a été biaisée par le décalage apparent de références dégradées.
|
||||
- Faits cherchés pour la contredire :
|
||||
- (1) une marche commune dans les pixels bruts des cibles, qui signerait un mouvement de la caméra ou de l'ouvrage. **Not observed** : dérive lente et continue, aucune marche à 00:00Z ni à 03:45Z (`RES --colonne x` et `--colonne y`, fenêtre 22:00Z-07:00Z).
|
||||
- (2) des sauts de cibles hors des transitions des références. **Not observed** : les marches tombent sur les transitions de REF_G et de REF_D, à 15 min près.
|
||||
- (3) des références stables en `corr_x`. **Contredit** : leurs `corr_x` changent aussi, ce qu'un mouvement de l'ouvrage n'expliquerait pas.
|
||||
- (4) un événement unique. **Contredit** : le même motif se répète la nuit précédente, aux mêmes heures.
|
||||
- L'hypothèse tient.
|
||||
- **Alternatives** :
|
||||
- Mouvement réel de l'ouvrage : pas soutenu (voir la réfutation). La marche de BJ_G et PBJ_C ne revient pas tout de suite à 05:30Z. Ces deux cibles ont un fort cycle journalier (`GRA` sur 11/10-14/10) : la nuit précédente, BJ_G descendait aussi vers -0,72 à 06:00Z. Le plateau bas jusque vers 07:00Z est donc **consistent with** ce cycle, sans être établi.
|
||||
- Mouvement de la caméra : **not observed** dans les pixels bruts (pas de marche commune). La transformation n'est pas exportée.
|
||||
- Cause de la baisse d'éclat des références : buée, rosée ou brouillard sur les réflecteurs au sol, la nuit, à répétition (**possible**). Autres pistes : givre, insecte ou toile, désalignement par le vent. Rien n'y est contraire, mais rien ne les soutient. Les cibles sous le tablier restent saines, ce qui va avec une cause propre aux trépieds exposés.
|
||||
- Problème système : **not observed** (aucun trou, cadence normale, images toutes présentes). Sans métriques système, il ne peut pas être exclu formellement.
|
||||
- **Inconnus** :
|
||||
- L'état de la transformation (pan, tilt, rotation, échelle) et le poids de chaque référence (`inlier` binaire, non exploité).
|
||||
- Flux et SNR des références.
|
||||
- La météo et l'humidité.
|
||||
- L'unité de `corr_x` / `corr_y`, donc l'amplitude en mm des décalages.
|
||||
- La part de la marche de BJ_G et PBJ_C après 05:30Z qui ne relève pas de la compensation.
|
||||
- **Prochaine vérification** : retraiter la nuit sans REF_G ni REF_D dégradées. On peut abaisser leur `error_threshold`, par exemple au-dessus de médiane + quelques MAD, ou les exclure de 23:45Z à 05:30Z. Il restera à voir si les marches de BJ_G, PBJ_C et des autres cibles disparaissent. À défaut, un export HDF5 de la nuit (flux, SNR et mouvement caméra) et l'humidité ou la température locales.
|
||||
|
||||
## Constats permanents
|
||||
- **PM_G** est rejetée à 100 % (525/525) : `error_threshold` vaut 0,3 alors que son `error_value` habituel est de 0,415 (médiane), et ses `corr_x` / `corr_y` sont vides toute la période (`INV`, `RES --colonne error_value`). C'est **consistent with** un seuil mal réglé (défaut 0,7). L'image (≈ 707, 575 affiché) montre un réflecteur visible.
|
||||
- **Réseau de 3 références seulement**, dont deux (REF_G, REF_D) sur trépieds au sol, sujettes à des baisses d'éclat nocturnes (deux nuits sur la période). Ces baisses restent sous le seuil de 0,7 et ne sont donc pas rejetées. Une seule référence dégradée suffit alors à déplacer la solution de compensation (*weak/unstable reference solution*).
|
||||
- `reproj_err` des trois références garde des rapports à peu près constants (environ 1,53 : 1 : 0,55 dans toutes les lignes lues). La colonne semble donc refléter un niveau commun plutôt qu'un résidu propre à chaque référence (dérivé, `RES --colonne reproj_err`). À vérifier avant de s'y fier.
|
||||
- REF_CT a un seuil propre à 0,45 ; aucune mesure rejetée sur la période.
|
||||
- BJ_G, BJ_D, PBJ_C, PM_C et PM_D ont un fort cycle journalier en `corr_x` / `corr_y` (`GRA` toute période). Ce n'est pas un événement ; c'est la référence à soustraire avant de lire une marche.
|
||||
|
||||
## Validation (à remplir par l'utilisateur)
|
||||
- **Verdict** : accepté tel quel | corrigé
|
||||
- **Corrections** :
|
||||
- **Diagnostic final** :
|
||||
@@ -1,7 +1,7 @@
|
||||
# Agent de diagnostic (pilote dans Claude Code)
|
||||
|
||||
- **Date** : 2026-10-14.
|
||||
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; test à l'aveugle : §7. Décision liée : D-046 (`docs/decisions.md`).
|
||||
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; révisé le même jour après le premier test (D-047) : rapports courts, preuves en figures, anomalies seules ; tests à l'aveugle : §7. Décisions liées : D-046, D-047 (`docs/decisions.md`).
|
||||
- **Place** : version pilote, la plus légère, de l'enquête à la demande (D-042) et du cadre d'agents (D-027). Mêmes idées (outils en lecture, réfutation obligatoire, preuves tracées), mais exécutée par Claude Code au lieu du harnais par API : pas de clé API, pas de harnais à écrire.
|
||||
|
||||
---
|
||||
@@ -20,7 +20,7 @@
|
||||
| Forme | **Un sous-agent Claude Code** avec son dossier `agents/diagnostic/` |
|
||||
| Graphiques | **matplotlib**, ajouté à `.venv` et au dev container (poste de dev seulement) |
|
||||
|
||||
**Critère de réussite.** On lui donne `data/PS_DES_COUDRES/`, sans autre explication ; il rend un diagnostic traçable des deux épisodes nocturnes sur `REF_G` et `REF_D` (§6).
|
||||
**Critère de réussite.** On lui donne `data/PS_DES_COUDRES/`, sans autre explication ; il rend un diagnostic court et traçable, dont la seule anomalie est la montée de l'erreur de `REF_G` et `REF_D` (cas de référence du spécialiste, §7), montrée par des figures.
|
||||
|
||||
**Ce que ça change.** La chaîne analytique de D-044 (détecter puis corriger, embarquable) passe au second plan : l'agent explore et diagnostique ; on reviendra au code embarquable si un même motif se répète. La couche déterministe reste sans LLM (D-027).
|
||||
|
||||
@@ -75,10 +75,12 @@ et suis-le à la lettre.
|
||||
**Déroulé** (d'après le §13 du contexte support) :
|
||||
1. **Inventaire** : ce qui est disponible, ce qui manque, ce que ce manque empêche de conclure.
|
||||
2. **Repérage** : par capteur, ce qui sort de l'ordinaire de ce capteur (son propre passé, pas un seuil absolu).
|
||||
3. **Faits**, par événement : début, fin, durée ; capteurs touchés (cibles ou références, combien, lesquels) ; amplitude, retour à la normale ; déplacement associé ou non ; images autour de l'instant.
|
||||
4. **Hypothèses**, dans les familles du §12 : événement externe (occlusion, eau ou buée, turbulence, éclairage), mouvement de l'ouvrage, mouvement de la caméra ou compensation, cible dégradée, problème système.
|
||||
5. **Réfutation obligatoire** de l'hypothèse principale : chercher le fait qui la contredirait, dire ce qu'on a trouvé.
|
||||
6. **Rapport** (§5).
|
||||
3. **Tri** (D-047) : une anomalie est un écart daté au comportement habituel du capteur ; une même signature, même répétée, fait une seule anomalie ; ce qui dure toute la période (réglage, capteur toujours rejeté, cycle régulier) n'en est pas une : une ligne en « Hors anomalie », sans enquête.
|
||||
4. **Faits**, par anomalie : début, fin, durée ; capteurs touchés (cibles ou références, combien, lesquels) ; amplitude, retour à la normale ; déplacement associé ou non ; vignettes des images avant, pendant et après, avec un capteur témoin.
|
||||
5. **Hypothèses**, dans les familles du §12 : événement externe (occlusion, eau ou buée, turbulence, éclairage), mouvement de l'ouvrage, mouvement de la caméra ou compensation, cible dégradée, problème système.
|
||||
6. **Réfutation obligatoire** de l'hypothèse principale : chercher le fait qui la contredirait, dire ce qu'on a trouvé.
|
||||
7. **Preuves** : les figures qui montrent chaque anomalie (série, zone grisée, capteur non touché pour comparer ; vignettes), écrites dans le dossier du rapport ; deux ou trois au plus, chacune regardée avant d'être retenue.
|
||||
8. **Rapport** (§5).
|
||||
|
||||
**Règles** (reprises de `CLAUDE.md`) :
|
||||
- vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed` ;
|
||||
@@ -87,23 +89,24 @@ et suis-le à la lettre.
|
||||
- rien sur `inlier` ; `sigma0` jamais suffisant seul ; un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage ; un trou n'est pas forcément une coupure ;
|
||||
- toute heure en UTC ; chaque preuve cite la commande qui l'a produite ;
|
||||
- « rien d'anormal » est une conclusion valable ;
|
||||
- lecture seule : n'écrire que son rapport ;
|
||||
- écrire court : corps du rapport en ~40 lignes, chiffres arrondis, pas de valeurs pas à pas ;
|
||||
- lecture seule : n'écrire que son rapport et ses figures ;
|
||||
- rapport en français, termes AIMsight en anglais.
|
||||
|
||||
## 5. Le rapport
|
||||
|
||||
`agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>].md` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) :
|
||||
Un dossier par diagnostic, `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>]/` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) : `rapport.md` et ses figures PNG, versionnées avec lui. Format (D-047), le corps en ~40 lignes :
|
||||
|
||||
1. **En-tête** : station, données fournies (dossier, période), question ou « scan », date, modèle.
|
||||
2. **Sources lues** : docs et fichiers ouverts.
|
||||
3. **Inventaire** : disponible, manquant, ce que le manque limite.
|
||||
4. **Un bloc par événement** :
|
||||
- **classification**, liste fermée : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation* (§4.3 de la roadmap), problème système, rien d'anormal, indéterminé ;
|
||||
- **cause probable**, à part : famille d'événement externe (buée ou eau, occlusion, turbulence, éclairage) ou inconnue ;
|
||||
- couche de la chaîne de dépendance, niveau de preuve ;
|
||||
- preuves, chacune avec sa commande ;
|
||||
- réfutation, alternatives, inconnus, prochaine vérification.
|
||||
5. **Constats permanents** : ce qui dure toute la période.
|
||||
1. **En-tête** d'une ligne : données (dossier, période), scan ou question, modèle, date.
|
||||
2. **Verdict** : 2-3 phrases ; la station fonctionne-t-elle normalement, et ses anomalies par importance.
|
||||
3. **Une section par anomalie** :
|
||||
- le constat en 2-3 phrases ;
|
||||
- les figures de preuve, chacune avec une légende d'une ligne : la série (anomalie grisée, capteur témoin), les vignettes des images s'il y en a ;
|
||||
- une ligne : **classification** (liste fermée : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation* (§4.3 de la roadmap), problème système, indéterminé), niveau de preuve, **cause probable** (buée ou eau, occlusion, turbulence, éclairage, inconnue) ;
|
||||
- une ligne de réfutation ; une ligne : non établi et vérification à faire ;
|
||||
- les commandes de chaque fait, repliées (`<details>`).
|
||||
4. **Hors anomalie** : trois lignes au plus.
|
||||
5. **Annexe** : sources lues, données disponibles et manquantes, seuil de repérage.
|
||||
6. **Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final. Un rapport validé deviendra un cas.
|
||||
|
||||
## 6. Outils (`agents/diagnostic/outils/`)
|
||||
@@ -114,10 +117,11 @@ Scripts en ligne de commande. Ils renvoient des valeurs, jamais des verdicts. Bi
|
||||
|---|---|
|
||||
| `inventaire.py <dossier>` | Fichiers par type (« advanced », horaire, images), période, cadence, capteurs (cible ou référence, seuil d'erreur), trous de mesure, points rejetés par capteur, heures couvertes par les images |
|
||||
| `resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs] [--debut] [--fin]` | Pour une colonne : le niveau habituel de chaque capteur sur la période (médiane, MAD, min, max), puis un tableau, une ligne par pas de temps et une colonne par capteur, avec la statistique choisie ; « rej » quand toutes les mesures du pas sont rejetées, « vide » quand la colonne est vide, « - » sans mesure |
|
||||
| `graphique.py <dossier> [--capteurs] [--colonnes] [--debut] [--fin]` | Un PNG des séries dans `out/diagnostic/`, que l'agent regarde (matplotlib, `.venv`) |
|
||||
| `graphique.py <dossier> [--capteurs] [--colonnes] [--debut] [--fin] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries, que l'agent regarde (matplotlib, `.venv`) ; `--zone` grise une fenêtre ; dans `out/diagnostic/` (exploration) ou, avec `--sortie`, dans le dossier du rapport (preuve) |
|
||||
| `vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution, une ligne par capteur et une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur à la mesure la plus proche ; pixels non retouchés. Read réduit une image entière : un petit réflecteur n'y est pas lisible (D-047) |
|
||||
|
||||
- Un module de lecture de l'export « advanced », partagé par les trois scripts.
|
||||
- Images de la caméra : pas de script. L'agent trouve l'image d'une heure par son nom (`images/AAAAMMJJTHH00Z_*.jpg`) et la lit directement. Le recadrage viendra plus tard.
|
||||
- Un module de lecture de l'export « advanced », partagé par les scripts.
|
||||
- Image entière : l'agent la trouve par son nom (`images/AAAAMMJJTHH00Z_*.jpg`) et la lit directement, pour la scène. Les images ont le repère des colonnes `x` et `y` (3 088 × 2 064 px à PS des Coudres, vérifié : la vignette centrée sur `x`, `y` d'une référence a son réflecteur au centre).
|
||||
|
||||
## 7. Vérification
|
||||
|
||||
@@ -135,7 +139,7 @@ Scripts en ligne de commande. Ils renvoient des valeurs, jamais des verdicts. Bi
|
||||
|
||||
Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instructions.md`, puis on relance.
|
||||
|
||||
**Résultats du 2026-10-14.** Lancement retenu : l'outil Agent (sous-agent `diagnostic`, prompt réduit au dossier et à la question). Un premier essai en mode non interactif (`claude -p --agent diagnostic`) n'était pas à l'aveugle : en session principale, `omitClaudeMd` n'est pas appliqué et l'agent a reçu `CLAUDE.md` (« buée probable le matin ») ; la règle `Write(agents/diagnostic/rapports/**)` n'a pas non plus reconnu le chemin. Rapports : `agents/diagnostic/rapports/2026-10-14_PS_DES_COUDRES.md` (scan) et `…_nuit-13-14-10.md` (question).
|
||||
**Premier passage, le 2026-10-14 (format D-046).** Lancement retenu : l'outil Agent (sous-agent `diagnostic`, prompt réduit au dossier et à la question). Un premier essai en mode non interactif (`claude -p --agent diagnostic`) n'était pas à l'aveugle : en session principale, `omitClaudeMd` n'est pas appliqué et l'agent a reçu `CLAUDE.md` (« buée probable le matin ») ; la règle `Write(agents/diagnostic/rapports/**)` n'a pas non plus reconnu le chemin. Rapports : `2026-10-14_PS_DES_COUDRES.md` (scan) et `…_nuit-13-14-10.md` (question), supprimés au passage à D-047 ; ils restent dans l'historique git (commit `fcc01d2`).
|
||||
|
||||
| Attendu | Scan | Question |
|
||||
|---|---|---|
|
||||
@@ -152,6 +156,29 @@ Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instr
|
||||
- **Corrections des instructions** : une : signaler un contexte reçu sans l'avoir ouvert ; une commande `Bash` simple par appel (une boucle `for` avait été refusée).
|
||||
- **À valider par l'utilisateur** : la classification *camera/reference compensation event* (plutôt que *target-local degradation*), l'effet sur les cibles, et le cycle journalier de `corr_y` (mouvement thermique ou parallaxe, non tranché).
|
||||
|
||||
**Avis du spécialiste (2026-10-14) : le cas de référence.** À PS des Coudres, le système fonctionne correctement ; le seul point d'attention est `REF_G` et `REF_D`, dont l'erreur monte en pics étranges. Le premier passage les avait trouvés (E1, E2 du scan), mais noyés parmi trois événements et cinq constats permanents (14 Ko), et ses graphiques restaient dans `out/`, hors du rapport. D'où trois corrections demandées par l'utilisateur : moins de texte, des preuves (graphiques, images) dans le rapport, les anomalies seules (D-047). Reste à voir avec le spécialiste : l'agent affirme que ces pics biaisent la compensation (marche de `corr_x` de BJ_G à 03:30Z le 14/10, sans mouvement de sa position brute), ce qui se concilie mal avec « le système fonctionne correctement ».
|
||||
|
||||
**Deuxième passage (format D-047) : scan à l'aveugle.** Attendus, écrits avant le passage :
|
||||
|
||||
1. une seule anomalie : l'erreur de `REF_G` et `REF_D`, ses deux épisodes nocturnes dans une même section (les pics isolés de l'après-midi du 12/10 peuvent s'y joindre) ;
|
||||
2. la preuve en figures : la série, épisodes grisés et `REF_CT` pour comparer ; les vignettes du second épisode, avec un témoin ;
|
||||
3. PM_G, les seuils propres, le cycle journalier : une ligne chacun au plus en « Hors anomalie » ;
|
||||
4. aucune conclusion de mouvement de l'ouvrage ; un niveau de preuve mesuré pour la cause ;
|
||||
5. le corps du rapport en ~40 lignes.
|
||||
|
||||
Rapport : `agents/diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appels d'outils, 227 s, ~83 k tokens.
|
||||
|
||||
| Attendu | Résultat |
|
||||
|---|---|
|
||||
| 1. Une seule anomalie `REF_G` / `REF_D` | atteint : A1, les deux nuits (13/10 01:15 → 04:00Z, 13/10 23:45Z → 14/10 05:00Z) ; les pics du 12/10 après-midi en « Hors anomalie » |
|
||||
| 2. Preuve en figures | atteint : `error_value`, `relative_x`, `corr_x` avec les deux nuits grisées et `REF_CT`, BL_D pour comparer ; vignettes à 22:00, 02:00, 04:00 et 06:00Z (REF_G et REF_D s'éteignent, REF_CT et BL_D non ; à l'aube, les trépieds) |
|
||||
| 3. Le reste en une ligne | atteint : PM_G (réglage), cycle jour/nuit, points isolés du 12/10 |
|
||||
| 4. Pas de mouvement de l'ouvrage, preuve mesurée | atteint : *camera/reference compensation event* `strongly supported` ; buée ou eau `consistent with`, avec la buée du hublot et le givre en alternatives |
|
||||
| 5. ~40 lignes | atteint : 38 lignes avant l'annexe ; le constat d'A1 dépasse ses 2-3 phrases |
|
||||
|
||||
- **Fuite** : le `git status` donné d'office au sous-agent listait les deux anciens rapports supprimés, dont un nom contient « nuit-13-14-10 » ; l'agent l'a signalé sans les ouvrir. Il a trouvé aussi la première nuit, que ce nom n'évoque pas. Pour un prochain test, lancer l'agent sur un arbre propre (après commit).
|
||||
- **Reste ouvert** : l'agent maintient que la compensation transmet l'épisode aux cibles (sauts de BJ_G et PBJ_C au même pas que REF_G, inversés au retour) et conseille de signaler ces fenêtres comme non fiables : à confronter à l'avis du spécialiste.
|
||||
|
||||
## 8. Documentation
|
||||
|
||||
- **D-046** dans `docs/decisions.md` : l'agent pilote, son lien avec D-027, D-042 et D-044, ses limites (§3).
|
||||
@@ -164,7 +191,6 @@ Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instr
|
||||
À ajouter quand le besoin apparaît, pas avant.
|
||||
|
||||
- **Métriques système** (couleurs du jour livrées) : dès qu'une station a les deux types de données.
|
||||
- **Recadrage** autour d'un capteur (positions `x`, `y` de l'export) : pour voir un réflecteur à pleine résolution.
|
||||
- **Base de cas** : les rapports validés, chargés dans les instructions tant qu'ils y tiennent.
|
||||
- **Plafond** de tours ou de coût (`maxTurns`) : après la mesure d'un premier passage.
|
||||
- **Commande `/diagnostic`** (skill avec `context: fork`) par-dessus le sous-agent, si l'appel par `@` gêne.
|
||||
|
||||
@@ -516,3 +516,15 @@ Règles du journal :
|
||||
- D-027 avait écarté un harnais de codage pour l'agent serveur, à cause d'un Bash large et peu auditable ; ce refus vaut toujours pour un agent qui notifie des clients. Ici, outil de travail interne : Claude Code ne restreint ni `Read`, ni `Bash`, ni `Write` à des chemins ; les instructions le font, et le rapport liste ses sources ;
|
||||
- pas de LLM dans `src/` : la couche déterministe ne change pas ;
|
||||
- vérification par un test à l'aveugle sur PS des Coudres, attendus écrits avant le premier passage (§7 de la spec).
|
||||
|
||||
## D-047 — 2026-10-14 — Agent de diagnostic : rapports courts, preuves en figures, anomalies seules
|
||||
- **Statut** : active. Révise le format du rapport de D-046.
|
||||
- **Décision** :
|
||||
- le rapport ne garde que les anomalies : un écart daté au comportement habituel du capteur ; une même signature, même répétée, fait une seule anomalie ; ce qui dure toute la période (réglage, capteur toujours rejeté, cycle régulier) tient en une ligne dans « Hors anomalie », sans enquête ;
|
||||
- format : un verdict en 2-3 phrases, une section courte par anomalie (constat, figures, une ligne de classification et de preuve, une de réfutation, une d'inconnus), les commandes repliées, sources et inventaire en annexe ; corps en ~40 lignes ;
|
||||
- chaque anomalie est montrée : graphique de la série (fenêtre grisée, capteur témoin) et vignettes des images à pleine résolution autour des capteurs ; un dossier par rapport, `rapport.md` et ses PNG, versionnés ;
|
||||
- outils : `graphique.py` gagne `--zone` et `--sortie` ; nouveau `vignettes.py` (matplotlib), centré sur les colonnes `x` et `y` ;
|
||||
- les deux premiers rapports sont supprimés (historique git).
|
||||
- **Pourquoi** : demande de l'utilisateur, après le premier passage sur PS des Coudres : trop de matériel. Le spécialiste juge le système sain, avec un seul point d'attention, les pics d'erreur de `REF_G` et `REF_D` ; l'agent les avait trouvés, mais noyés parmi trois événements et cinq constats permanents, sans figure dans le rapport. Read réduit une image entière : un petit réflecteur n'y est pas lisible, une vignette à pleine résolution le montre.
|
||||
- **Options écartées** : nommer `REF_G` et `REF_D` dans les instructions (le test ne serait plus à l'aveugle) ; un rapport HTML (le Markdown avec images suffit et reste lisible dans le dépôt) ; les figures dans `out/` (non versionné, le rapport perdrait ses preuves).
|
||||
- **Conséquence** : l'avis du spécialiste devient le cas de référence de l'agent (§7 de `docs/agents/agent-diagnostic.md`) ; des PNG entrent dans le dépôt, quelques centaines de Ko par rapport.
|
||||
Reference in new issue
Block a user