Files
Support-Agent/vues-deplacements/maquette/spec.md
T
2026-10-23 21:52:08 +02:00

22 KiB
Raw Blame History

Maquette Explore : onglets View, Diagnosis, Displacements et Journal

Spec construite en conversation le 2026-10-16 (D-053, puis D-054). Cas de départ : cas/2026-10_NORDEND/ (Carrière TROYDO (B), PR17).

But

Donner au support (l'expert) de quoi diagnostiquer les déplacements sans passer de page en page ; peut-être aussi au client, plus tard. Deux onglets, deux rôles (D-054) :

  • View, ce que voit la caméra : l'aspect des cibles d'une image, d'une heure ou d'un jour à l'autre ;
  • Diagnosis, ce que disent les données, pour ce qui ne se voit pas à l'œil (un déplacement fin), puis l'avis de l'agent de diagnostic sur la plage et les cibles que l'utilisateur pointe.

Au départ (D-053), la version 0 était un cadre : image à T et grille capteurs × temps reliées dans Diagnosis. Elle a été remplie pas à pas avec l'utilisateur, puis réorganisée (D-054).

La page

Maquette de la page Explore de la plateforme, texte en anglais (D-023).

  • Habillage repris de maquettes/user/summary_template.html : barre latérale « AIMsight monitoring », en-tête <nom plateforme> · Explore, sélecteur de dates affiché seulement (inerte). Le nom plateforme est le préfixe du nom de l'export « advanced » (Carrière TROYDO (B)_advanced_… → Carrière TROYDO (B)).
  • Six onglets : Time Series, Advanced, View (ouvert au chargement, ajouté le 2026-10-16 à la demande de l'utilisateur), Diagnosis, Displacements (D-055), Journal (2026-10-23). L'adresse peut choisir l'onglet de départ : #tab=diagnosis, #tab=displacements, #tab=journal.
  • Time Series et Advanced sont un décor : les captures de cas/<cas>/plateforme/ affichées telles quelles, 01 à 03 dans Time Series, 04 et 05 dans Advanced. Elles couvrent le 1/10 au 16/10, les données le 5/10 au 16/10 : écart admis.

L'onglet View

Parcourir les images de images/ une à une, pour voir comment les cibles évoluent : une fonction absente du monitoring. Demande de l'utilisateur, 2026-10-16 : une vue toute simple pour commencer.

  • L'image en grand, son heure UTC en surimpression ; dessous, un glisseur sur toutes les images (une étiquette par jour UTC). Départ : la dernière image.
  • Bandes d'error_value (demande de l'utilisateur, 2026-10-16), sous le glisseur, une colonne par image, dans la couleur des cercles (vert loin du seuil, orange à son approche, rouge au-dessus, gris sans valeur) :
    • en haut, le système entier : moyenne, sur les capteurs mesurés, de error_value / error_threshold du capteur (les seuils vont de 0,3 à 0,7), rouge si elle dépasse 1 ;
    • en bas, la cible du gros plan : son error_value face à son seuil (d'abord en rouge et clair seulement, puis en dégradé).
    • Survol : l'heure, la moyenne du système et le nombre de capteurs au-dessus de leur seuil, la valeur de la cible. Clic : l'image à cet endroit.
    • Boutons Previous rejection / Next rejection : début de l'épisode de rejet (images rejetées consécutives) précédent ou suivant de la cible. À côté, le décompte : PR17, 13 images en 3 épisodes (09/10 vers 09:00 et 23:00, 14/10), le même que dans l'export.
  • ◀ / ▶, flèches du clavier : image précédente ou suivante ; Maj + flèche : même heure la veille ou le lendemain (image la plus proche à 10 min près).
  • Film : Play / barre d'espace, 2, 4 ou 8 images/s ; l'image suivante n'arrive qu'une fois la précédente décodée (2,3 Mo, 3088 × 2064 px) ; arrêt à la dernière.
  • Comparaison : Off, −24 h, +24 h : à droite, l'image la plus proche de la même heure la veille ou le lendemain (mêmes conditions, autre jour), ou « No image at this time » ; elle suit le glisseur et le film.
  • Zoom à la molette autour du pointeur, déplacement à la souris, commun aux deux images ; départ et double-clic : cadre des capteurs (le même que Diagnosis) ; Full image : l'image entière.
  • Une simple balise <img> zoomée en CSS, sans Plotly : changer d'image reste rapide en film.
  • Capteurs (ajoutés le 2026-10-16 à la demande de l'utilisateur, « pour savoir ce qu'on regarde ») : sur chaque grande image, un cercle de 22 px (de l'image) et le nom de chaque capteur, à x, y mesurés à l'heure de cette image ; la cible du gros plan en gras souligné. Case Sensors pour les masquer. Couleur au choix (colored by) :
    • error_value (défaut, demande de l'utilisateur) : la valeur à côté du nom ; vert loin du seuil du capteur (error_threshold), vers l'orange à son approche (teinte linéaire en error_value / seuil, un choix d'affichage), rouge en pointillés au-dessus (mesure rejetée), gris sans valeur ;
    • type : jaune les cibles, bleu les références, orange la local reference. Ils zooment avec l'image ; les noms gardent 12 px à l'écran. Des noms voisins se chevauchent à l'image entière (CTR01 et PR01, PR08 et CTR04) : le zoom les sépare.
  • Adresse : #img=2026-10-08T02:30Z&cmp=-24 (image de départ, comparaison -24 ou 24).
  • Vérifié par captures (image seule, comparaison −24 h le 08/10 02:30 : le disque et la buée sur l'image du 08/10, pas sur celle du 07/10). Pas encore essayés : glisseur, clavier, film, zoom à la souris.

Gros plan d'une cible (sous la vue)

Demande de l'utilisateur, 2026-10-16. Il sépare deux besoins :

  1. L'aspect d'une cible d'une heure ou d'un jour à l'autre (perte de visibilité, obstacle, buée…) : les images servent au diagnostic. C'est ce que fait le gros plan.
  2. Le déplacement d'une cible : les images ne servent que pour un déplacement grossier (cible déplacée ou écrasée). Un déplacement fin, comme le saut de PR17 du 08/10 02:30 (−0,26 px en y), ne se voit pas à l'œil. Pas de vue pour ce besoin.
  • Une liste des capteurs (défaut PR17, ou #target=… dans l'adresse), un demi-côté de cadre (±15, 30 par défaut, 75, 150, 300 px), un pas (15 min, 1 h par défaut, 3 h, 6 h, 1 jour) et un nombre d'images de chaque côté (2, 3 par défaut, 4, 6).
  • Chaque vignette est centrée sur x, y mesurés à sa propre heure (mesure la plus proche, à 10 min près ; les mesures rejetées gardent leurs x, y), pas sur corr, et la page l'écrit. Sans mesure : la position médiane du capteur, signalée sous la vignette. Pixels non lissés.
  • Sous chaque vignette : error 0.65 > 0.4 (error_value à son heure face au seuil du capteur), en rouge au-dessus du seuil.
  • Plusieurs cibles (demande de l'utilisateur, 2026-10-16) : Also show, un bouton par capteur, ajoute ou retire des rangées (#also=PR18,CTR03 dans l'adresse). Les rangées sont groupées par heure : à T, la cible du gros plan puis les autres, l'une sous l'autre ; puis de même à ±24 h si la comparaison est active. Le grand format passe de 300 à 200 px dès deux capteurs. Chaque image n'est chargée qu'une fois pour tous les capteurs. But : voir si une perte de visibilité est locale (une cible : obstacle, salissure) ou commune (toutes : brouillard, pluie).
  • Une rangée par capteur et par image du haut : au centre, en grand (300 px, cadre bleu), l'image du haut ; de part et d'autre, les images d'avant et d'après, au pas choisi (140 px), avec leur décalage (−2 h…) et leur heure. Si la comparaison à ±24 h est active, une seconde rangée fait de même autour de l'image comparée. Clic sur une vignette : l'image du haut passe à son heure.
  • Les rangées suivent le glisseur, le clavier et le film. Pendant le film, seule l'image du centre suit, pour ne pas charger 7 à 26 images de 2,3 Mo à chaque pas ; les autres reviennent à l'arrêt.
  • Essayés puis retirés le 2026-10-16 : un cadre fixe autour de la position des 24 premières heures, avec des repères (position de départ, x, y brut, position corrigée par corr, cochables, et une amplification ×10 de leur écart), et une mosaïque sur une plage from → to. Le déplacement fin ne s'y voyait pas, et les repères embrouillaient la lecture.
  • error_value vérifiée par une capture le 09/10 23:00 (17 mesures rejetées : cercles rouges en pointillés, taches pâles ; la veille, tout vert).
  • Vérifié par une capture (PR17, 08/10 02:30, comparaison −24 h, pas de 1 h : la tache change d'aspect à 02:30, pas la veille). Pas encore essayés : clics, changements de réglage, film.

L'onglet Diagnosis

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.

De haut en bas : les cibles choisies, leurs courbes, la plage, la demande à l'agent.

Grille capteurs × temps (retirée)

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.

Cibles, courbes et plage

  • 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.
  • Adresse : #tab=diagnosis&t=2026-10-08T02:30Z&open=PR17,PR18 (onglet, instant T, cibles choisies ; une valeur inconnue est ignorée).

Demande à l'agent (Analyze by AI)

  • 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.

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.

L'onglet Displacements (D-055)

Ajouté le 2026-10-16 à la demande de l'utilisateur : faire ressortir seules les courbes qui comptent, sans toucher aux données. Ce que le client regarde, ce sont les sauts (décalage soudain qui dure) et les tendances (hausse ou baisse lente), pas les erreurs (docs/displacement/domaine/ce-que-regarde-le-client.md). Idée, méthode, résultats et pistes : ../contexte/detection-d-anomalies.md. Très expérimental : on essaie et on converge pas à pas.

  • Un onglet de la page Explore, après Diagnosis. D'abord construit comme une page à part (entrée Displacements dans la barre latérale), il a été déplacé en onglet à la demande de l'utilisateur, le jour même.
  • Calcul (regime_changes, find_jumps, find_trend dans explore.py), sur l'export horaire en mm, données inchangées ; méthode et résultats dans la note :
    • sauts : changement brutal (2 h) qui dure (24 h), tous ceux de la plage, retours compris ;
    • tendances : dérive lente et régulière des niveaux journaliers, sauts retirés, sur toute la période de l'export (5 jours au moins).
  • Section Jumps : des sauts à moins de 6 h l'un de l'autre, de proche en proche, forment un seul événement (« PR17 alone », « 21 targets together ») : un saut commun n'est pas plusieurs anomalies. Événements dans l'ordre du temps, un tableau par événement (replié au-delà de 4 sauts) : cible, axe, les 2 h du saut, saut, amplitude journalière habituelle, ce qui reste en fin de données par rapport au niveau d'avant ce saut.
  • Section Trends : un tableau : cible, axe, dérive sur la période, par jour, amplitude journalière, nombre de jours, sauts mis de côté.
  • Mise en page (2026-10-19) : la liste (sauts, tendances) à gauche, les courbes à droite, qui restent à l'écran quand la liste défile ; les explications de la détection repliées sous « How they are found ».
  • Courbes : horizontal et vertical en mm, toutes les cibles en gris fin, celles qui ont sauté ou dérivé en couleur par-dessus (l'utilisateur aime : la vue d'ensemble, et le focus par la couleur) ; ordonnées recalées sur la plage visible (D-013) ; légende masquée au-delà de 8 cibles en couleur.
  • Survol d'une ligne (2026-10-19, premier essai, retour de l'utilisateur attendu) : seule la cible de la ligne garde sa couleur, tout le reste passe en gris ;
    • saut : ses 2 h surlignées, les niveaux des 24 h d'avant et d'après (les médianes de la détection) en pointillés, une flèche de l'un à l'autre et le saut en mm ;
    • tendance : sa période surlignée, la droite de Theil-Sen en tirets (alignée sur la courbe brute, sauts remis), les niveaux journaliers en points, le début et la fin marqués avec leur date et leur niveau, la dérive en flèche depuis le niveau de départ ;
    • événement (son titre) : ses cibles en couleur, sa période surlignée ;
    • les échelles ne bougent pas (utilisateur, 2026-10-19) : le survol dessine sur le graphique sans changer l'échelle, sinon on ne sait plus ce qu'on regarde ; premier essai, qui resserrait l'ordonnée sur la tendance, retiré.
    • #focus=j0-1 (événement 0, saut 1), t0 (tendance 0), e0 (événement 0) dans l'adresse : une ligne survolée dès l'ouverture, pour les captures.
  • Clic sur une ligne : l'onglet Diagnosis, sur cette cible à cette heure (fin du saut, ou dernière mesure pour une tendance).
  • Vérifié par captures le 2026-10-16 : NORDEND, deux événements PR17 (08/10 et retour du 12/10) et une tendance (PR06 en horizontal, +0,7 mm) ; PS des Coudres, rien ; CLARIDEN, un événement de 21 cibles. Vérifié en onglet (#tab=displacements) le même jour. Pas encore essayés : le clic vers Diagnosis, le zoom des courbes. Survol vérifié par captures le 2026-10-19 (#focus=…) : NORDEND, les deux sauts de PR17 et la tendance de PR06 ; CLARIDEN, l'événement de 21 cibles ; pas encore essayé à la souris.

L'onglet Journal (2026-10-23)

Le « journal du matin » du client (utilisateur, 2026-10-23) : il ouvre Explore, voit ses courbes sur quelques jours et, dessous, des barres étiquetées qui disent ce qui s'est passé. Un épisode n'est pas un vrai déplacement : c'est un moment où il ne faut pas se fier aux données. On garde toutes les données ; les zones à ignorer sont grisées. Prototype, au plus simple, en attente des retours de l'utilisateur.

  • Détecteurs : un fichier par détecteur dans vues-deplacements/journal/<nom>.py, qui expose detect(mesures) (mesures = donnees.charger(dossier)) et rend des épisodes {start, end, kind, label, text, ignore, sensors} (heures donnees.iso, UTC ; kind = nom du fichier ; ignore vrai = zone grisée ; sensors vide = tous). explore.py (journal) charge tous les fichiers qui ont detect, appelle chacun sur les mesures déjà lues et trie les épisodes par début ; un détecteur qui plante est sauté avec un message, la page se fait quand même.
  • trous.py : les moments sans mesure, cadence de l'export rompue (plus de 2 pas manquants, cadence = écart médian), de la dernière mesure à la suivante ; label No data, pas grisé. Les autres (visibilite, sauts, turbulence, thermique) sont écrits à part.
  • Courbes : Horizontal (px) = corr_x, Vertical (px) = corr_y de l'export « advanced », cibles seules (target et ref, pas les global_ref), lignes fines, axe du temps partagé ; vue de départ : les 3 derniers jours (#from=AAAA-MM-JJ dans l'adresse la fait partir d'un autre jour, pour les captures) ; zoom à la molette ou au cadre sur toute la plage, double-clic pour tout voir ; ordonnées recalées sur la plage visible (D-013).
  • Zones grisées : un rectangle gris sur les deux courbes par épisode ignore.
  • Frise sous les courbes, même axe du temps : une ligne par détecteur (Visibility, Jumps, Turbulence, Thermal, Missing data, puis les autres), seulement ceux qui ont des épisodes ; une barre colorée par épisode, son label dedans s'il tient ; survol : label, texte et capteurs. Un épisode plus court qu'une heure est dessiné sur 1 h, sinon il serait invisible.
  • Journal en texte : les épisodes de la plage visible, dans l'ordre du temps (Oct 14, 23:45 – 05:15 UTC · Poor visibility · <text> (capteurs)), mis à jour à chaque zoom ; Nothing to report on this period. sinon ; clic sur une entrée : les courbes zooment sur l'épisode, avec une marge (la moitié de sa durée, 2 h au moins).
  • Vérifié par captures Chrome headless le 2026-10-23 (#tab=journal, #tab=journal&from=2026-10-07) : NORDEND (cas d'octobre) et NIEDERHORN (data/NIEDERHORN/), avec trous, visibilite et sauts ; courbes, zones grisées, frise, libellés, journal de la plage visible ; le trou de NORDEND (15/10 22:30 → 16/10 01:15) en barre No data.
  • Pas encore vérifié : le clic sur une entrée (zoom), le survol des barres, le zoom à la souris ; turbulence et thermique n'ont rien rendu sur ces deux cas.
  • Corrigé le jour même : un Lasting shift durait jusqu'à la fin des données et sa barre cachait les autres sauts (il finit maintenant avec le saut) ; les couleurs de la frise sont fixes par détecteur (J_COLORS : bleu visibilité, rouge sauts, orange turbulence, vert cycle thermique, gris trous). Vérifié ensuite par captures sur les six jeux, avec les cinq détecteurs.
  • Retour de l'utilisateur (2026-10-23) : encore plus simple, diagnostic catégorique (une catégorie par événement, son processus, les images pour une perte de visibilité) : docs/superpowers/plans/2026-10-23-journal-du-matin.md, partie II.

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 ;
    • 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.
  • Bibliothèque standard côté Python ; ni pandas ni nouvelle dépendance.
  • Identifiants : l'export « advanced » et les captures 01 à 05 n'en contiennent pas ; rien à masquer.

Vérification

Pas de tests automatisés (D-008). Lancer python3 vues-deplacements/maquette/explore.py, ouvrir la page et contrôler :

  • 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 : onglets View (images), Diagnosis (données, demande à l'agent) et Displacements (sauts et tendances, D-055).
  • 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.
  • Cas NORDEND : laissé là le 2026-10-16 ; la démarche et le verdict de l'expert sont dans cas/2026-10_NORDEND/parcours.md.
  • Suite, à la demande de l'utilisateur : son retour sur l'onglet Displacements (il l'essaie, retour dans une prochaine conversation) ; la sortie de l'agent dans la page, les annotations d'épisodes par l'expert (à croiser avec le diagnostic de l'agent), d'autres cas.

Hors maquette pour l'instant

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.