Rework the Diagnosis tab: curves in mm, AI request, link with View; drop the grid (D-054)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-16 17:29:28 +02:00
1 parent 448b0680ca
commit 57dab8e47a
6 files changed
+230 -190

No files matched your search

+31 -37
View File
@@ -1,4 +1,4 @@
# Maquette Explore : onglet Diagnosis (version 0, le cadre)
# Maquette Explore : onglets View et Diagnosis
Spec validée en conversation le 2026-10-16 (D-053). Cas de départ : `cas/2026-10_NORDEND/` (Carrière TROYDO (B), PR17).
@@ -55,45 +55,41 @@ Demande de l'utilisateur, 2026-10-16. Il sépare deux besoins :
## L'onglet Diagnosis
De haut en bas.
Refait le 2026-10-16 avec l'utilisateur. Les rôles se partagent : **View montre ce que voit la caméra** (images, aspect des cibles), **Diagnosis ce que disent les données** (ce qui ne se voit pas à l'œil, comme un déplacement fin), puis l'avis de l'agent de diagnostic sur la plage et les cibles que l'utilisateur pointe. L'image à T et le détail capteur par capteur sont retirés : l'image ferait doublon avec View.
### 1. Image à l'instant T
De haut en bas : les cibles choisies, leurs courbes, la plage, la demande à l'agent.
- L'image de `images/` dont l'heure (nom du fichier, D-045) est la plus proche de T, à 10 min près ; au-delà : « No image at this time ».
- Affichée en pleine résolution (3088 × 2064 px) dans un graphique Plotly (image de fond, axe y inversé), ouverte zoomée sur le cadre des positions médianes des capteurs, 150 px de marge ; zoom et déplacement libres.
- Un marqueur par capteur à sa position brute (`x`, `y`) à T, avec son nom, coloré comme sa case de la grille à T. Pas de position à T : pas de marqueur.
### Grille capteurs × temps (retirée)
### 2. Grille capteurs × temps
La grille de D-053 (une ligne par capteur, une colonne par mesure, couleur = écart au niveau des 24 premières heures en variation d'un pas à l'autre, sur `corr_x`, `corr_y` ou `error_value`) est retirée le 2026-10-16 à la demande de l'utilisateur, qui n'en voyait pas l'intérêt : son écart « en pas » restait abstrait, View montre déjà l'état du système (bande sous le glisseur, cercles colorés selon `error_value`), et les boutons suffisent pour choisir les cibles. Son calcul est dans l'historique git.
- Une ligne par capteur : références `global_ref` (par nom), puis la *local reference* (`ref`), puis les cibles (par nom). Une colonne par instant de mesure de l'export « advanced » (15 min), à la minute.
- Trois boutons de grandeur : `corr_x`, `corr_y`, `error_value` (défaut : `corr_y`).
- Couleur = écart au niveau du début de la fenêtre, en variation d'un pas à l'autre : `(valeur − niveau) / pas`, par capteur et par grandeur, valeurs vides exclues :
- `niveau` : médiane des valeurs des 24 premières heures de la fenêtre (instants avant le premier instant de mesure + 24 h) ;
- `pas` : médiane des écarts absolus entre deux valeurs successives, sur toute la fenêtre (le critère du rapport PR17 de l'agent, qu'un palier ne gonfle pas) ;
- échelle linéaire et symétrique, bleu (négatif), blanc (au niveau), rouge (positif), plafonnée à ±10 : un choix d'affichage, pas un seuil de verdict. Écartée à l'essai : l'échelle « RdBu » de Plotly, dont le milieu gris se confondait avec le gris des cases sans valeur et qui saturait dès ±3,5.
- Case sans valeur (mesure rejetée, donc `corr_x` / `corr_y` vides, ou mesure absente) : grise, sans distinguer les deux en version 0. Aucune valeur dans les 24 premières heures, ou `pas` nul : ligne grise.
- Survol : capteur, instant UTC, valeur brute et écart.
- Vérifié sur NORDEND (`corr_y`, écart médian) : PR17 à 1,7 avant le saut, 23,6 sur le palier, 13,5 après le retour partiel ; PR16, PR18, CTR02 et CTR03 entre 1,6 et 4,1. Écartée : la médiane et la MAD de toute la fenêtre (comme `resume.py`), car le palier de PR17, plus de la moitié de la fenêtre, déplace la médiane : la ligne s'allumait avant le saut (2,3), pas pendant (1,1).
- Limite connue : si les 24 premières heures sont anormales, toute la ligne s'allume ; une dérive lente ou un changement de régime (le tilt à partir du 08/10) s'allume aussi.
### 3. Cibles, courbes et plage
### 3. Liaison
- Clic sur une case : T devient l'instant de sa colonne (un trait vertical le marque dans la grille et dans les détails ouverts ; l'image et ses marqueurs passent à T), et le détail du capteur de sa ligne se déplie sous la grille.
- Clic sur un marqueur de l'image : le détail de ce capteur se déplie, T ne change pas.
- **Cibles choisies** : un bouton par capteur ; un clic ajoute ou retire la cible, et le bouton prend la couleur de ses courbes. Défaut : PR17.
- **Courbes** : déplacement horizontal et vertical **en mm**, puis `error_value`, empilés, même axe de temps, une courbe par cible choisie ; T en trait vertical ; ordonnées recalées sur la plage visible (D-013). Clic sur un point : T à cet instant.
- Déplacements : l'export horaire (`horizontal_displacement`, `vertical_displacement`), en mm comme la page Time Series de la plateforme (« plus parlant », demande de l'utilisateur) ; un point par heure, au début de l'heure, l'heure suisse de l'export convertie en UTC (`Europe/Zurich`). Les références n'y sont pas : leur légende le dit. Vérifié : PR17 passe de +5,4 à −3,5 mm en vertical dans l'heure de 02:00 UTC le 08/10 (le saut de 02:30), et d'environ +5 mm en horizontal.
- `error_value` : l'export « advanced », chaque mesure (15 min), avec le seuil de chaque cible en tirets.
- Écartés : `corr_x` / `corr_y` (px) dans les courbes, moins parlants pour l'utilisateur.
- **Plage** : la fenêtre visible des courbes ; un double-clic revient à toute la période. Affichée en clair, avec T : « Range: … → … UTC · T = … ».
- T de départ : le dernier instant de mesure.
- L'état de départ peut se lire dans l'adresse : `#t=2026-10-08T02:30Z&col=error_value&open=PR17,PR18` (instant T, grandeur, détails dépliés ; une valeur inconnue est ignorée). Sert à la vérification par capture et à partager une vue.
- Adresse : `#tab=diagnosis&t=2026-10-08T02:30Z&open=PR17,PR18` (onglet, instant T, cibles choisies ; une valeur inconnue est ignorée).
### 4. Détail d'un capteur (version 0)
### 4. Demande à l'agent (`Analyze by AI`)
- Un bloc par capteur déplié, refermable (×), plusieurs à la fois, dans l'ordre d'ouverture ; un capteur déjà ouvert ne s'ouvre pas deux fois.
- Deux courbes empilées, même axe de temps : la grandeur choisie dans la grille (valeur brute, pas l'écart), puis `error_value` avec le seuil du capteur (`error_threshold`) en trait. T marqué. Changer de grandeur met à jour les détails ouverts.
- C'est ici que l'on ajoutera, pas à pas, ce que l'utilisateur demandera (brut, témoins, vignettes…).
- Un champ de question facultatif, puis `Analyze by AI` : la page compose la demande à l'agent de diagnostic et l'affiche, avec un bouton `Copy`. Exemple : `@agent-diagnostic vues-deplacements/cas/2026-10_NORDEND/NORDEND/ Cibles : PR17, PR18. Plage : du 2026-10-08T00:00Z au 2026-10-13T00:00Z (UTC). Question : …` (en français, la langue de l'agent ; question par défaut : « Qu'est-ce qui explique le comportement de ces cibles sur cette plage ? »).
- L'agent n'est pas lancé depuis la page, et sa sortie n'y est pas montrée : choix de l'utilisateur, à revoir plus tard (forme du rapport, lancement par un petit serveur local).
- Piste notée : croiser les épisodes annotés par l'expert dans View avec le diagnostic de l'agent sur les mêmes plage et cibles.
### 5. Lien avec View
- En passant d'un onglet à l'autre, l'instant et les cibles suivent : View → Diagnosis emporte l'heure de l'image (mesure la plus proche) et les cibles du gros plan (la cible, puis `Also show`) ; Diagnosis → View emporte T (image la plus proche) et les cibles choisies (la première devient la cible du gros plan, les autres `Also show`).
- Boutons de passage : `Data →` sous le gros plan de View, `Images →` à côté de `Analyze by AI`.
## Fichiers et flux
- `vues-deplacements/maquette/explore.py [dossier de station]` (défaut `vues-deplacements/cas/2026-10_NORDEND/NORDEND/`) :
- lit l'export « advanced » avec `agents/diagnostic/outils/donnees.py` (`charger`, `trouver`, `heure_image`), sans le copier ;
- calcule l'écart de chaque mesure (niveau des 24 premières heures, pas d'une mesure à l'autre), la position médiane de chaque capteur, la liste des images avec leur heure ;
- lit l'export horaire (déplacements en mm, heure suisse convertie en UTC), calcule la position médiane de chaque capteur et liste les images avec leur heure ;
- injecte un JSON dans `explore_template.html` et écrit `out/vues_deplacements_<STATION>.html` (`<STATION>` : nom du dossier), puis l'ouvre (`src/common/page.py`, `open_html`).
- `vues-deplacements/maquette/explore_template.html` : habillage, onglets, plotly.js 4.1.1 par CDN (comme les maquettes existantes), JS de la liaison.
- Images et captures référencées par chemin relatif depuis `out/`, sans copie : la page ne marche que sur ce poste, assez pour une maquette.
@@ -104,19 +100,17 @@ De haut en bas.
Pas de tests automatisés (D-008). Lancer `python3 vues-deplacements/maquette/explore.py`, ouvrir la page et contrôler :
- la ligne de PR17 en `corr_y` allumée à partir du 08/10 02:30, saturée jusqu'au 12/10 23:00, encore nette ensuite (retour partiel), ses voisines et les références pâles ;
- des colonnes allumées pour de nombreux capteurs le 09/10 et le 14/10 en `error_value` ;
- clic sur le 08/10 02:30 : l'image de 02:30 avec le disque sous PR17, les marqueurs sur les réflecteurs ;
- clic sur PR17 : son détail, avec le palier et le seuil 0,4 ;
- View : le glisseur, la comparaison à ±24 h, les cercles colorés selon `error_value` (le 09/10 23:00 : 17 capteurs rejetés), les bandes sous le glisseur, le gros plan de PR17 et ses images d'avant et d'après (la tache change d'aspect le 08/10 à 02:30) ;
- Diagnosis : les courbes de PR17 et PR18, avec le saut de PR17 le 08/10 dans l'heure de 02:00 UTC (environ +5 mm en horizontal, −9 mm en vertical) et les pics d'`error_value` des 09/10 et 14/10 au-dessus du seuil 0,4 ;
- les onglets `Time Series` et `Advanced` montrent les captures.
## État (2026-10-16)
- **Construit** : `explore.py` et `explore_template.html` (plan : `docs/superpowers/plans/2026-10-16-maquette-explore-diagnosis.md`).
- **Vérifié** par des captures Chrome headless (adresse avec `#t=…&col=…&open=…`) : tous les points de « Vérification » ci-dessus, sauf les clics.
- **Pas encore vérifié** : les clics (case, marqueur, changement de grandeur avec détails ouverts, zoom d'un détail), à essayer par l'utilisateur.
- **Suite** : le retour de l'utilisateur sur cette version 0, puis le détail d'un capteur, pas à pas. Piste notée : des marqueurs en anneau plutôt qu'en pastille, pour voir le réflecteur sous chaque capteur.
- **Construit** : `explore.py` et `explore_template.html` : onglets View (images) et Diagnosis (données, demande à l'agent).
- **Vérifié** par des captures Chrome headless (adresse avec `#tab=…&t=…&open=…`, `#img=…&cmp=…&also=…`) : les points ci-dessus.
- **Pas encore vérifié** : les clics et les réglages (glisseur, film, clavier, boutons, zoom des courbes et de la grille, `Analyze by AI`, passage d'un onglet à l'autre), à essayer par l'utilisateur.
- **Suite** : le retour de l'utilisateur ; plus tard, la sortie de l'agent dans la page et les annotations d'épisodes par l'expert.
## Hors version 0
## Hors maquette pour l'instant
Agent dans la page, rapport interactif, vue client, autres cas, données de la base de la plateforme (pan, tilt, roll), export horaire en mm : plus tard, à la demande de l'utilisateur.
Lancement de l'agent depuis la page et affichage de son rapport, annotations d'épisodes, vue client, autres cas, données de la base de la plateforme (pan, tilt, roll), export horaire en mm : plus tard, à la demande de l'utilisateur.