Document the project: decisions log, analysis sheet, domain notes

- CLAUDE.md becomes a short map: status and next step, analyses index,
  documentation map, working rules.
- docs/decisions.md: ADR-style project decision log (D-001..D-014).
- docs/analyses/: living sheet per analysis (analyse_01) and template.
- docs/domaine/: domain knowledge, one note per question.
- .claude/rules/analyses.md: path-scoped rule loaded on src/ and
  docs/analyses/; .claude/skills/nouvelle-analyse: new-analysis workflow.
- README.md: human entry point.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-09 23:29:42 +02:00
1 parent 0b950199b8
commit 8992bda17e
12 files changed
+588 -49

No files matched your search

+13
View File
@@ -0,0 +1,13 @@
# Cas annotés par l'expert
Les diagnostics experts, qui font office de vérité de référence, sont dans `data/metadata.md` et `data/d.md`. Seule VERMONT est dans le jeu de travail (`data/`). Les autres stations, avec `BusVoltage` seule, sont dans `data/archive/` (D-009).
| Station | Alimentation | Diagnostic expert | Signature observée |
|---|---|---|---|
| VERMONT | solaire | interruptions nocturnes (déficit) | Le maximum quotidien plafonne vers 13,2–13,5 V dès le 20/09 (charges complètes déjà rares depuis fin août). Coupures nocturnes dès le 27/09, vers ~12,2 V. Les redémarrages ont lieu le matin, entre 12,35 et 12,62 V. |
| JUNGFRAU | solaire | sain | Aucun trou, maximum quotidien ~14,1–14,2 V. Les jours nuageux, pas de montée diurne. |
| WILDSTRUBEL | solaire | décharge profonde sous 12 V (UVLO désactivé ?), coupure d'environ 12 jours, puis interruptions nocturnes | Maximum quotidien en baisse dès le 04/09, 11,53 V le 09/09, puis 298 h sans mesure. |
| FLORIDA | secteur | sain, sans interruption | 14,2–14,4 V sans cycle jour/nuit. Une baisse ponctuelle à 13,0 V le 10/07 (2 h). Quelques trous courts à tension normale, qui ne sont pas des coupures d'alimentation. |
| MISSISSIPPI | secteur | coupures secteur : la batterie sert d'UPS, puis le système se déconnecte | Chute de 14,2 à ~13,1 V, lente baisse, coude vers 12,5 V, puis décrochage. Nombreuses coupures de décembre 2025 à juin 2026, avec des lectures jusqu'à 10,3 V. Presque aucune mesure de janvier à mai. |
Remède indiqué par l'expert pour VERMONT et WILDSTRUBEL : réactiver le mode veille profonde entre les mesures.
+45
View File
@@ -0,0 +1,45 @@
# Ce que mesure la station (et ce qu'elle ne mesure pas)
## Format des exports CSV
- Un CSV par station et par métrique : `<STATION>_<Metric>_<début> to <fin>.csv`.
- Colonnes `,time_utc,metric` : un index sans nom, l'horodatage UTC (pas d'une heure), la valeur.
- Une valeur `metric` vide signifie qu'il n'y a pas de mesure.
- Les valeurs exportées sont des **moyennes horaires**.
- Les CSV simulent la future base de données. Les schémas CSV historiques varient d'un export à l'autre. Parquet et HDF5 viendront ensuite.
## Métriques système et unités
La source est le collecteur embarqué `src/__main__ (3).py` : bibliothèque INA219, shunt de 0,1 Ω.
| Métrique | Unité | Sens |
|---|---|---|
| `BusVoltage` | V | tension du bus, proche de la tension batterie |
| `BusCurrent` | mA | courant consommé par la station |
| `Power` | mW | puissance consommée |
| `ShuntVoltage` | mV | tension aux bornes du shunt (= courant × 0,1 Ω) |
| `sensor_*_deg_c` | °C | températures internes (CPU, PLL, thermal, …) |
- **`Power`, `BusCurrent` et `ShuntVoltage` sont une seule et même mesure.** On le vérifie avec P/(V·I) ≈ 0,99 et Shunt/0,1 Ω ≈ I.
- Ces trois métriques mesurent la **consommation** de la station. Le courant ne devient jamais négatif. Il baisse à midi quand la tension monte, comme une charge à puissance constante.
- **L'apport (panneau ou secteur) n'est pas mesuré.** On ne le voit qu'à travers la réaction de la batterie.
- Le courant augmente quand la tension baisse, alors que la puissance reste constante. Pour la consommation, raisonner en `Power`, pas en `BusCurrent`.
- La température suit l'ensoleillement : son amplitude dans la journée est faible les jours nuageux. Elle chute aussi quand la station est éteinte, puisque l'auto-échauffement de ~5 W s'arrête.
## Calculs déjà présents dans le collecteur embarqué
Ces valeurs ne sont pas exportées dans les CSV actuels :
- `BusVoltageOCV` : tension compensée de la chute dans la résistance interne, avec R = 0,34 Ω (mesure faite sur une station déployée) ;
- `BusVoltageTrend` : pente en mV/min sur une fenêtre de 60 s ;
- `BatteryState` et `BatteryPercent` : état de charge estimé par la table OCV LiFePO4 (voir `comment-se-comporte-la-batterie.md`).
## Instantanés d'état système
`data/metadata.md` contient des instantanés de l'état de WILDSTRUBEL et de VERMONT, avec des unités notées `[unknown]`. On y trouve par exemple `mode SLP` pour VERMONT, cohérent avec la réactivation du mode veille.
## Consommation observée sur VERMONT
- La consommation est d'environ 5,0 W constants d'avril à octobre (~120 Wh/j). Le déficit de fin septembre vient donc d'un apport en baisse, pas d'une consommation en hausse.
- Exceptions :
- ~3,3 W du 14/09 0 h au 15/09 13 h (essai du mode veille, probablement) ;
- 2,2 à 3,2 W le 09/10 à partir de 13 h (cohérent avec `mode SLP`).
+19
View File
@@ -0,0 +1,19 @@
# Colonnes des déplacements (cas d'usage suivant)
Les colonnes CSV des déplacements sont préfixées par la cible (ex. `target_06_rch`) :
- `rch` / `rcv` : déplacement corrigé du mouvement de la caméra [mm]. C'est le signal principal.
- `x` / `y` : position brute dans l'image [px].
- `rx` / `ry` : déplacement relatif avant correction caméra. **Ce n'est pas** `x - x0`.
- `error` : erreur de reconnaissance de la cible, **pas** une incertitude. Seuil par défaut : 0,7.
- `camera_pan|tilt|rotation` [deg], `camera_scale`, `camera_sigma0` (résidu du fit du réseau de références).
- `inlier_{ch}`, `reproj_err_{ch}` : contribution et résidu de chaque référence.
- Sharpness, FWHM, Dominance, Peak Intensity, Flux, SNR : **uniquement dans l'export HDF5**.
Causes à départager pour une anomalie de déplacement :
- mouvement réel de l'ouvrage ;
- mouvement de la caméra ;
- instabilité de la compensation (cas Barcelone) ;
- dégradation locale d'une cible ;
- parallaxe ou modèle inadapté.
La référence qui fait autorité est `doc/AIMsight_reference_quality_event_explainer_roadmap (2).md`. Les règles non négociables qui s'y rapportent (`inlier` binaire, `sigma0`, mode commun) sont dans `CLAUDE.md`.
@@ -0,0 +1,32 @@
# Comment se comporte la batterie (alimentation de la station)
## Matériel (metadata et manuel de la station)
- Batterie LiFePO4 de 12,8 V nominal, environ 7 ou 21 Ah selon la station.
- Panneau solaire 12 V, ~100 W conseillé. Tension d'entrée maximale : 26 V.
- **Sur secteur**, la batterie reste connectée et sert d'UPS.
- **Après une décharge profonde** (< 12 V), la station reste éteinte jusqu'à ce que la batterie remonte à ~12,6 V, puis redémarre. L'UVLO doit couper avant la décharge profonde.
- Mesure quasi statique, typiquement toutes les 15 min.
- Remède attendu en cas de déficit : réactiver le mode veille profonde (sleep) entre les mesures. Le « Continuous mode » (LED allumées) augmente la consommation.
## Tension et état de charge (table OCV du collecteur)
| Tension à vide | Charge | 0,1 V correspond à | Zone |
|---|---|---|---|
| ≥ 13,6 V | 100 % | — | pleine ; au-dessus, c'est le chargeur qui tient la tension |
| 12,9 – 13,4 V | 40 – 90 % | ~10 % de charge | **plateau** : la tension dit peu de choses sur la charge |
| 12,5 – 12,8 V | 20 – 30 % | ~3 % de charge | **coude** |
| < 12,5 V | < 20 % | ~2 % de charge | zone raide ; sous 12 V, décharge profonde |
Vérification sur les données : VERMONT consomme 5 W constants, donc la vitesse de baisse de sa tension la nuit dessine la courbe. Elle vaut 7 mV/h à 13,2 V, 13 à 13,0 V, 48 à 12,8 V, et 126 à 192 mV/h entre 12,3 et 12,5 V. On retrouve les deux cassures, vers 12,8 V et vers 12,5 V. MISSISSIPPI a la même forme.
## Ce qu'il faut en retenir pour les analyses
- **La tension instantanée ne dit pas l'état de charge.**
- Le jour, le chargeur la tire vers le haut : 14,2 V correspond à la fin de charge (absorption).
- Sous la consommation de la station, la tension mesurée est un peu plus basse que la tension à vide (~0,4 A × 0,34 Ω ≈ 0,14 V).
- Le meilleur indicateur avec `BusVoltage` seule est le minimum de fin de nuit.
- **Plateau LiFePO4** : entre 30 et 90 % de charge, la tension de nuit reste plate. Elle ne chute qu'au coude, donc trop tard pour alerter.
- **Charge complète** : une tension ≥ ~14,0 V dans la journée signale que la batterie a été remplie. Les jours nuageux, elle plafonne vers 13,4 V.
- **Capacité** : une nuit de VERMONT consomme ~70 Wh. Avec 7 Ah (~90 Wh), il resterait ~22 % de charge au matin, soit ~12,6 V. On observe 13,15 V, ce qui est cohérent avec 21 Ah.
- **Une batterie pleine ne garantit rien** : une station débranchée du secteur tient environ 15 h (7 Ah) à 46 h (21 Ah) à 5 W. Voir D-004.
+17
View File
@@ -0,0 +1,17 @@
# Pièges des données
- **Un trou n'est pas forcément une coupure.** Acquisition, transmission, ingestion et affichage sont des couches distinctes.
- **En fin de fichier**, des valeurs vides peuvent n'être qu'un retard de synchronisation (`last_sync`) : WILDSTRUBEL, et MISSISSIPPI le 09/10.
- **En début de fichier**, des valeurs vides précèdent la première mesure : ce n'est pas une coupure (VERMONT `Power` et températures, du 22/02 au 08/04).
- **Des trous simultanés sur plusieurs stations** pointent plutôt vers une cause commune hors station :
- le 22/07 à 14:00 : FLORIDA, MISSISSIPPI et VERMONT ;
- le 19/08 à 15:00 : les mêmes trois stations ;
- le 22/08 à 17:00 : FLORIDA et MISSISSIPPI.
- **Un trou entouré d'une tension normale** n'est pas un problème d'énergie.
- **Une coupure d'alimentation laisse une signature** :
- la tension est sous le coude (~12,8 V) juste avant ou juste après le trou ;
- la température chute pendant le trou, plus qu'aux mêmes heures les nuits sans trou. Sur VERMONT, l'écart va de 2,6 à 15 °C sur 12 trous.
- **Les seuils de tension absolus ne se transposent pas d'une station à l'autre.** En bonne santé, les nuits de JUNGFRAU sont à 12,9 V et celles de VERMONT à 13,15 V. Le niveau moyen vaut ~14,25 V sur secteur et ~13,4 V en solaire. Préférer une comparaison de la station à son propre passé.
- **Cycle jour/nuit** : une fenêtre glissante doit couvrir un nombre entier de jours. Sur 72 h, la météo domine : 2 jours nuageux font baisser JUNGFRAU (sain) autant qu'un vrai déficit.
- **Une valeur `NaN` ou `inf`** dans un export (pandas, par exemple) doit être traitée comme une absence de mesure.
- **Pendant une coupure, ce sont justement les valeurs les plus basses qui manquent** : toute moyenne est alors biaisée vers le haut.