86 lines
9.4 KiB
Markdown
86 lines
9.4 KiB
Markdown
---
|
|
name: analyser-lot
|
|
description: Analyser un lot de données de déplacement comme un expert — lire les courbes et les images, trouver et dater chaque événement, l'étiqueter, dire ce que la base d'events en connaît. Suivi par l'analyste (par /new-event pour les étiquettes d'un event), ou à la main sur un lot ; /events-learner lit désormais les étiquettes de l'etiqueteur (D-112).
|
|
argument-hint: "<dossier> <début> <fin> <fichier de sortie> [commande du lot]"
|
|
---
|
|
|
|
# Analyser un lot
|
|
|
|
Tu lis, comme un expert, un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Ton travail : **l'analyse la plus précise possible** du lot, chaque événement trouvé, daté, rangé dans sa catégorie. Ton analyse est la vérité de la boucle : les détecteurs sont jugés sur elle par le `detectors-critic`, l'`event-builder` y cherche ce qui est nouveau pour la base d'events, et le `tool-builder` y lit les outils dont tu t'es servi pour améliorer les outils de lecture (D-097). Tu ne juges pas les détecteurs. Tu ne modifies rien d'autre que ton fichier, tes étiquettes, tes figures et tes scripts.
|
|
|
|
## La demande
|
|
|
|
Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du lot (sinon : `python3 detectors/categories.py <dossier> --du <jour du début> --au <jour de la fin>`), le chemin de ton analyse. Le dossier de ton analyse est `<dossier de sortie>` ci-dessous.
|
|
|
|
## Ce que tu as le droit de lire, seulement
|
|
|
|
- `.claude/skills/lire-les-donnees/SKILL.md` (lis-le en premier) : tes outils et ta façon de lire ;
|
|
- le dossier de station, par ces outils, et ses images avec Read ;
|
|
- `docs/domaine/colonnes-des-deplacements.md` et `docs/domaine/pieges-des-donnees.md`, que ce skill cite ;
|
|
- `events/carte-des-evenements.md` : ce qui peut arriver, en familles, les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) et les faux amis (section 5) ;
|
|
- la base d'events, ta base de connaissance, quand tu veux, avant ta lecture comme pendant : comme le dit `.claude/skills/read-event/SKILL.md` (`events/INDEX.md`, puis les fiches `event.md` qu'il cite, leurs figures et leurs données). Un event connu est une piste à vérifier sur tes données, pas une conclusion (D-088) ;
|
|
- la sortie des détecteurs, par la commande du lot, quand tu veux : un outil de plus pour trouver et dater les événements (D-090). Ce qu'ils signalent est une piste à vérifier sur les données, pas une conclusion : ce que tu n'y vérifies pas n'entre pas dans ton analyse.
|
|
|
|
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les analyses, critiques et bilans d'autres lots dans `events-learner/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
|
|
|
|
## Tes outils
|
|
|
|
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/analyser-lot/etiquettes.py <dossier> <dossier de sortie>/etiquettes.json`.
|
|
|
|
**Tes propres outils** (D-097) : quand les outils ne montrent pas ce que tu cherches, écris tes scripts, dans `<dossier de sortie>/outils/`. Bibliothèque standard (`csv`, `datetime.fromisoformat`, `statistics`) ; figures par `.venv/bin/python` avec matplotlib, regardées avec Read. Ils lisent les CSV bruts du dossier de station ou passent par `agent-tools/donnees.py`, à ton choix : lire en brut peut montrer une erreur de la lecture commune, que les outils cachent à tous ceux qui lisent par eux. Lance-les depuis la racine du dépôt ; ils n'écrivent que dans ton dossier de sortie (ni `agent-tools/`, ni les skills, ni les données). Une sortie trop longue se range dans un fichier de ce dossier et se lit par `grep`, `head`, `tail` ou `sed -n`.
|
|
|
|
## Déroulé
|
|
|
|
0. **Tes données.** `inventaire.py` sur le lot (`--debut`, `--fin`) : les sources, ce que contient chacune (colonnes remplies ou vides, métriques système, images), la cadence, les capteurs. Comprends-les avant de chercher des événements : le sens des colonnes (`colonnes-des-deplacements.md`) ; une colonne remplie ou une source que les outils ne montrent pas, regarde-la par tes scripts si elle peut servir à ton analyse.
|
|
1. **Ta lecture.** Lis le lot comme le dit `lire-les-donnees`, avec la carte, la base et les détecteurs si tu veux, et tes scripts. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
|
|
2. **Tes étiquettes** (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
|
|
3. **Events connus** : les events de la base proches de tes moments (`read-event` : l'index, puis au plus 3 fiches), consultés avant ou maintenant. Ce que la base connaît déjà, events « (appris) » compris.
|
|
4. **Tes outils** : chaque outil dont tu t'es servi pour ton analyse, existant ou à toi (section 3 du fichier).
|
|
|
|
## Le fichier
|
|
|
|
Écris-le exactement sur ce plan.
|
|
|
|
```markdown
|
|
# Lot NN : <STATION>, <début> → <fin> (UTC)
|
|
|
|
## 1. Ma lecture
|
|
| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images | Catégorie |
|
|
|
|
## 2. Events connus
|
|
|
|
## 3. Outils
|
|
| Outil | Existant ou à moi | Pour quoi (moment, question) | Ce qu'il a montré | Ce qui a manqué ou encombré |
|
|
|
|
## Difficultés
|
|
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
|
|
|
|
## Sources lues
|
|
```
|
|
|
|
« Ce que je vois » porte ce qu'un autre doit savoir pour juger les détecteurs sans voir les données, ou pour en faire un event : la forme, l'ampleur face au niveau habituel, le retour ou non, les capteurs témoins intacts, la caméra. « Outils » sert au `tool-builder`, qui ne voit que ce tableau, tes scripts et le lot : une ligne par outil qui t'a servi, existant (sa commande, ses options) ou à toi (le chemin de ton script, ce qu'il calcule, et dans « Ce qui a manqué ou encombré », pourquoi les outils existants ne suffisaient pas) ; « Ce qui a manqué ou encombré » : ce qu'il ne montrait pas, une sortie trop longue, une figure illisible, une option que tu as dû deviner ; « rien » sinon. « Difficultés » ne parle que du processus (consignes, chemins, commandes), pas des données, des détecteurs ni des outils de lecture : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
|
|
|
|
## Les étiquettes
|
|
|
|
`<dossier de sortie>/etiquettes.json` : ta lecture sous une forme qu'un script relit, pour entraîner plus tard un modèle (D-061). Le lot entier est lu : un instant sans moment veut dire que tu n'y as rien vu.
|
|
|
|
```json
|
|
{"station": "NORDEND", "debut": "2026-10-05T00:00Z", "fin": "2026-10-09T00:00Z", "moments": [
|
|
{"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "capteurs": ["PR01", "PR08", "PR02"],
|
|
"categorie": "visibilite_reduite", "evenement": "Rain or fog", "preuve": "vue",
|
|
"description": "Gouttes floues sur la vitre ; PR01 et PR08 rejetés.", "apres_detecteurs": false}]}
|
|
```
|
|
|
|
- `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_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.
|
|
- `apres_detecteurs` : `true` pour un moment que tu as trouvé grâce aux détecteurs (vu dans leur sortie, puis vérifié dans les données), `false` sinon.
|
|
|
|
## Ta réponse
|
|
|
|
Après avoir écrit le fichier, réponds en 2 lignes : le nombre de moments (étiquettes), le chemin du fichier.
|