Files
Support-Agent/detector-learner/2026-11-03T1317Z_BREITHORN/modification-2.md
T
2026-11-03 14:34:48 +01:00

120 lines
12 KiB
Markdown

# Lot 01 : modification 2
## Ce qui a changé
Ce passage suit la consigne de l'utilisateur : aligner `detectors/` sur les étiquettes et leurs familles (`labeling/familles.md`), à la place des repères obsolètes (base d'events, carte des événements, points du plan). Il suit aussi les remarques 1 et 2 du contrôle 1. Aucune catégorie n'est ajoutée ni renommée ; le contrat `detect(mesures)` et les clés des épisodes ne changent pas.
- `detectors/categories.py`
- **Docstring** : réécrite. Elle renvoie à `labeling/familles.md` comme référence : sa section « Correspondance » fait foi, et `score.py` la lit. Elle ne renvoie plus à `events/carte-des-evenements.md` ni aux points du plan. Ses règles (absorption, saut qui dure, turbulence, `MERGE`) sont listées une par une.
- **`CATEGORIES`** : chaque catégorie reçoit un champ `famille`, la famille de la correspondance de `familles.md`. `saut_bref` a `None` : il prend la famille de sa cause. J'ai vérifié que le champ est identique à `score.familles()` pour les douze catégories.
- **`saut_bref` sans hôte** : il n'est plus grisé (`ignore` passe de `True` à `False`). Sa phrase change :
- avant : « … jumped and came back. This is not a movement: ignore it. »
- après : « … jumped and came back. The cause is not established: look at the images. »
- **Saut absorbé par un hôte** : la phrase ajoutée change.
- avant : « The jump(s) … is (are) not a movement(s). »
- après : « … has (have) the same cause. »
- **Commentaires** : ceux de `HOSTS` et de `MERGE` ne citent plus de points du plan ; « l'analyste » devient « la critique ».
- `detectors/sauts.py`
- le texte de l'épisode « Sudden jump, back to normal » change :
- avant : « most likely a measurement artefact, not a movement »
- après : « the cause is not established, look at the images »
- le point 2 de la docstring dit que la cause d'un saut revenu vient de la catégorie qui le chevauche, à défaut des images. Aucune constante ne change.
- `detectors/visibilite.py` : une règle nouvelle et une constante, `QUELQUES = 3`.
- La règle : une Poor visibility qui ne touche qu'au plus `QUELQUES` cibles, et aucune référence (`global_ref`), devient un épisode « Target obscured » sur toute sa durée, sans niveau. `categories.py` la range en `cible_masquee`, famille obstruction.
- Le point 7 de la docstring décrit la règle.
- `vues-deplacements/contexte/seuils-du-journal.md` : la ligne `QUELQUES` est ajoutée.
## Pourquoi
- `familles.md` dit qu'un saut puis le retour prend la famille de sa cause, et qu'il relève de Displacement, à vérifier, quand sa cause n'est pas établie. Le journal affirmait au contraire « not a movement: ignore it » pour tout saut revenu, même sans cause (remarque 2 du contrôle).
- `familles.md` sépare Visibility, une gêne diffuse qui touche la scène, d'Obstruction, un objet qui cache une ou quelques cibles. Or une perte de visibilité qui ne touche que deux ou trois cibles, et pas les références, était dite « Reduced visibility ». Elle est désormais dite cible cachée.
- `categories.py` renvoyait à la carte des événements et aux points du plan, sources que les agents suivaient encore. Elle renvoie maintenant aux familles (remarque 1).
## Avant / après sur le lot
Avant (identique à la sortie du passage 1) :
```
2026-10-03T04:00Z → 2026-10-04T16:00Z cible_masquee grisé | degradee | 3 capteurs | absorbés : degradee 10-03T04:00, degradee 10-03T04:00
2026-10-03T04:00Z → 2026-10-04T16:00Z visibilite_reduite gardé | visibilite | 14 capteurs | absorbés : sauts 10-04T16:00
2026-10-06T20:00Z → 2026-10-07T04:00Z visibilite_reduite gardé | visibilite | 3 capteurs | absorbés : —
2026-10-07T20:00Z → 2026-10-07T20:00Z saut_bref grisé | sauts | 1 capteurs | absorbés : —
2026-10-08T00:00Z → 2026-10-08T00:00Z saut_bref grisé | sauts | 1 capteurs | absorbés : —
2026-10-09T00:00Z → 2026-10-09T04:00Z saut_bref grisé | sauts | 1 capteurs | absorbés : —
2026-10-09T20:00Z → 2026-10-09T20:00Z passage grisé | visibilite | 3 capteurs | absorbés : —
2026-10-10T04:00Z → 2026-10-10T04:00Z saut_bref grisé | sauts | 8 capteurs | absorbés : —
2026-10-13T04:00Z → 2026-10-13T04:00Z passage grisé | visibilite | 5 capteurs | absorbés : sauts 10-13T04:00
2026-10-15T20:00Z → 2026-10-16T12:00Z trou gardé | trous | tous les capteurs | absorbés : —
2026-10-21T20:00Z → 2026-10-21T20:00Z a_verifier gardé | sauts | 1 capteurs | absorbés : —
2026-10-21T20:00Z → 2026-10-22T04:00Z visibilite_reduite gardé | visibilite | 2 capteurs | absorbés : —
2026-10-22T00:00Z → 2026-10-22T04:00Z cible_masquee grisé | degradee | 1 capteurs | absorbés : —
2026-10-22T08:00Z → 2026-10-22T08:00Z a_verifier gardé | sauts | 1 capteurs | absorbés : —
2026-10-22T20:00Z → 2026-10-23T04:00Z cible_masquee grisé | degradee | 1 capteurs | absorbés : —
2026-10-22T20:00Z → 2026-10-23T04:00Z visibilite_reduite gardé | visibilite | 2 capteurs | absorbés : —
2026-10-23T20:00Z → 2026-10-25T20:00Z cible_masquee grisé | degradee | 2 capteurs | absorbés : degradee 10-24T04:00
2026-10-23T20:00Z → 2026-10-23T20:00Z a_verifier gardé | sauts | 2 capteurs | absorbés : —
2026-10-23T20:00Z → 2026-10-26T04:00Z visibilite_reduite gardé | visibilite | 7 capteurs | absorbés : sauts 10-26T00:00
2026-10-26T16:00Z → 2026-10-27T04:00Z cible_masquee grisé | degradee | 2 capteurs | absorbés : visibilite 10-26T20:00
2026-10-26T20:00Z → 2026-10-26T20:00Z saut_bref grisé | sauts | 1 capteurs | absorbés : —
2026-10-29T20:00Z → 2026-10-30T00:00Z saut_bref grisé | sauts | 2 capteurs | absorbés : —
```
Après (aucune ligne `sauté`) :
```
2026-10-03T04:00Z → 2026-10-04T16:00Z cible_masquee grisé | degradee | 3 capteurs | absorbés : degradee 10-03T04:00, degradee 10-03T04:00
2026-10-03T04:00Z → 2026-10-04T16:00Z visibilite_reduite gardé | visibilite | 14 capteurs | absorbés : sauts 10-04T16:00
2026-10-06T20:00Z → 2026-10-07T04:00Z cible_masquee grisé | visibilite | 3 capteurs | absorbés : —
2026-10-07T20:00Z → 2026-10-07T20:00Z saut_bref gardé | sauts | 1 capteurs | absorbés : —
2026-10-08T00:00Z → 2026-10-08T00:00Z saut_bref gardé | sauts | 1 capteurs | absorbés : —
2026-10-09T00:00Z → 2026-10-09T04:00Z saut_bref gardé | sauts | 1 capteurs | absorbés : —
2026-10-09T20:00Z → 2026-10-09T20:00Z passage grisé | visibilite | 3 capteurs | absorbés : —
2026-10-10T04:00Z → 2026-10-10T04:00Z saut_bref gardé | sauts | 8 capteurs | absorbés : —
2026-10-13T04:00Z → 2026-10-13T04:00Z passage grisé | visibilite | 5 capteurs | absorbés : sauts 10-13T04:00
2026-10-15T20:00Z → 2026-10-16T12:00Z trou gardé | trous | tous les capteurs | absorbés : —
2026-10-21T20:00Z → 2026-10-21T20:00Z a_verifier gardé | sauts | 1 capteurs | absorbés : —
2026-10-21T20:00Z → 2026-10-22T04:00Z cible_masquee grisé | visibilite | 2 capteurs | absorbés : degradee 10-22T00:00
2026-10-22T08:00Z → 2026-10-22T08:00Z a_verifier gardé | sauts | 1 capteurs | absorbés : —
2026-10-22T20:00Z → 2026-10-23T04:00Z cible_masquee grisé | degradee | 2 capteurs | absorbés : visibilite 10-22T20:00
2026-10-23T20:00Z → 2026-10-25T20:00Z cible_masquee grisé | degradee | 2 capteurs | absorbés : degradee 10-24T04:00
2026-10-23T20:00Z → 2026-10-23T20:00Z a_verifier gardé | sauts | 2 capteurs | absorbés : —
2026-10-23T20:00Z → 2026-10-26T04:00Z visibilite_reduite gardé | visibilite | 7 capteurs | absorbés : sauts 10-26T00:00
2026-10-26T16:00Z → 2026-10-27T04:00Z cible_masquee grisé | degradee | 2 capteurs | absorbés : visibilite 10-26T20:00
2026-10-26T20:00Z → 2026-10-26T20:00Z saut_bref gardé | sauts | 1 capteurs | absorbés : —
2026-10-29T20:00Z → 2026-10-30T00:00Z saut_bref gardé | sauts | 2 capteurs | absorbés : —
```
Changements :
- 06.10 20:00 → 07.10 04:00 : `visibilite_reduite` devient `cible_masquee`, mêmes 3 cibles, mêmes bornes.
- 21.10 20:00 → 22.10 04:00 : `visibilite_reduite` devient `cible_masquee` et se fond avec le `cible_masquee` de `degradee`, 2 cibles.
- 22.10 20:00 → 23.10 04:00 : les deux événements de la nuit ne font plus qu'un `cible_masquee`, 2 cibles.
- Les `saut_bref` sans hôte passent de « grisé » à « gardé ».
## Score
BREITHORN, lot 01 (avant → après) :
```
obstruction 41/71 (58 %) → 45/71 (63 %) 41/41 (100 %) → 45/45 (100 %)
visibilite — 0/34 (0 %) → 0/25 (0 %)
```
Les familles deplacement et trou ne changent pas.
## Non-régression
`python3 .claude/skills/detector-learner/regression.py` : aucune ligne `sauté`. Les blocs de JUNGFRAU, MICHIGAN, NEBRASKA, NORDEND et WILDSTRUBEL ne changent pas, ligne pour ligne. BREITHORN change comme le score ci-dessus.
Les lignes changées du bloc `Total`, avant → après :
```
obstruction 148/371 (40 %) → 152/371 (41 %) 148/508 (29 %) → 152/512 (30 %)
visibilite 145/458 (32 %) (inchangé) 145/448 (32 %) → 145/439 (33 %)
```
Pour information, `benchmark.py` sur la base d'events est inchangé, sauf la ligne de version.
## Pas corrigé
- **S1, la dérive lente à une mesure toutes les 4 h, et S2, les écarts de la caméra sur quelques mesures** : toujours la contradiction entre stations, décrite dans la modification 1. Sur MICHIGAN et NEBRASKA, l'étiqueteur range les mêmes formes en `deplacement_thermique`, parce qu'il voit la température. `detect(mesures)` ne la reçoit pas. C'est à trancher par l'utilisateur ; le correctif de S1 est dans `modification-1.md`.
- **Remarque 2, « vers la famille deplacement »** : seule la phrase et le grisé suivent `familles.md`, la catégorie `saut_bref` reste. Classer un saut revenu sans hôte en `a_verifier` ferait reculer l'obstruction sur BREITHORN : les sauts des cibles en partie cachées (L5, L6, L17, L21) y sont des sauts sans hôte, sous des étiquettes obstruction. Le `0/14` de `saut_bref` sur JUNGFRAU vient de `score.py`, hors de `detectors/` : un saut bref qu'aucune étiquette ne couvre reste dans la famille « saut_bref », au lieu d'aller en deplacement.
- **Remarque 3, la dérive de JUNGFRAU sur toute la fenêtre** : `derive` est le seul détecteur de `derive_lente`, il ne peut donc pas être retiré (D-074). Je n'ai pas trouvé de critère général pour la resserrer qui ne demande pas la température, la même difficulté que pour S1.
- **Ce qui reste en `visibilite_reduite` sur le lot** :
- le 03-04.10 : 14 capteurs, dont 2 références ;
- le 23-26.10 : 5 cibles et 2 références cachées.
Ces deux événements touchent des références, et la règle `QUELQUES` les laisse en visibilité pour ne pas prendre une buée sur les références pour un objet. Le 03-04.10 a déjà son `cible_masquee` juste.
- **Les sauts des cibles en partie cachées sortent en `a_verifier`** (21.10, 22.10, 23.10) : hors des suggestions, non traité.
- **`visibilite_reduite` reste « gardé, use with care »**, alors que `familles.md` dit pour Visibility « ne pas croire les courbes ». C'est le niveau réduit du point 38, validé par l'utilisateur : je ne l'ai pas touché.
## Difficultés
- La consigne de l'utilisateur, « adapter `detectors/`, aligné sur les étiquettes et les familles », est large. Je l'ai lue à travers les trois remarques du contrôle et la frontière « Visibility ou Obstruction » de `familles.md`, sans réécrire les docstrings historiques des autres détecteurs (`Résultats … vérité : events/INDEX.md` dans `visibilite.py`, `sauts.py`, `turbulence.py`).
- Le gabarit du rendu demande la ligne `total toutes` du benchmark des events. Elle n'existe pas dans `regression.py` ; j'ai donné les lignes changées du bloc `Total`.