Add DAILY_MAINS_POWER: on mains, a mains loss turns the day red at once
A station is on mains when its BusVoltage mean over the 3 days before the day is >= 14.0 V (solar never exceeds 13.50 V on VERMONT; mains stays >= 14.08 V). On mains, the mains loss decides the day color instead of the state x trend matrix: red as soon as an hour falls under 13.4 V (top of the OCV plateau; mains-on hours stay >= 13.65 V, mains-off hours are 13.1-13.3 V). On MISSISSIPPI the day turns red 1-2 h after the loss instead of 29-40 h with the matrix; WEISSHORN and NORDEND (mains) raise no false alert, VERMONT (solar) is unchanged (D-043). The matrix drawio gets the mains case, the site figure a third panel, and the support notification and the client Energy block header show "On mains" / "Not on mains" / "Mains unknown". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
28ed86baba
commit
9177982de1
18 files changed
+359
-43
No files matched your search
@@ -98,7 +98,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
3. **Résolution horaire** : une absorption de moins d'une heure peut donner une moyenne sous 14,0 V, et le jour est alors lu `PARTIAL_CHARGE`. Exemple : le 2026-09-08, maximum 13,96 V.
|
||||
4. **`PARTIAL_CHARGE` n'est pas une anomalie** : 31 jours sur 184, dont des jours sains nuageux. C'est la répétition qui comptera en phase B.
|
||||
5. **Batterie de 7 Ah** : avec ~22 % de charge au matin (note de domaine), une station saine de 7 Ah à 5 W pourrait passer sous 12,8 V chaque nuit, et être lue `BELOW_PLATEAU` tous les jours. Ce n'est pas faux (la batterie quitte bien le plateau), mais c'est à vérifier sur une telle station. JUNGFRAU, station saine, a des nuits à 12,9 V : marge de 0,1 V.
|
||||
6. **Secteur** : la tension reste vers 14,2–14,4 V, donc chaque jour est lu `FULL_CHARGE`. Après une perte secteur, le jour suivant devrait être lu `NO_CHARGE` ou `BELOW_PLATEAU`. Ce n'est pas vérifiable sur le jeu de travail, qui est solaire.
|
||||
6. **Secteur** : la tension reste vers 14,2–14,4 V, donc chaque jour est lu `FULL_CHARGE`, le jour de la perte compris. Après une perte secteur, le jour suivant est lu `NO_CHARGE` ou `BELOW_PLATEAU`. Couverte par `DAILY_MAINS_POWER` (2026-10-13, D-043) : sur secteur, la perte décide de la couleur dès la première heure sous 13,4 V.
|
||||
7. **Froid** : aucune donnée d'hiver. La charge LiFePO4 est en général bloquée sous 0 °C, d'où des jours `PARTIAL_CHARGE` ou `NO_CHARGE` possibles, même au soleil.
|
||||
8. **Ambiguïté de `anomaly = None`** en phase C (voir « Principe »).
|
||||
|
||||
|
||||
@@ -0,0 +1,103 @@
|
||||
# `DAILY_MAINS_POWER` : sur secteur ou non, et perte du secteur
|
||||
|
||||
- **Statut** : prototype en place (2026-10-13), dans la couleur du jour (D-043).
|
||||
- **Script** : troisième panneau de `python3 src/energy/final.py [CSV ou dossiers]` (figure du site, D-021) et cinquième de `python3 src/energy/all_analyses.py` (comparaison, D-016) ; défaut `data/VERMONT/` (solaire), lancer sur `data/WEISSHORN data/NORDEND` pour voir des stations secteur.
|
||||
- **Code** : `src/energy/mains_power.py` (calcul, bibliothèque standard, importe seulement `battery_state` pour ses constantes) ; `src/energy/day_color.py` l'applique ; panneau `mains_power_panel()` dans `src/energy/final.py`.
|
||||
|
||||
## Question posée
|
||||
|
||||
La station est-elle sur secteur ? Si oui, a-t-elle perdu le secteur ce jour-là ?
|
||||
|
||||
- **Lien avec D-004** : sur secteur, la batterie reste pleine et sert d'UPS. Une station qui perd le secteur est en anomalie dès la première heure, même batterie pleine : elle tombera en 15 h (7 Ah) à 46 h (21 Ah) à 5 W.
|
||||
- **Ce que l'analyse ajoute** : la matrice état × tendance lit le jour de la perte `FULL_CHARGE` (les heures d'avant la perte sont à 14,2 V), donc vert. Elle ne passe au rouge que le lendemain, une fois 20 h mesurées (`NO_CHARGE`) ou le coude franchi (`BELOW_PLATEAU`) : 29 à 40 h après la perte sur MISSISSIPPI. Sur secteur, une heure sans chargeur suffit.
|
||||
|
||||
## Principe
|
||||
|
||||
Le statut vient des 3 jours qui précèdent J : une moyenne au niveau de la pleine charge veut dire qu'il n'y a pas de nuit, donc un chargeur toujours présent. Sur secteur, J est rouge dès qu'une heure tombe sous le haut du plateau.
|
||||
|
||||
Calcul exact, pour chaque jour UTC J ayant au moins une ligne `BusVoltage` :
|
||||
1. Heures mesurées : valeurs non vides et finies, comme `DAILY_BATTERY_STATE`.
|
||||
2. Fenêtre : les heures mesurées de J−3, J−2 et J−1 (72 h, J exclu). `coverage_3_days` = heures mesurées / 72 ; `mean_3_days_v` = leur moyenne.
|
||||
3. `power` :
|
||||
- `None` (UNKNOWN) si `coverage_3_days` < `MIN_COVERAGE` ;
|
||||
- `MAINS` si `mean_3_days_v` ≥ `MAINS_MEAN_V` ;
|
||||
- `NOT_MAINS` sinon.
|
||||
4. `hours_lost` = nombre d'heures mesurées de J sous `MAINS_LOST_V`, seulement si `power = MAINS` et que J a une mesure ; `None` sinon.
|
||||
5. `min_v` = minimum de J (le même que `DAILY_BATTERY_STATE`).
|
||||
|
||||
**Pourquoi J est exclu de la fenêtre** : sinon la coupure qu'on veut signaler ferait baisser la moyenne, et la station repasserait `NOT_MAINS` une douzaine d'heures après la perte (MISSISSIPPI : 14,2 → 13,1 V, soit −0,015 V par heure sur la moyenne). Le statut est ainsi fixe pour toute la journée.
|
||||
|
||||
**Couleur du jour** (`day_color.py`, `docs/energy/matrice-etat-tendance.drawio`) :
|
||||
- `MAINS` : `RED` si `hours_lost` > 0, `GREEN` si `hours_lost` = 0, `None` si J n'a pas de mesure ;
|
||||
- `NOT_MAINS` ou `None` : la matrice état × tendance, inchangée.
|
||||
|
||||
Sortie (contrat commun) : un point par jour, les mêmes jours que `DAILY_BATTERY_STATE`.
|
||||
- `t` = dernière heure du jour présente dans la série.
|
||||
- `value` = `mean_3_days_v`, en V (`None` sans mesure dans la fenêtre).
|
||||
- `anomaly` = `None` : pas de verdict, comme `DAILY_BATTERY_STATE` ; la couleur est dans `day_color`.
|
||||
- `facts` = `{power, mean_3_days_v, coverage_3_days, min_v, hours_lost}`.
|
||||
|
||||
**Causalité** : J n'utilise que J−3 à J−1 (statut) et les heures de J (perte). En cours de journée, `hours_lost` ne peut que monter : un rouge ne redevient pas vert avant minuit.
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| `WINDOW_DAYS` | 3 jours | Demande de l'utilisateur (moyenne glissante sur les 3 derniers jours), le 2026-10-13. |
|
||||
| `MAINS_MEAN_V` | 14,0 V | `FULL_CHARGE_V` de `DAILY_BATTERY_STATE`. Moyenne sur 3 jours : VERMONT (solaire) 12,77 à 13,50 V sur 173 jours ; secteur hors coupure ≥ 14,08 V (WEISSHORN 14,09–14,19, NORDEND 14,08–14,16, FLORIDA 14,20–14,28, MISSISSIPPI jusqu'à 14,24). |
|
||||
| `MAINS_LOST_V` | 13,4 V | Haut du plateau de la table OCV du collecteur (12,9–13,4 V = 40–90 %, `docs/aimsight/collecteur_system_info.py`) : en dessous, le chargeur ne tient plus la batterie. Données : sur secteur, l'heure la plus basse sans coupure est à 13,65 V (NORDEND, 27/09 22:00 ; WEISSHORN 13,91 V). La première heure pleine sans secteur est entre 13,11 et 13,30 V (MISSISSIPPI, 10 coupures) ; l'heure où survient la perte, partielle, peut rester au-dessus (13,69, 13,86, 13,88 V), d'où le délai de 1 à 2 h. |
|
||||
| `MIN_COVERAGE` | 0,8 | Repris de `DAILY_BATTERY_STATE` : 58 h mesurées sur 72. |
|
||||
|
||||
## Graphique
|
||||
|
||||
- **Place** : troisième panneau de la figure du site, sous l'état et la tendance (D-021, D-043), et cinquième panneau de la page de comparaison.
|
||||
- **Contenu**, sur un axe en volts, un point par jour à midi UTC (D-019) :
|
||||
- la moyenne des 3 jours avant J (courbe foncée) et le minimum de J (courbe claire) ;
|
||||
- les seuils de 14,0 V (bleu) et 13,4 V (rouge) en tirets, tracés comme des courbes pour rester visibles au zoom (D-013) ;
|
||||
- le statut en marqueurs sur la moyenne : ● bleu `on mains`, ○ gris `not on mains` ;
|
||||
- la perte du secteur en ✕ rouge sur le minimum (`mains lost`).
|
||||
- **Survol** : le statut et les faits du jour.
|
||||
|
||||
## Résultats
|
||||
|
||||
VERMONT (solaire) est le jeu de travail d'Energy (D-009), mais il ne contient pas de secteur. WEISSHORN et NORDEND (dans `data/`) sont sur secteur : 14,1–14,2 V jour et nuit. FLORIDA et MISSISSIPPI, les deux stations secteur des cas experts, ont été retirées du dépôt (D-033). Elles se relisent depuis l'historique git, sans revenir dans `data/` : `git show "128d4bc:data/archive/MISSISSIPPI_BusVoltage_2025_10_18_14_00 to 2026_10_09_14_00.csv"` (de même pour `FLORIDA_BusVoltage_2026_04_13_14_00 to 2026_10_09_14_00.csv`).
|
||||
|
||||
| Station | Alimentation (expert) | Statut | Couleur, changements face à la matrice seule |
|
||||
|---|---|---|---|
|
||||
| VERMONT | solaire | 173 j `NOT_MAINS`, 11 j inconnus (début, coupures) | aucun : 138 🟢, 31 🟠, 14 🔴, 1 gris |
|
||||
| WEISSHORN | non annotée (secteur d'après la tension) | 52 j `MAINS`, 14 inconnus (mise en service) | aucun : tous les jours `MAINS` sont 🟢 |
|
||||
| NORDEND | non annotée (secteur d'après la tension) | 97 j `MAINS`, 13 inconnus (trous de juin–juillet) | aucun : tous les jours `MAINS` sont 🟢 |
|
||||
| FLORIDA | secteur, sain | 175 j `MAINS` | 1 jour 🟢 → 🔴 : le 10/07, 2 h à 13,06 puis 13,02 V |
|
||||
| MISSISSIPPI | coupures secteur | 160 j `MAINS`, 19 `NOT_MAINS`, 178 inconnus (station éteinte de janvier à mai) | 7 jours 🟢 → 🔴 (08/12, 23/12, 05/06, 02/08, 03/08, 15/08, 05/10) ; 10 jours 🔴 sur secteur en tout |
|
||||
|
||||
- **Délai de détection** (rejeu causal heure par heure, MISSISSIPPI) : rouge 1 à 2 h après la dernière heure à 14 V, contre 29 à 40 h avec la matrice seule (08/12 : 2 h contre 40 h ; 23/12 : 2 h contre 39 h ; 05/06, 15/08, 05/10 : 2 h contre 30 à 33 h). Le 02/08, la matrice ne voyait rien du tout : le secteur, perdu vers 16:00, est revenu le 03/08 vers 02:00, avant que l'état ne descende.
|
||||
- **Coupures non vues par la règle secteur** (statut `NOT_MAINS` ou inconnu ce jour-là) : 19/10/2025 (début de l'historique, fenêtre incomplète : la matrice la voit à +28 h), 11/12/2025 et 07/10/2026 (une deuxième coupure dans les 3 jours qui suivent la précédente, voir « Limites » ; la matrice ne les voit pas non plus dans les 72 h).
|
||||
- **FLORIDA, 10/07** : l'expert juge la station saine, mais note cette baisse à 13,0 V pendant 2 h. Sur secteur, c'est la signature d'une courte perte du secteur : le rouge est cohérent avec la règle, à confirmer avec l'expert.
|
||||
- **MISSISSIPPI, 17/09/2026** : 13,63 puis 13,50 V pendant 2 h, sans passer sous 13,4 V : vert. Peut-être une perte de moins d'une heure par heure, invisible en moyenne horaire.
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| Perte = une heure sous 14,0 V (`FULL_CHARGE_V`), la lecture directe de « toujours pleine » | Sur secteur, les moyennes horaires descendent souvent sous 14,0 V sans coupure : WEISSHORN aurait été rouge 31 jours sur 52 sur secteur, NORDEND 92 sur 97 (creux jusqu'à 13,65 V). |
|
||||
| Statut = toutes les heures des 3 jours ≥ 14,0 V | Même raison : WEISSHORN n'aurait été `MAINS` que par séries de 3 jours au plus. La moyenne absorbe ces creux. |
|
||||
| Fenêtre glissante de 72 h qui finit à l'heure courante | La coupure fait baisser la moyenne : la station repasse `NOT_MAINS` en ~12 h et le rouge disparaît, alors que la coupure continue. |
|
||||
| Un trou de mesure sur secteur compté comme une perte | Sur secteur, la batterie sert d'UPS : une perte se voit d'abord en tension, pas en trou. Un trou n'est pas une coupure (`docs/domaine/pieges-des-donnees.md`). |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. **Après une coupure, 3 jours aveugles** : la fenêtre contient la coupure, la station est `NOT_MAINS` et repasse sur la matrice. Une deuxième coupure dans ces 3 jours n'est vue qu'avec le retard de la matrice (MISSISSIPPI 11/12/2025 et 07/10/2026). La notification affiche alors `Not on mains`, ce qui est vrai pendant la coupure, mais pas pour la raison attendue.
|
||||
2. **Mise en service** : 3 jours complets sont nécessaires avant le premier statut. D'ici là, la matrice s'applique.
|
||||
3. **Pertes de moins d'une heure** : la moyenne horaire peut rester au-dessus de 13,4 V (MISSISSIPPI 17/09/2026, 13,50 V).
|
||||
4. **Chargeur réglé autrement** : un secteur dont le *float* serait sous 14,0 V (13,5–13,8 V en chimie générale) ne serait jamais `MAINS`. Les quatre stations secteur observées tiennent ~14,2 V.
|
||||
5. **Statut déduit, pas déclaré** : l'alimentation réelle de la station n'est pas dans les données (`get_station_meta`, rapport d'agents, n'existe pas encore). `MAINS` est `consistent with` un secteur.
|
||||
|
||||
## Pistes
|
||||
|
||||
- **Statut collant** : garder `MAINS` pendant une coupure en cours (tant que J−1 était `MAINS` et rouge), pour couvrir la limite 1. Change l'articulation : à voir avec le spécialiste avant de le coder.
|
||||
- **Alimentation déclarée** : lire le type d'alimentation dans la configuration de la station quand il sera accessible, et garder la règle comme contrôle.
|
||||
- **Phrase dédiée** : une `HEADLINE` « The station has lost mains power. » pour le rouge sur secteur. Le contrat de notification n'a qu'une phrase par couleur (D-030).
|
||||
|
||||
## Historique
|
||||
|
||||
- **2026-10-13** : créée à la demande de l'utilisateur (cas particulier secteur : batterie toujours pleine, perte à détecter tout de suite ; moyenne glissante sur 3 jours). Les deux seuils viennent des données : 14,0 V pour le statut, 13,4 V et non 14,0 V pour la perte, à cause des creux horaires de WEISSHORN et NORDEND. La couleur du jour, le drawio, le panneau du site et la notification du support l'intègrent (D-043).
|
||||
@@ -94,7 +94,7 @@ Le résumé texte et `out/<STATION>_energy.json` ont été supprimés (D-026) ;
|
||||
- **Classement des trous** : coupure d'alimentation, cause externe, début d'historique, retard de synchronisation. Il s'appuie sur la tension avant et après le trou, comparée au coude LiFePO4 (~12,8 V).
|
||||
- **Signature « station éteinte »** : chute de `sensor_thermal` pendant un trou (l'auto-échauffement de ~5 W s'arrête).
|
||||
- **Taux de jours à charge complète** (≥ 14,0 V) sur 7 jours : alerte plus précoce en solaire (~10 j pour VERMONT). Couvrirait la limite 4.
|
||||
- **Indicateur rapide de perte secteur** : sortie de la tension de maintien. Couvrirait la limite 2.
|
||||
- **Indicateur rapide de perte secteur** : sortie de la tension de maintien. Couvrirait la limite 2. Fait par `DAILY_MAINS_POWER` (2026-10-13, D-043) : rouge 1 à 2 h après la perte sur MISSISSIPPI.
|
||||
- **Autonomie sans apport** : énergie restante ÷ `Power`. Demande la capacité de la batterie (7 ou 21 Ah ; les nuits de VERMONT sont cohérentes avec 21 Ah).
|
||||
|
||||
## Historique
|
||||
|
||||
Reference in new issue
Block a user