Files
Support-Agent/docs/energy/analyses/daily_power_source.md
T
maximeandClaude Opus 5.5 997e842568 Rename DAILY_MAINS_POWER to DAILY_POWER_SOURCE
The user's preferred name. The module becomes src/energy/power_source.py
and the sheet docs/energy/analyses/daily_power_source.md; the
calculation and the results are unchanged (D-043).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 17:23:26 +02:00

105 lines
11 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.
# `DAILY_POWER_SOURCE` : 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/power_source.py` (calcul, bibliothèque standard, importe seulement `battery_state` pour ses constantes) ; `src/energy/day_color.py` l'applique ; panneau `power_source_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).
- **2026-10-13** : statut affiché aussi dans l'en-tête du bloc Energy de la vue client. Renommée `DAILY_POWER_SOURCE` (ex-`DAILY_MAINS_POWER`, `mains_power.py`), choix de l'utilisateur ; calcul inchangé.