Note what DIFF and IRON camera images are, keep --diff optional (point 28)

The station manual says the DIFF image is the contrast-enhanced view of the
reflectors that the displacement algorithm measures, not a difference between
two instants. The reading tools only look at IRON images, so run.md describes
--diff as an option instead of putting it in the pump command.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-26 12:27:20 +01:00
1 parent add165dc38
commit 0c8c90d1d5
5 files changed
+24 -4

No files matched your search

+1 -1
View File
@@ -111,7 +111,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question. - `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. - `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. - `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
- `colonnes-des-deplacements.md` : colonnes des déplacements, d'après la FAQ et dans les exports reçus (« advanced » 15 min, horaire). - `colonnes-des-deplacements.md` : colonnes des déplacements, d'après la FAQ et dans les exports reçus (« advanced » 15 min, horaire) ; `images-de-la-camera.md` : images IRON (la scène) et DIFF (les réflecteurs, l'image mesurée).
- `docs/energy/` : le domaine Energy. - `docs/energy/` : le domaine Energy.
- `analyses/<règle>.md` (80-120 l) : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, pistes, historique). Modèle : `.claude/skills/nouvelle-analyse/modele-fiche.md`. - `analyses/<règle>.md` (80-120 l) : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, pistes, historique). Modèle : `.claude/skills/nouvelle-analyse/modele-fiche.md`.
- `domaine/` (< 80 l) : `comment-se-comporte-la-batterie.md` (LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité) ; `tensions-selon-l-etat-de-la-batterie.md` (tensions et pentes en charge, pleine charge et décharge) ; `cas-annotes-par-l-expert.md` (diagnostics experts des 5 stations, vérité de référence). - `domaine/` (< 80 l) : `comment-se-comporte-la-batterie.md` (LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité) ; `tensions-selon-l-etat-de-la-batterie.md` (tensions et pentes en charge, pleine charge et décharge) ; `cas-annotes-par-l-expert.md` (diagnostics experts des 5 stations, vérité de référence).
+19
View File
@@ -0,0 +1,19 @@
# Images de la caméra : IRON et DIFF
La plateforme garde deux types d'images par mesure (type de mesure), que le pompage range à part (`extraction/pomper.py`).
- **IRON** (`OPTICAL_SHIFT-IRON`, dans `images/`) : l'image classique de la scène, en JPG, ~1 Mo (NORDEND). C'est sur elle qu'on voit la cause d'un événement (buée, pluie, train, neige). Le nom vient sans doute de « IR on » (prise sous l'éclairage infrarouge) : déduction, la doc ne le dit pas.
- **DIFF** (`OPTICAL_SHIFT-DIFF`, dans `images_diff/`, option `--diff`) : l'image « différentielle ». D'après le manuel de la station (*AIMsight Test Manual*, « Choosing Between Single and Differential Acquisition »), elle **combine plusieurs prises** pour renforcer le contraste des réflecteurs (« *contrast-enhanced view of the reflectors* ») et c'est **l'image que mesurent les algorithmes de déplacement, par défaut**. Ce n'est **pas** la différence entre deux instants. PNG 16 bits, 3088×2064, ~7 Mo (NORDEND).
## Modes d'acquisition (manuel de la station)
- « Single with infrared light » : une image sous infrarouge par mesure, pour les mesures dynamiques.
- « Differential » : plusieurs images combinées, pour le suivi quasi statique ; `Stacking` de 20 à 40 si la lumière est difficile ou les cibles peu réfléchissantes (portée meilleure, cadence plus basse).
- Option « Work on IRON images » : mesurer sur l'image classique, pour suivre une texture quand il n'y a pas de réflecteur.
## Ce qu'on en sait
- NORDEND a des images DIFF, une par heure au pompage (~160 Mo par jour) ; les autres stations : inconnu.
- Le 29/07 à NORDEND (C-002, toile d'araignée selon l'expert), l'image DIFF montre de longues traînées claires sur tout le champ et les cibles en points, là où l'image IRON ne montre que de faibles bandes sombres. Ce qui est tout près de l'objectif y ressort peut-être mieux : à confirmer (point 28 du plan du journal du matin).
- Les outils de lecture (`agents/diagnostic/outils/donnees.py`), donc `/aiguiser` et `/boucle`, ne regardent que les images IRON et écartent `images_diff/`.
- Piste, non vérifiée : si `x`, `y` sont mesurés sur l'image DIFF, un centroïde pris sur l'image IRON peut s'en écarter (écart constant par capteur vu sur NORDEND, `colonnes-des-deplacements.md`).
@@ -759,7 +759,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
### Point 28 : Images différentielles ### Point 28 : Images différentielles
**Ce qui existe.** Type de mesure `OPTICAL_SHIFT-DIFF`, en PNG, seulement sur les stations réglées en mode « Differential » ; lesquelles et à quelle cadence : inconnu. Le script les prend avec `--diff`, rangées dans `images_diff/`. **Ce qui existe.** Type de mesure `OPTICAL_SHIFT-DIFF`, en PNG, seulement sur les stations réglées en mode « Differential » ; lesquelles et à quelle cadence : inconnu. Le script les prend avec `--diff`, rangées dans `images_diff/`. D'après le manuel de la station, ce n'est pas la différence entre deux instants mais l'image des réflecteurs, contraste renforcé, celle que mesure l'algorithme par défaut (`docs/domaine/images-de-la-camera.md`). L'utilisateur les juge peu utiles pour `/boucle` et `/aiguiser` (2026-10-26) : `--diff` reste une option, hors de la commande de `run.md`.
**Étapes.** **Étapes.**
- [ ] Au premier pompage avec `--diff`, compter les images différentielles par jour ; si une station en a, en regarder quelques-unes avec l'utilisateur ; NORDEND en a (2026-10-26) : 24 par jour à une par heure, PNG 16 bits 3088×2064, ~7 Mo l'une ; le 29/07, pendant C-002 (toile d'araignée selon l'expert), de longues traînées claires sur tout le champ et les cibles en points, là où l'image brute ne montre que de faibles bandes sombres ; à confirmer par l'utilisateur : montrent-elles ce qui a changé (toile, eau, neige) mieux que l'image brute ? - [ ] Au premier pompage avec `--diff`, compter les images différentielles par jour ; si une station en a, en regarder quelques-unes avec l'utilisateur ; NORDEND en a (2026-10-26) : 24 par jour à une par heure, PNG 16 bits 3088×2064, ~7 Mo l'une ; le 29/07, pendant C-002 (toile d'araignée selon l'expert), de longues traînées claires sur tout le champ et les cibles en points, là où l'image brute ne montre que de faibles bandes sombres ; à confirmer par l'utilisateur : montrent-elles ce qui a changé (toile, eau, neige) mieux que l'image brute ?
@@ -1115,3 +1115,4 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
- 2026-10-26 : point 43 : mouvements de la caméra ajoutés au pompage (demande de l'utilisateur) : `camera/`, un CSV par jour, une ligne par mesure ; essayé sur le 30/07 de NORDEND (70 poses sur 95 instants, `sigma0` sur 7 seulement, comme l'export). - 2026-10-26 : point 43 : mouvements de la caméra ajoutés au pompage (demande de l'utilisateur) : `camera/`, un CSV par jour, une ligne par mesure ; essayé sur le 30/07 de NORDEND (70 poses sur 95 instants, `sigma0` sur 7 seulement, comme l'export).
- 2026-10-26 : point 31 : préparer la séance sur NORDEND de septembre (idée de l'utilisateur) : aucun lot à créer, `/boucle` les découpe ; restent l'historique (29 au 31/08), les images, garder `out/pompage/NORDEND/`, choisir les lots sur le tri gratuit du mois. - 2026-10-26 : point 31 : préparer la séance sur NORDEND de septembre (idée de l'utilisateur) : aucun lot à créer, `/boucle` les découpe ; restent l'historique (29 au 31/08), les images, garder `out/pompage/NORDEND/`, choisir les lots sur le tri gratuit du mois.
- 2026-10-26 : point 42 : l'utilisateur fait passer `/aiguiser` avant `/boucle`, sur NORDEND du 01 au 04/09 (données nombreuses) ; constats des outils actuels sur ces jours (graphique illisible à 22 capteurs, inventaire de 880 lignes sur un dossier pompé) ; séance à lancer par l'utilisateur quand les images seront là. - 2026-10-26 : point 42 : l'utilisateur fait passer `/aiguiser` avant `/boucle`, sur NORDEND du 01 au 04/09 (données nombreuses) ; constats des outils actuels sur ces jours (graphique illisible à 22 capteurs, inventaire de 880 lignes sur un dossier pompé) ; séance à lancer par l'utilisateur quand les images seront là.
- 2026-10-26 : point 28 : sens des images DIFF et IRON lu dans le manuel de la station (DIFF : les réflecteurs, contraste renforcé, l'image mesurée ; IRON : la scène), noté dans `docs/domaine/images-de-la-camera.md` ; l'utilisateur les juge peu utiles pour `/boucle` et `/aiguiser` : `--diff` sorti de la commande de `run.md`, gardé en option.
+1 -1
View File
@@ -9,7 +9,7 @@ Dans le terminal du dev container de l'appli (VS Code sur `~/monitoring-dashboar
- `<SERIE>` : numéro de série du système, celui de l'URL de la page System (`/explore/system/<SERIE>`), par exemple `NORDEND` ; plusieurs stations : `<SERIE1> <SERIE2>`. - `<SERIE>` : numéro de série du système, celui de l'URL de la page System (`/explore/system/<SERIE>`), par exemple `NORDEND` ; plusieurs stations : `<SERIE1> <SERIE2>`.
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu ; commencer 3 jours avant la période voulue (historique du journal). Le jour en cours n'est jamais pompé. - `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu ; commencer 3 jours avant la période voulue (historique du journal). Le jour en cours n'est jamais pompé.
- Sortie : `out/pompage/<SERIE>/` (métriques, `displacement/`, `camera/`, `images/`). - Sortie : `out/pompage/<SERIE>/` (métriques, `displacement/`, `camera/`, `images/`).
- Options : `--diff` ajoute les images différentielles (~160 Mo par jour) ; `--every 10` une image toutes les 10 min (`0` : toutes) ; sans `--images`, pas d'images. - Options : `--diff` ajoute les images différentielles dans `images_diff/` (PNG 16 bits, ~7 Mo l'une contre ~1 Mo en JPG, ~160 Mo par jour ; ignorées par les outils de lecture) ; `--every 10` une image toutes les 10 min (`0` : toutes) ; sans `--images`, pas d'images.
- Relancer la même commande ne récupère que ce qui manque (jour en échec, plage élargie, option ajoutée). - Relancer la même commande ne récupère que ce qui manque (jour en échec, plage élargie, option ajoutée).
Détails : `extraction/README.md`. Détails : `extraction/README.md`.
@@ -57,7 +57,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
## Idées gardées pour plus tard ## Idées gardées pour plus tard
- Vignettes et GIF des images d'un épisode, dans le journal. - Vignettes et GIF des images d'un épisode, dans le journal.
- Images différentielles (si la plateforme les a), pour voir ce qui a changé. - Images différentielles (`OPTICAL_SHIFT-DIFF`) : pas « ce qui a changé » entre deux instants, mais l'image des réflecteurs, contraste renforcé, celle que mesure l'algorithme (`docs/domaine/images-de-la-camera.md`) ; jugées peu utiles pour `/boucle` et `/aiguiser` (utilisateur, 2026-10-26) ; point 28 du plan.
- D'autres métriques existent sur certains projets : un agent pourrait les passer en revue quand les données seront récupérées en masse. - D'autres métriques existent sur certains projets : un agent pourrait les passer en revue quand les données seront récupérées en masse.
- Effet périodique étiqueté comme tel (« periodic effect »), jugé encore poussé. - Effet périodique étiqueté comme tel (« periodic effect »), jugé encore poussé.
- Un cas de la base pour chaque catégorie de la carte, quand l'utilisateur les apporte. - Un cas de la base pour chaque catégorie de la carte, quand l'utilisateur les apporte.