- analyste: the most precise analysis of the batch, detectors allowed as a tool; reading, labels, known events, novelties in analyse.md; skill critiquer-lot renamed analyser-lot. - detectors-critic: compares the detectors to the analysis event by event, without looking at the data; verdict and at most two suggestions in critique.md, read by the detectors-upgrader. - /boucle step 2, builder, review page, /new-event and score.py import follow. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
167 lines
22 KiB
Markdown
167 lines
22 KiB
Markdown
# CLAUDE.md
|
||
|
||
Carte du projet, chargée à chaque session : ce qui existe et où, pas le détail (D-012, D-028). Elle reste sous 200 lignes ; le reste se lit à la demande, et seulement la partie utile (« Lire sans saturer le contexte »).
|
||
|
||
## Projet
|
||
|
||
Diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et son propre mouvement est compensé grâce à des cibles de référence. Le projet analyse les séries temporelles des stations avec des **méthodes analytiques (pas de LLM)**, détecte les anomalies et explique chacune (preuves calculées, puis ce qui reste non établi) **avant** que le client ne pose la question. Des agents Claude Code s'y ajoutent pour lire les données, améliorer les détecteurs et répondre au support. Langage : **Python** ; cible idéale du calcul : le système embarqué de la station.
|
||
|
||
Cadrage du product owner : sous-projet G, santé des sites et notifications au client (`docs/aimsight/AIMsight_handoff_G_site_health.md`). Sa dernière section liste les écarts de ce dépôt, à arbitrer par l'utilisateur.
|
||
|
||
## État et prochaine étape (au 2026-10-28)
|
||
|
||
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des events de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
|
||
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
|
||
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/boucle` (D-057) et `/aiguiser` (D-059), base d'events `events/` revue par `/review-event` (D-075). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||
- **Support** (D-079) : `/support <mail>` répond à la question d'un client, et à elle seule. Premier cas : LENZSPITZE, nuit du 26 au 27.10.
|
||
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
|
||
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
|
||
- **Prochaine étape** :
|
||
- journal du matin : les points ouverts du plan vivant, sur les consignes de l'utilisateur ; un point validé n'est plus repris ;
|
||
- les écarts du handoff, dont « consistent with » face aux phrases catégoriques du journal, quand l'utilisateur les arbitre ;
|
||
- Cellular, Storage, Temperature : les réponses du spécialiste (`docs/<domaine>/domaine/questions-pour-l-expert.md`, pour Temperature la question 1 de `point-de-depart.md`), puis corrections et guides.
|
||
|
||
## Analyses des domaines système
|
||
|
||
Code dans `src/<domaine>/`, fiche vivante dans `docs/<domaine>/analyses/<règle en minuscules>.md`.
|
||
|
||
| Domaine | Règle | Question | Statut | Code |
|
||
|---|---|---|---|---|
|
||
| energy | `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | livrée (D-020) | `battery_state.py` |
|
||
| energy | `DAILY_BATTERY_TREND` | Face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (D-020) | `battery_trend.py` |
|
||
| energy | `DAILY_POWER_SOURCE` | Sur secteur (moyenne des 3 jours avant ≥ 14,0 V) ? Si oui, une heure < 13,4 V (perte du secteur) ? | livrée (D-043) | `power_source.py` |
|
||
| energy | `MOVING_AVERAGE_7_DAYS_DROP` | La moyenne sur 7 jours décroche-t-elle de son passé récent (> 0,2 V) ? | comparaison : ~2,7 jours d'avance sur VERMONT, bruitée | `moving_average.py` |
|
||
| energy | `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC | comparaison : peu bruitée, 1 h d'avance | `moving_average.py` |
|
||
| storage | `DAILY_STORAGE_STATE` | Espace libre de `/data` : `OK`, `LOW` ou `CRITICAL` (planchers arbitraires 20 % / 10 %) ? | prototype (D-034) | `storage_state.py` |
|
||
| storage | `DAYS_UNTIL_STORAGE_FULL` | Dans combien de jours le disque sera-t-il plein, au rythme médian de 7 jours ? | prototype (D-034) | `days_until_full.py` |
|
||
| cellular | `DAILY_LINK_STATE` | Envois arrivés avec `link = up`, lien `down`, ou envois manquants ? | prototype (D-031) ; deux corrections retenues, non codées | `link_state.py` |
|
||
| cellular | `DAILY_SIGNAL_STATE` | Médianes du RSRP et du RSRQ sur la grille publiée | prototype (D-031) | `signal_state.py` |
|
||
| temperature | `DAILY_GPU_TEMPERATURE_LIMIT` | Une moyenne horaire du GPU a-t-elle atteint 97,5 °C dans les 24 dernières heures ? | prototype (D-040) | `gpu_temperature_limit.py` |
|
||
|
||
- **Couleur du jour** : `src/<domaine>/day_color.py`, transcription de la matrice tenue par l'utilisateur, `docs/<domaine>/matrice-*.drawio` : Energy état × tendance (sur secteur, la perte du secteur décide à sa place), Storage état × horizon, Cellular lien × signal ; Temperature sans matrice (Red si la limite est atteinte, sinon Green).
|
||
- **Par domaine** : calcul embarquable (bibliothèque standard ; Energy sans import de `common/`) ; scripts plotly du poste de dev, `final.py` (figure du site, D-021) et `all_analyses.py` (page de comparaison, D-016).
|
||
- **Travailler sur une analyse** : `.claude/rules/analyses.md` se charge seule dès qu'on touche `src/` ou `docs/*/analyses/`. Créer une analyse : skill `nouvelle-analyse` ; un domaine, donc une notification : skill `nouveau-domaine` (D-030).
|
||
|
||
## Commandes
|
||
|
||
```bash
|
||
python3 src/<domaine>/final.py [données] # livré : figure du site, out/<STATION>_…daily.html + .json
|
||
python3 src/<domaine>/all_analyses.py [données] # analyses du domaine comparées : out/<STATION>_<domaine>.html
|
||
python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024)
|
||
python3 maquettes/user/summary.py [début] [fin] # maquette client, une page par station de data/
|
||
python3 maquettes/support/home.py [début] [fin] # maquette support
|
||
python3 vues-deplacements/maquette/explore.py [dossier] # page Explore : View, Diagnosis, Displacements, Journal
|
||
python3 detectors/categories.py <dossier> # événements du journal, une ligne chacun
|
||
python3 .claude/skills/boucle/detecteurs.py data/<STATION> [--du D --au F] # page des détecteurs seuls
|
||
python3 .claude/skills/boucle/benchmark.py # détecteurs face à la base d'events
|
||
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
|
||
python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .venv
|
||
```
|
||
|
||
- `[données]` : CSV ou dossiers ; défauts : `data/VERMONT/` (Energy), `data/WEISSHORN/` (Storage), `data/WEISSHORN/` et `data/NORDEND/` (Cellular, Temperature). Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; lancer les deux maquettes avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL ; dans le dev container, la page reste dans `out/`).
|
||
- Pompage, `/aiguiser`, `/boucle`, `/review-event` : `run.md`.
|
||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine ; pour les détecteurs, le benchmark et la page des détecteurs.
|
||
|
||
## Carte du dépôt
|
||
|
||
### Lire sans saturer le contexte
|
||
|
||
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
|
||
- `docs/decisions.md` (912 l, D-001 à D-090) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
|
||
- `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV.
|
||
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`.
|
||
|
||
### Racine
|
||
|
||
- `README.md` : point d'entrée pour un humain. `run.md` (115 l) : les commandes que lance l'utilisateur (pompage, métriques de qualité par `~/optical_emulator`, `/aiguiser`, `/boucle`, `/review-event`). `push.sh "<message>"` : pull, commit de tout, push.
|
||
|
||
### `docs/`
|
||
|
||
- `decisions.md` : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||
- `aimsight/` : documents reçus d'AIMsight, en anglais sauf les rapports d'analyse. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **la référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||
- `AIMsight_agentic_support_project_context.md` (2 090 l) : extension support : chaîne de dépendance (§4), santé système (§5.1), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23).
|
||
- `AIMsight_handoff_G_site_health.md` (150 l) : cadrage du product owner (2026-10-25), tel quel : sous-projet G, domaines de mesure, étiquette de responsabilité, « consistent with », traductions, sécurité de production ; puis nos écarts. À lire avant de concevoir côté client ou notifications.
|
||
- `AIMsight FAQ.pdf`, `AIMsight Test Manual.pdf` (en réalité le manuel de la station) : signaux, colonnes CSV, alimentation, schedules. `Mur de soutènement GN-1.472.pdf`, `GN-5.054.pdf` : rapports d'analyse remis au client (mai 2026, en français).
|
||
- `collecteur_system_info.py` : copie de référence du collecteur embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω), source des unités. Ne pas modifier.
|
||
- Ces documents prévoient un LLM pour la synthèse : la couche déterministe reste 100 % analytique ; la couche d'agents côté serveur (D-027) reprend l'idée, en exploration.
|
||
- `domaine/` : savoir métier commun, une note courte par question : `ce-que-mesure-la-station.md` (format CSV, métriques, unités ; la consommation est mesurée, pas l'apport), `pieges-des-donnees.md`, `colonnes-des-deplacements.md`, `images-de-la-camera.md` (IRON, la scène ; DIFF, les réflecteurs).
|
||
- `energy/`, `storage/`, `cellular/`, `temperature/` : un dossier par domaine système : `analyses/` (fiches, 70-120 l ; modèle `.claude/skills/nouvelle-analyse/modele-fiche.md`), `domaine/` (savoir métier, `point-de-depart.md`, `questions-pour-l-expert.md`), `guide/` (~90 l, client puis support ; la partie 1 est affichée dans la vue client), la matrice `.drawio`. Energy : `domaine/cas-annotes-par-l-expert.md` (diagnostics de 5 stations, vérité de référence), guide de 200 l en brouillon.
|
||
- `displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055), `cas-annotes-par-l-expert.md` (les deux rapports d'analyse, sans données), `incident-de-barcelone.md` (E-004 : mouvement réel selon l'expert, instabilité des références selon la doc), `cycle-thermique.md`.
|
||
- `agents/` : `rapport-exploratoire.md` (292 l, agents LLM côté serveur, D-027), `enquete-a-la-demande.md` (233 l, D-042), `agent-diagnostic.md` (377 l, spec de l'agent), `pipelines-ia.drawio` (les processus automatiques, une page chacun).
|
||
- `ameliorations-faq.md` : idées pour la prochaine FAQ. `ameliorations-processus.md` : difficultés des processus automatiques, tenu par le `releveur` (D-060).
|
||
- `superpowers/` : specs et plans (110-1 300 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 290 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
|
||
|
||
### Déplacements
|
||
|
||
- `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, boucle, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069).
|
||
- `detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées.
|
||
- `boucle/`, `aiguiser/` : les séances de `/boucle` et `/aiguiser` (D-084), une par dossier `<séance>_<STATION>/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande. `aiguiser/voir.py` : ce que rendent les outils de lecture sur un lot.
|
||
- `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par le builder de `/boucle`.
|
||
- `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees`, aiguisé par `/aiguiser`.
|
||
- `agent-diagnostic/` : consignes (`instructions.md`, 146 l) et rapports de l'agent de diagnostic (D-082). Appel : `@agent-diagnostic data/<STATION>/ [question]`.
|
||
- `support/` : un dossier par demande d'un client (D-079), `<date>_<STATION>_<sujet>/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images. Contient des mails et images de clients.
|
||
- `extraction/` : pompage `pomper.py` des données de la plateforme (D-056), en lecture seule, lancé par l'utilisateur dans le dev container de l'application de référence `~/monitoring-dashboard` ; mode d'emploi `extraction/README.md`.
|
||
|
||
### Code, données, configuration
|
||
|
||
- `src/` : un sous-dossier par domaine système (D-026), plus `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
|
||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande : `user/summary.py` et `support/home.py`, chacun avec son gabarit, parcourent la liste de domaines `DOMAINS` (D-039).
|
||
- `data/` : un dossier par station, au numéro de série du système (D-029), rempli par le pompage, **hors de git** (D-065) : `metrics/` (un CSV par métrique et par jour), `displacement/` (« advanced », un CSV par jour), `camera/`, `images/`, au besoin `images_diff/` et `quality/`. Les stations présentes : `ls data/`.
|
||
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
|
||
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
|
||
- Les données des events restent, codées, dans `events/`.
|
||
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `analyser-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
|
||
- `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés.
|
||
- Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`.
|
||
|
||
## Règles de travail
|
||
|
||
- Une décision projet prise en conversation donne une entrée dans `docs/decisions.md`.
|
||
- Toute modification d'une analyse met à jour sa fiche dans le même changement.
|
||
- Un savoir métier nouveau va dans `docs/domaine/` (commun) ou `docs/<domaine>/domaine/`.
|
||
- Un processus automatique à plusieurs agents (`/boucle`, `/aiguiser`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle le `releveur` en fin de processus, qui les note dans `docs/ameliorations-processus.md` (D-060). Pas dans une conversation ordinaire.
|
||
- Un changement de cap met à jour « État et prochaine étape » ci-dessus : l'état courant, pas un historique.
|
||
- Langue : échanges et documents projet en français ; documentation AIMsight en anglais (garder ses termes techniques) ; tout ce qui va au site en anglais (D-023).
|
||
|
||
## Principes (raisons, statuts et options écartées : `docs/decisions.md`)
|
||
|
||
- **Point d'entrée : scan proactif d'un export** (D-001). L'agent détecte les événements, les classe et explique chacun ; le mode « question de support » s'appuie sur le même socle.
|
||
- **Santé énergétique d'abord** (D-002) : ici, le trou de données *est* l'anomalie. Les déplacements ont suivi (D-044, D-056).
|
||
- **Pas de LLM dans la couche déterministe, pas de données synthétiques** (ni CSV simulés, ni générateur de scénarios : refus explicite de l'utilisateur). Le code d'analyse est **embarquable** : bibliothèque standard, calcul léger.
|
||
- **Anomalie énergétique = régime non soutenable** (l'apport ne couvre pas la consommation), pas une batterie basse. Une station débranchée avec une batterie pleine est déjà en anomalie.
|
||
- **Analyses combinées** : chaque analyse est une preuve imparfaite, juste « dans la majorité des cas » ; la combinaison fait le diagnostic (pour Energy, la matrice état × tendance, D-020). Une analyse seule conclut au plus `consistent with`. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
|
||
- **Livrables** : pour le site, une figure Plotly par station et la couleur du jour (D-021) ; pour comparer, une page HTML par station, un panneau par analyse puis un graphique par série (D-016). Zoom dans le temps seulement, ordonnée recalée sur la plage visible (D-013).
|
||
- **Destinataires du diagnostic** : le client final et l'ingénieur support, en couches (D-020).
|
||
- **Ouvert** : l'architecture, à ne pas figer ici.
|
||
|
||
## L'essentiel du domaine (détail : `docs/domaine/`)
|
||
|
||
- **Données** : CSV horaires en UTC, colonnes `,time_utc,metric` ; une valeur vide signifie qu'il n'y a pas de mesure. **Toute heure est en UTC** (données, noms de fichiers, documents, échanges) ; une heure locale ne figure que pour décrire une source qui l'utilise.
|
||
- **Unités** : `BusVoltage` [V], `BusCurrent` [mA], `Power` [mW], `ShuntVoltage` [mV]. Ces trois dernières sont une seule mesure : la **consommation**. **L'apport (panneau ou secteur) n'est pas mesuré.**
|
||
- **Batterie LiFePO4 de 12,8 V** :
|
||
- entre 30 et 90 % de charge, la tension de nuit reste plate ; elle ne chute qu'au coude (~12,8 V, puis ~12,5 V) ;
|
||
- sous 12 V, la station s'éteint et ne redémarre que vers ~12,6 V ;
|
||
- ≥ 14,0 V dans la journée signale une charge complète.
|
||
- **Les seuils de tension absolus ne se transposent pas d'une station à l'autre** : comparer la station à son propre passé. Exception : les seuils du matériel (fin de charge ~14,0 V, coude 12,8 V), admis pour les analyses d'état (D-018).
|
||
- **Un trou n'est pas forcément une coupure** : retard de synchronisation en fin de fichier, début d'historique, cause commune si plusieurs stations ont un trou en même temps.
|
||
|
||
## Règles non négociables
|
||
|
||
- **Chaque conclusion est traçable.** Elle cite les faits calculés et la règle qui l'a produite. Aucun chiffre ni seuil sans source.
|
||
- Ne pas confondre « pas de donnée visible » et « station arrêtée » : acquisition, transmission, ingestion et affichage sont des couches distinctes.
|
||
- Séparer fait observé, fait dérivé, contexte opérateur, hypothèse et inconnu. Pas de pseudo-probabilités ; vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`.
|
||
- Pas de règle spécifique à un site : les events résolus deviennent des cas de régression.
|
||
- Lecture seule : aucune action sur les stations, la configuration ou le retraitement.
|
||
- Pour les déplacements :
|
||
- ne rien construire sur `inlier` binaire : RANSAC sera remplacé par un estimateur pondéré. Utiliser poids continus, `N_eff`, résidus, influence ;
|
||
- `sigma0` seul et le nombre de références ne sont jamais des critères suffisants ;
|
||
- ne pas confondre qualité image d'une cible et qualité du réseau de références, ni petit résidu et transformation bien contrainte ;
|
||
- ne pas confondre mouvement en mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes.
|
||
|
||
## Environnement
|
||
|
||
- `pandas` n'est pas installé ; la bibliothèque standard suffit (`csv`, `datetime.fromisoformat`). `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques des agents), pour le poste de dev.
|
||
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container ».
|