Files
Support-Agent/docs/domaine/ce-que-mesure-la-station.md
T
maximeandClaude Opus 5.5 a81cc4c380 Pump system metrics and resume day by day (point 43)
pomper.py now also pumps every system metric of a station, in the format of
the System page download (hourly mean, text lists, empty hour), one CSV per
metric and per day; displacements are written one file per day, today is
never pumped, and a rerun only fetches missing days. Fix image resume: an
image already on disk now counts for its time slot. load_stations merges
several files of the same metric instead of failing on a duplicate.

Not run against the database: first run by the user, with point 27.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-24 19:14:59 +02:00

47 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`. Le pompage (`extraction/pomper.py`) en écrit un par jour ; `common.stations.load_stations` fusionne les fichiers d'une même métrique.
- 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é `docs/aimsight/collecteur_system_info.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 de la carte de calcul (A0, CPU, GPU, PLL, thermal selon la version du collecteur ; `docs/temperature/domaine/point-de-depart.md`) |
- **`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é
Les CSV de VERMONT ne contiennent pas ces valeurs ; l'export de WEISSHORN du 2026-10-13 les contient (`BatteryState` sous forme de liste des échantillons de l'heure, chargée comme liste par `common.stations` ; les autres en moyennes horaires) :
- `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 `docs/energy/domaine/comment-se-comporte-la-batterie.md`).
## Instantanés d'état système
Les notes de l'expert (retirées du dépôt le 2026-10-13, D-033) contenaient 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 13/09 23 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`).
- Dispersion, hors exceptions : heures entre 4,7 et 5,7 W (5e et 95e centiles), pics isolés jusqu'à 7,3 W ; moyennes journalières de 4,9 à 5,5 W ; moyennes mensuelles de 5,03 W (avril) à 5,17 W (juillet). Le profil horaire varie de 4,99 W (04 h UTC) à 5,18 W (14 h UTC). Cause de la légère hausse estivale et diurne non établie.