Labels and journal: "Faulty target" renamed "Target issue" everywhere (user: the name was not clear), key cible_degradee -> cible_a_probleme; labels, events, detectors, Status page, labeling tool, documentation and history (D-109)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-03 09:31:18 +01:00
1 parent 6955adf6f5
commit f0ba5b9fcf
38 files changed
+167 -167

No files matched your search

+1 -1
View File
@@ -32,7 +32,7 @@ Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lectur
2. **Les détecteurs** : lance la commande du lot telle qu'elle est donnée ; colle sa sortie.
3. **Comparaison**, événement par événement et étiquette par étiquette, la catégorie d'un événement lue dans sa famille par la correspondance de `familles.md` (un saut bref : la famille de sa cause) : juste ; famille fausse ; en trop (signalé par les détecteurs, sans étiquette : les courbes corrigées n'y montrent rien) ; bornes fausses (en retard, trop tôt, trop large) ; capteurs faux (ceux de l'événement face à ceux que nomme la description) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut. Plusieurs catégories du journal tombent dans une même famille (`visibilite_reduite`, `visibilite_nulle`, `turbulence` dans `visibilite`) : entre elles, l'étiquette ne tranche pas, ce n'est pas un défaut.
4. **Score** : le score avant, en appui de la comparaison.
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop, dis ce que l'étiquette la plus proche en dit, ou qu'aucune ne dit rien de cet instant : le pourquoi revient au detectors-upgrader.
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible à problème, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop, dis ce que l'étiquette la plus proche en dit, ou qu'aucune ne dit rien de cet instant : le pourquoi revient au detectors-upgrader.
## Le fichier
+1 -1
View File
@@ -45,7 +45,7 @@ Une ligne JSON par étiquette, **ajoutée** à la fin de `labeling/auto/<STATION
- `debut`, `fin` : la première et la dernière mesure touchées, au quart d'heure près, UTC, format `AAAA-MM-JJTHH:MMZ`.
- **Une étiquette, un seul événement**, jamais un ensemble d'événements : deux événements, même proches ou mêlés, font deux étiquettes. Un même événement qui se répète (un passage, la pluie de chaque nuit, le déplacement thermique de chaque jour) : une étiquette par fois. Un mouvement dans un sens puis le retour font deux événements, deux étiquettes. Un seul événement qui dure plusieurs jours d'un seul tenant (une montée lente) : une étiquette pour toute sa durée.
- `categorie` : obligatoire, une seule par étiquette : la clé de sa famille dans `labeling/familles.md` (`visibilite`, `obstruction`, `deplacement_thermique`, `deplacement`, `cible_degradee`), en suivant ses frontières ; aucune autre clé.
- `categorie` : obligatoire, une seule par étiquette : la clé de sa famille dans `labeling/familles.md` (`visibilite`, `obstruction`, `deplacement_thermique`, `deplacement`, `cible_a_probleme`), en suivant ses frontières ; aucune autre clé.
- `description` : comme l'expert l'écrirait, en français, **qualitative, sans valeurs chiffrées** : ce qu'on voit (quelles cibles ou références, avec leurs noms exacts, quelles grandeurs, le retour ou non), la cause et **comment tu l'as sue** (vue sur l'image de telle heure, ou déduite des courbes), la conclusion pour le client (rien à faire, données à ne pas croire, mouvement à surveiller). Une cause non établie se dit telle ; ne dis pas plus que ce que tu as vu.
- Le lot entier est lu : un instant sans étiquette veut dire que tu n'y as rien vu.
+1 -1
View File
@@ -74,7 +74,7 @@ aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou abse
- `station` : le nom du dossier de station ; `debut`, `fin` : le lot ; toutes les heures en UTC, au format `AAAA-MM-JJTHH:MMZ`.
- Les bornes d'un moment sont la première et la dernière mesure touchées, au quart d'heure près : un score les compare, mesure par mesure, à celles des détecteurs (D-062). Un saut qui dure (`a_verifier`) : la mesure du saut seule, pas la période décalée qui suit.
- `capteurs` : les noms exacts, tous écrits (pas de « idem », pas de « références ») ; `[]` seulement si tous les capteurs sont touchés.
- `categorie` : la clé de la section 4 de la carte (`visibilite_reduite`…), ou `"aucune"`, seulement pour ce qui ne touche pas les courbes (début d'export, petite bosse d'`error_value` sans rejet ni effet sur `corr`) ; une plage sans aucun export n'est pas étiquetée. Ce qui change les courbes sans explication va dans `a_verifier` (règle de l'utilisateur, D-074 : ne pas alarmer le client) ; une cible constamment problématique (souvent rejetée, collée, qui bascule ou glisse sans cesse) dans `cible_degradee` ; un mouvement de la caméra par la chaleur, compensé, dans `dilatation_thermique` ou `contraction_thermique`.
- `categorie` : la clé de la section 4 de la carte (`visibilite_reduite`…), ou `"aucune"`, seulement pour ce qui ne touche pas les courbes (début d'export, petite bosse d'`error_value` sans rejet ni effet sur `corr`) ; une plage sans aucun export n'est pas étiquetée. Ce qui change les courbes sans explication va dans `a_verifier` (règle de l'utilisateur, D-074 : ne pas alarmer le client) ; une cible constamment problématique (souvent rejetée, collée, qui bascule ou glisse sans cesse) dans `cible_a_probleme` ; un mouvement de la caméra par la chaleur, compensé, dans `dilatation_thermique` ou `contraction_thermique`.
- `evenement` : le « Label du site » de la ligne de la section 1 de la carte qui dit la cause (`"Rain or fog"`, `"Spider web"`), ou `null` si la cause n'est pas établie.
- `preuve` : `"vue"` si les images la montrent, `"deduite"` si elle vient des courbes seules.
- `description` : ta colonne « Ce que je vois », en une ou deux phrases.
+1 -1
View File
@@ -35,7 +35,7 @@ from donnees import charger, instant, iso # noqa: E402
from etiquettes import defauts, vocabulaire # noqa: E402
HISTORIQUE = timedelta(days=3) # comme la commande du lot (D-056)
IGNORER = {"visibilite_nulle", "passage", "cible_masquee", "cible_degradee", "saut_bref"} # zones grisées (carte, section 4)
IGNORER = {"visibilite_nulle", "passage", "cible_masquee", "cible_a_probleme", "saut_bref"} # zones grisées (carte, section 4)
# ponytail: la turbulence est toujours « prudence » : l'étiquette ne dit pas si elle est forte (grisée alors dans le
# journal) ; un champ de force dans les étiquettes si cet écart compte
PRUDENCE = {"visibilite_reduite", "turbulence"}
+1 -1
View File
@@ -17,7 +17,7 @@ Sans `--du --au` : toutes les étiquettes du fichier, et la plage va de la premi
## 2. Comprendre la situation
- **Regroupe** : plusieurs étiquettes d'une même cause (la pluie chaque nuit, le même train, la même cible gênée) font **un** constat, avec ses dates et ses cibles.
- **Classe par ce qui compte pour le client** : `deplacement` (à vérifier), `cible_degradee` (intervenir), `trou` (données absentes), puis `obstruction` et `visibilite` (courbes à ignorer sur leur plage), enfin `deplacement_thermique` (normal).
- **Classe par ce qui compte pour le client** : `deplacement` (à vérifier), `cible_a_probleme` (intervenir), `trou` (données absentes), puis `obstruction` et `visibilite` (courbes à ignorer sur leur plage), enfin `deplacement_thermique` (normal).
- **Réponds à trois questions** : l'ouvrage bouge-t-il ? Peut-on croire les courbes, et quand ne le peut-on pas ? Faut-il faire quelque chose, et quoi ?
- Rien au-delà des étiquettes : chaque phrase du rapport vient d'une ou de plusieurs étiquettes, que tu cites dans la partie interne par leur `debut`. Ce que les étiquettes laissent ouvert (« la nature n'est pas établie ») reste ouvert.