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