Organize the project by domain and name analyses by their rule
Energy code moves to src/energy/ and its docs to docs/energy/; shared code (CSV loading, venv switch, browser, zoom script) goes to src/common/, and the AIMsight originals to docs/aimsight/. Analyses are no longer numbered: two Energy scripts remain, daily.py (delivered state and trend) and all_analyses.py (comparison of the four). Calculations and pages unchanged (D-026). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
77c8f24d2f
commit
8a32f4d418
44 files changed
+1757
-771
No files matched your search
@@ -1,13 +0,0 @@
|
||||
# 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.
|
||||
@@ -10,7 +10,7 @@
|
||||
|
||||
## Métriques système et unités
|
||||
|
||||
La source est le collecteur embarqué `src/__main__ (3).py` : bibliothèque INA219, shunt de 0,1 Ω.
|
||||
La source est le collecteur embarqué `docs/aimsight/collecteur_system_info.py` : bibliothèque INA219, shunt de 0,1 Ω.
|
||||
|
||||
| Métrique | Unité | Sens |
|
||||
|---|---|---|
|
||||
@@ -31,7 +31,7 @@ La source est le collecteur embarqué `src/__main__ (3).py` : bibliothèque INA2
|
||||
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`).
|
||||
- `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
|
||||
|
||||
|
||||
@@ -16,4 +16,4 @@ Causes à départager pour une anomalie de déplacement :
|
||||
- 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`.
|
||||
La référence qui fait autorité est `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`. Les règles non négociables qui s'y rapportent (`inlier` binaire, `sigma0`, mode commun) sont dans `CLAUDE.md`.
|
||||
@@ -1,32 +0,0 @@
|
||||
# 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.
|
||||
@@ -1,78 +0,0 @@
|
||||
# Tensions de la batterie selon son état : charge, pleine charge, décharge
|
||||
|
||||
Rapport du 2026-10-12. Il répond à une question : quelle tension `BusVoltage` attendre dans chacun des 3 états de la batterie ?
|
||||
|
||||
Sources, citées sur chaque chiffre :
|
||||
- **[C]** collecteur embarqué `src/__main__ (3).py` ;
|
||||
- **[M]** manuel de la station (`doc/AIMsight Test Manual.pdf`) ;
|
||||
- **[F]** FAQ (`doc/AIMsight FAQ.pdf`) ;
|
||||
- **[E]** diagnostics experts (`data/metadata.md`, `cas-annotes-par-l-expert.md`) ;
|
||||
- **[V]** mesures de VERMONT (solaire), moyennes horaires du 2026-04-09 au 2026-10-09. Les plages [V] sont les 5e et 95e centiles ;
|
||||
- **[G]** chimie LiFePO4 générale, par cellule × 4. **Ces valeurs ne sont pas vérifiées sur le chargeur AIMsight**, dont le modèle et les réglages ne figurent pas dans la doc.
|
||||
|
||||
## Le pack
|
||||
|
||||
- **Composition** : LiFePO4 en 4 cellules série, 12,8 V nominal, soit 3,2 V par cellule [C][E].
|
||||
- **Capacité** : 7 ou 21 Ah selon la station [E]. Les nuits de VERMONT sont cohérentes avec 21 Ah (`comment-se-comporte-la-batterie.md`).
|
||||
- **Alimentation** : panneau solaire 12 V (~100 W conseillé) ou secteur. Tension d'entrée maximale : 26 V [M]. Sur secteur, la batterie reste branchée et sert d'UPS [M].
|
||||
|
||||
## Les 3 états en un tableau
|
||||
|
||||
| État | Terme technique | `BusVoltage` observée [V] | Pente | Chimie générale [G] |
|
||||
|---|---|---|---|---|
|
||||
| **1. En charge** | *bulk*, courant constant (CC) | **13,1 – 13,8** (médiane 13,35) [V] | montée de 30 à 370 mV/h, médiane +75 mV/h [V] | 13,2 – 13,8 V : la tension reste sur le plateau tant que la batterie n'est pas pleine |
|
||||
| **2. Pleine charge** | *absorption*, tension constante (CV) ; sur secteur, *float* (maintien) | **14,0 – 14,3** (médiane 14,16, maximum 14,33) [V] ; secteur : 14,2 – 14,4 jour et nuit [E] | plate : c'est le chargeur qui tient la tension | absorption 14,2 – 14,6 V (3,55 – 3,65 V/cellule) ; float 13,5 – 13,8 V |
|
||||
| **3. En décharge** | décharge | plateau **13,0 – 13,2**, coude **12,8 → 12,5**, zone raide **< 12,5** [V] | baisse de 4 à 15 mV/h sur le plateau, 30 à 90 mV/h au coude, 170 à 185 mV/h sous 12,5 V [V] | plateau 3,25 – 3,3 V/cellule ; fin de décharge 2,5 – 2,8 V/cellule (10 – 11,2 V) |
|
||||
|
||||
## 1. En charge
|
||||
|
||||
- **Le matin**, la tension monte lentement sur le plateau. Le 07/09, par exemple : 13,12 V à 06 h, 13,53 V à 10 h, 13,62 V à 11 h UTC [V].
|
||||
- **Les jours nuageux**, elle plafonne vers 13,4 V : 13,44 V de médiane sur les 38 jours sans pleine charge [V]. La batterie charge, mais ne se remplit pas.
|
||||
- **Ce que la tension ne dit pas** : sous le courant de charge, elle est plus haute que la tension à vide. La table OCV ne s'applique donc pas pendant la charge [C].
|
||||
|
||||
## 2. Pleine charge
|
||||
|
||||
- **Seuil** : la tension franchit 14,0 V quand la batterie est pleine et que le chargeur passe en absorption.
|
||||
- **Les jours se répartissent en deux groupes nets** : sur 173 jours d'au moins 20 h mesurées, le maximum du jour est soit entre 13,01 et 13,55 V (35 jours), soit entre 14,02 et 14,33 V (135 jours). Seuls 3 jours tombent entre les deux : 13,59, 13,68 et 13,96 V [V]. Le seuil de 14,0 V sépare donc bien les deux.
|
||||
- **Durée** : un jour ensoleillé tient 14,05 – 14,2 V pendant 5 à 6 h (de 11 à 16 h UTC le 10/06 et le 05/07). Sur les 139 jours pleins, il y a de 3 à 6 h ≥ 14 V dans 124 cas [V].
|
||||
- **Pas de *float* visible en solaire** : à la résolution horaire, aucun palier distinct n'apparaît entre 13,5 et 13,8 V après l'absorption. Les heures de 9 à 16 h se regroupent autour de 13,4 V (charge) et de 14,1 – 14,2 V (absorption), avec un creux entre les deux [V].
|
||||
- **Le soir**, la tension retombe vite : à 18 h UTC, elle est entre 13,16 et 13,24 V après un jour plein [V]. Ce retour rapide est connu en LiFePO4 [G].
|
||||
|
||||
## 3. En décharge
|
||||
|
||||
- **La nuit, la consommation est le seul courant** : 360 à 440 mA [V], pour ~5 W constants (`ce-que-mesure-la-station.md`).
|
||||
- **Sur le plateau** : à 05 h UTC, après un jour plein, la tension est entre 13,08 et 13,21 V (médiane 13,15) [V].
|
||||
- **Pente médiane de la baisse nocturne, selon la tension** [V] :
|
||||
|
||||
| Tension [V] | 13,2 | 13,1 | 13,0 | 12,9 | 12,8 | 12,7 | 12,6 | 12,5 | 12,4 | 12,2 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| Baisse [mV/h] | 4 | 10 | 13 | 15 | 29 | 47 | 34 | 93 | 170 | 184 |
|
||||
|
||||
- **Les deux cassures** sont vers 12,8 V et vers 12,5 V [V]. Sous 12,5 V, la tension tombe 10 à 40 fois plus vite que sur le plateau.
|
||||
- **Coupure et redémarrage** :
|
||||
- sous 12 V, la station s'éteint et ne redémarre que vers ~12,6 V [M] ;
|
||||
- sur VERMONT, les coupures nocturnes arrivent vers ~12,2 V, et les redémarrages du matin entre 12,35 et 12,62 V [E] ;
|
||||
- ces valeurs sont des moyennes horaires sous charge : les derniers instants avant la coupure n'y apparaissent pas.
|
||||
- **Sur secteur, à la coupure** : la tension passe de 14,2 à ~13,1 V, baisse lentement, puis atteint le coude vers 12,5 V et décroche (MISSISSIPPI) [E].
|
||||
- **Autonomie** : environ 5 jours avec une mesure toutes les 15 min [F]. Avec 5 W en continu, elle va de 15 h (7 Ah) à 46 h (21 Ah) (`comment-se-comporte-la-batterie.md`).
|
||||
|
||||
## Corrections à connaître
|
||||
|
||||
- **Chute de tension due au courant** : `BusVoltage` = tension à vide − I × 0,34 Ω [C]. La nuit, cela fait −0,12 à −0,15 V [V]. Avec cette correction, la nuit médiane passe de 13,17 à 13,30 V.
|
||||
- **La table OCV du collecteur se lit mal sur VERMONT.** Elle donne 13,6 V = 100 % et 13,3 V = 80 % [C].
|
||||
- Après un jour plein, la tension à vide corrigée n'est déjà plus que de ~13,33 V à 18 h, et de ~13,30 V la nuit. La table lit donc environ 80 %.
|
||||
- C'est cohérent avec ~70 Wh consommés par nuit sur ~270 Wh (21 Ah), à condition que la capacité soit bien de 21 Ah.
|
||||
- Les 13,6 V de la table ne sont atteints que sous charge.
|
||||
- **L'état « charge / décharge » du collecteur ne voit pas le plateau.**
|
||||
- Il classe la pente sur 60 s avec un seuil de ±2,5 mV/min, soit ±150 mV/h, fixé à cause du pas de 4 mV de l'INA219 [C].
|
||||
- Or la charge sur le plateau monte de ~75 mV/h, et la décharge nocturne baisse de 4 à 15 mV/h [V]. Les deux sont classées « stable ».
|
||||
- Seules la montée vers l'absorption et la chute sous le coude dépassent ce seuil.
|
||||
- Ce `BatteryState` n'est pas exporté dans les CSV.
|
||||
|
||||
## Ce qui reste non établi
|
||||
|
||||
- **Le chargeur** : modèle, tension d'absorption, tension de *float*, compensation en température. On observe ~14,2 V en absorption (3,55 V/cellule), mais rien dans la doc ne le confirme.
|
||||
- **Le froid** : la chimie LiFePO4 interdit en général la charge sous 0 °C [G]. Le chargeur ou la batterie la bloquent peut-être. Les données vont d'avril à octobre, sans hiver : aucune observation.
|
||||
- **D'autres stations** : tous les chiffres [V] viennent de VERMONT seule (solaire, 21 Ah probable). Pour une batterie de 7 Ah, les pentes de nuit seraient environ 3 fois plus fortes.
|
||||
- **La résolution horaire** cache les transitions : une heure moyenne mélange charge et absorption. Le 07/09 à 14-15 h, on lit 13,96 et 13,95 V.
|
||||
- Entre 13,8 et 14,0 V, il n'y a que 117 heures sur 4 296 (2,7 %) [V]. Ce sont presque toutes des heures de transition : 44 entre une heure < 13,8 V et une heure ≥ 14,0 V (montée vers l'absorption, de 10 à 13 h UTC), 58 dans l'autre sens (retombée du soir, de 15 à 17 h UTC), et 15 autres (transitions étalées sur 2 heures, ou passages nuageux en milieu de journée, par exemple 14,14 → 13,82 → 14,12 V le 17/05 de 12 à 14 h UTC).
|
||||
Reference in new issue
Block a user