- **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.
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`.
**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 |
| 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é.