diff --git a/.claude/rules/analyses.md b/.claude/rules/analyses.md index 0d9e795..e3b1e92 100644 --- a/.claude/rules/analyses.md +++ b/.claude/rules/analyses.md @@ -14,7 +14,7 @@ paths: - **Contrat commun** : - `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}` ; - calcul **causal** : le point t n'utilise que les données ≤ t ; - - `anomaly = None` signifie UNKNOWN (exception : `DAILY_BATTERY_STATE` en phase C, `DAILY_BATTERY_TREND`, `DAILY_LINK_STATE`, `DAILY_SIGNAL_STATE`, `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et `DAILY_MAINS_POWER`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`, `facts.trend`, `facts.filling` ou `facts.power`) ; + - `anomaly = None` signifie UNKNOWN (exception : `DAILY_BATTERY_STATE` en phase C, `DAILY_BATTERY_TREND`, `DAILY_LINK_STATE`, `DAILY_SIGNAL_STATE`, `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et `DAILY_POWER_SOURCE`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`, `facts.trend`, `facts.filling` ou `facts.power`) ; - une analyse seule conclut au plus `consistent with`. - **Code de calcul** (`src//`) : bibliothèque standard uniquement et aucun import de `src/common/`, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`). Le chargement des CSV est dans `common.stations`. - **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source. diff --git a/CLAUDE.md b/CLAUDE.md index d98ff8a..c8703c9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,7 +10,7 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.md`. -- **Energy, livré (prototype, D-020, D-043)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu) ; sur secteur (`DAILY_MAINS_POWER`), la perte du secteur décide à la place de la matrice (rouge dès une heure < 13,4 V), statut `On mains` / `Not on mains` dans la notification du support et dans l'en-tête du bloc Energy de la vue client. Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon. +- **Energy, livré (prototype, D-020, D-043)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu) ; sur secteur (`DAILY_POWER_SOURCE`), la perte du secteur décide à la place de la matrice (rouge dès une heure < 13,4 V), statut `On mains` / `Not on mains` dans la notification du support et dans l'en-tête du bloc Energy de la vue client. Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon. - **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`). - **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025). - **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit. @@ -31,7 +31,7 @@ Code dans `src/energy/`, fiche dans `docs/energy/analyses/ | `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (prototype, D-020) | `battery_trend.py` | | `MOVING_AVERAGE_7_DAYS_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | comparaison : ~2,7 jours d'avance sur la première coupure de VERMONT, mais bruitée (pire cas sain −0,16 V) | `moving_average.py` | | `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC de chaque jour | comparaison : peu bruitée (−0,04 V), mais 1 h d'avance seulement | `moving_average.py` | -| `DAILY_MAINS_POWER` | Chaque jour : sur secteur (moyenne des 3 jours avant J ≥ 14,0 V) ? Si oui, une heure de J < 13,4 V (perte du secteur) ? | livrée (prototype, D-043) ; vérifiée sur WEISSHORN, NORDEND et MISSISSIPPI (historique git) | `mains_power.py` | +| `DAILY_POWER_SOURCE` | Chaque jour : sur secteur (moyenne des 3 jours avant J ≥ 14,0 V) ? Si oui, une heure de J < 13,4 V (perte du secteur) ? | livrée (prototype, D-043) ; vérifiée sur WEISSHORN, NORDEND et MISSISSIPPI (historique git) | `power_source.py` | - **Couleur du jour** : `src/energy/day_color.py` (`MATRIX`, `focus()` pour J−1 / J), transcription de `docs/energy/matrice-etat-tendance.drawio`. - **Travailler sur une analyse** : `.claude/rules/analyses.md` (contrat `run(series)`, calcul causal, constantes sourcées, graphiques, fiche à jour) se charge seul dès qu'on touche `src/` ou `docs/*/analyses/`. @@ -130,12 +130,12 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv - `docs/superpowers/` : specs et plans superpowers (170-850 l chacun). Historique non maintenu, pas une référence. La spec d'une nouvelle analyse s'écrit dans sa fiche ; le plan peut aller dans `docs/superpowers/plans/`. - `data/` : un dossier par station (D-029). - `VERMONT/` : **jeu de travail = VERMONT seule** (D-009), le plus long historique : 7 CSV, un par métrique système (~5 000 l chacun). Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts). - - `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, du 09/08 au 13/10, mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030) ; sur secteur, avec NORDEND, il sert à `DAILY_MAINS_POWER` (D-043). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier ; le dépôt doit rester privé (D-014). + - `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, du 09/08 au 13/10, mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030) ; sur secteur, avec NORDEND, il sert à `DAILY_POWER_SOURCE` (D-043). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier ; le dépôt doit rester privé (D-014). - `NORDEND/` : tous les champs d'une version plus ancienne du collecteur (export du 2026-10-13, 109 jours, sans `link`) ; deuxième jeu de travail de `cellular`, station à la liaison faible (D-032). Mêmes identifiants à ne pas recopier (`SIM_CCID`, `ip_*`). - Les notes brutes de l'expert (`metadata.md`, `d.md`) et `archive/` ont été retirées le 2026-10-13 (D-033) : leur résumé est dans `docs/energy/domaine/cas-annotes-par-l-expert.md`. - `src/` : un sous-dossier par domaine, plus le code commun (D-026). - `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`). - - `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `mains_power.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`. + - `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `power_source.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`. - `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-031). - `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034). - `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040). diff --git a/docs/decisions.md b/docs/decisions.md index 53e3b50..4667f73 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -464,13 +464,13 @@ Règles du journal : - recherche de cas (RAG) tant que les cas tiennent dans le prompt. - **Conséquence** : même cadre que D-027 (harnais maison, *Tool Runner*, dossier déclaratif sous `agents/`, proposé). Coût estimé ~1 $ par enquête, à mesurer à l'étape 1. Prérequis : une clé API Anthropic ; pour l'étape 2, un export de déplacements avec un événement expliqué. Questions ouvertes (sources, liste des classifications, seuils des outils, critère d'ouverture au client) : §9 du document. -## D-043 — 2026-10-13 — Energy : cas particulier de la station sur secteur (`DAILY_MAINS_POWER`) -- **Statut** : active. Complète D-020 (couleur du jour) et D-021 (figure du site) ; précise D-009 pour cette analyse. +## D-043 — 2026-10-13 — Energy : cas particulier de la station sur secteur (`DAILY_POWER_SOURCE`) +- **Statut** : active. Complète D-020 (couleur du jour) et D-021 (figure du site) ; précise D-009 pour cette analyse. Analyse renommée `DAILY_POWER_SOURCE` (ex-`DAILY_MAINS_POWER`) le jour même, choix de l'utilisateur. - **Décision** : - - une nouvelle analyse, `DAILY_MAINS_POWER`, déduit chaque jour si la station est sur secteur : moyenne de `BusVoltage` sur les 3 jours avant J ≥ 14,0 V (demande de l'utilisateur : moyenne glissante sur 3 jours, batterie toujours pleine) ; + - une nouvelle analyse, `DAILY_POWER_SOURCE`, déduit chaque jour si la station est sur secteur : moyenne de `BusVoltage` sur les 3 jours avant J ≥ 14,0 V (demande de l'utilisateur : moyenne glissante sur 3 jours, batterie toujours pleine) ; - **sur secteur, la perte du secteur décide de la couleur, sans la matrice** : rouge dès qu'une heure de J passe sous 13,4 V, vert sinon. Hors secteur (ou statut inconnu), la matrice état × tendance s'applique, inchangée. Le drawio de la matrice a les deux cas ; - la notification du support et l'en-tête du bloc Energy de la vue client affichent le statut : `On mains`, `Not on mains` ou `Mains unknown` ; la figure du site a un troisième panneau, sous l'état et la tendance ; - vérification sur les stations secteur réelles : WEISSHORN et NORDEND (`data/`), et FLORIDA et MISSISSIPPI relues depuis l'historique git sans revenir dans `data/` (D-033). - **Pourquoi** : demande de l'utilisateur. Sur secteur, la batterie sert d'UPS et reste pleine : la matrice lit le jour de la perte `FULL_CHARGE` (vert) et ne passe au rouge que 29 à 40 h plus tard (MISSISSIPPI), alors qu'une batterie de 7 Ah tient ~15 h. La règle secteur donne le rouge 1 à 2 h après la perte. - **Options écartées** : perte = une heure sous 14,0 V (WEISSHORN aurait été rouge 31 jours sur 52 sans coupure, ses moyennes horaires descendent à 13,9 V, celles de NORDEND à 13,65 V) ; une fenêtre qui inclut l'heure courante (la coupure ferait perdre le statut en ~12 h) ; un statut collant pendant la coupure (reporté, fiche « Pistes »). -- **Conséquence** : `day_color.run()` fusionne les faits des trois analyses (`power`, `hours_lost` en plus) ; `focus_jour.py` cite la règle secteur quand elle a décidé ; limites dans la fiche `docs/energy/analyses/daily_mains_power.md`, dont 3 jours sans statut après chaque coupure. +- **Conséquence** : `day_color.run()` fusionne les faits des trois analyses (`power`, `hours_lost` en plus) ; `focus_jour.py` cite la règle secteur quand elle a décidé ; limites dans la fiche `docs/energy/analyses/daily_power_source.md`, dont 3 jours sans statut après chaque coupure. diff --git a/docs/energy/analyses/daily_battery_state.md b/docs/energy/analyses/daily_battery_state.md index 7e23195..9bfb661 100644 --- a/docs/energy/analyses/daily_battery_state.md +++ b/docs/energy/analyses/daily_battery_state.md @@ -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`, 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. +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_POWER_SOURCE` (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 »). diff --git a/docs/energy/analyses/daily_mains_power.md b/docs/energy/analyses/daily_power_source.md similarity index 95% rename from docs/energy/analyses/daily_mains_power.md rename to docs/energy/analyses/daily_power_source.md index 986dd35..618127b 100644 --- a/docs/energy/analyses/daily_mains_power.md +++ b/docs/energy/analyses/daily_power_source.md @@ -1,8 +1,8 @@ -# `DAILY_MAINS_POWER` : sur secteur ou non, et perte du secteur +# `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/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`. +- **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 @@ -101,3 +101,4 @@ VERMONT (solaire) est le jeu de travail d'Energy (D-009), mais il ne contient pa ## 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é. diff --git a/docs/energy/analyses/moving_average_7_days_drop.md b/docs/energy/analyses/moving_average_7_days_drop.md index a7ecf04..47360dd 100644 --- a/docs/energy/analyses/moving_average_7_days_drop.md +++ b/docs/energy/analyses/moving_average_7_days_drop.md @@ -94,7 +94,7 @@ Le résumé texte et `out/_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. Fait par `DAILY_MAINS_POWER` (2026-10-13, D-043) : rouge 1 à 2 h après la perte sur MISSISSIPPI. +- **Indicateur rapide de perte secteur** : sortie de la tension de maintien. Couvrirait la limite 2. Fait par `DAILY_POWER_SOURCE` (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 diff --git a/docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md b/docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md index 45c2621..7365549 100644 --- a/docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md +++ b/docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md @@ -36,7 +36,7 @@ Sources, citées sur chaque chiffre : - **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]. -- **Sur secteur** (WEISSHORN et NORDEND, non annotées par l'expert mais 14,1–14,2 V jour et nuit ; FLORIDA, MISSISSIPPI [E]) : pas de cycle jour/nuit, moyenne sur 3 jours ≥ 14,08 V hors coupure. Les moyennes horaires descendent pourtant sous 14,0 V presque chaque jour, une heure à la fois, jusqu'à 13,65 V (NORDEND, 27/09/2026), sans coupure. Sans secteur, une heure pleine est à 13,1–13,3 V (MISSISSIPPI, 10 coupures). Fiche `DAILY_MAINS_POWER`. +- **Sur secteur** (WEISSHORN et NORDEND, non annotées par l'expert mais 14,1–14,2 V jour et nuit ; FLORIDA, MISSISSIPPI [E]) : pas de cycle jour/nuit, moyenne sur 3 jours ≥ 14,08 V hors coupure. Les moyennes horaires descendent pourtant sous 14,0 V presque chaque jour, une heure à la fois, jusqu'à 13,65 V (NORDEND, 27/09/2026), sans coupure. Sans secteur, une heure pleine est à 13,1–13,3 V (MISSISSIPPI, 10 coupures). Fiche `DAILY_POWER_SOURCE`. - **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 diff --git a/docs/energy/guide/diagnostic-energetique.md b/docs/energy/guide/diagnostic-energetique.md index 8763897..3a0e186 100644 --- a/docs/energy/guide/diagnostic-energetique.md +++ b/docs/energy/guide/diagnostic-energetique.md @@ -75,11 +75,11 @@ Diagnostic de l'expert : interruptions nocturnes dues à un déficit d'énergie. # Partie 2 : annexe technique (support) La couleur du jour combine trois analyses de la tension batterie (`BusVoltage`, moyennes horaires) : -- l'**alimentation** : sur secteur ou non (`DAILY_MAINS_POWER`, D-043). Sur secteur, elle décide seule (§ 7, fin) ; +- l'**alimentation** : sur secteur ou non (`DAILY_POWER_SOURCE`, D-043). Sur secteur, elle décide seule (§ 7, fin) ; - sinon, l'**état** du jour (`DAILY_BATTERY_STATE`) ; - et la **tendance** face à la veille (`DAILY_BATTERY_TREND`). -Le détail de chaque analyse (calcul exact, sources, résultats, options écartées) est dans sa fiche : `docs/energy/analyses/daily_battery_state.md`, `docs/energy/analyses/daily_battery_trend.md` et `docs/energy/analyses/daily_mains_power.md`. +Le détail de chaque analyse (calcul exact, sources, résultats, options écartées) est dans sa fiche : `docs/energy/analyses/daily_battery_state.md`, `docs/energy/analyses/daily_battery_trend.md` et `docs/energy/analyses/daily_power_source.md`. Une couleur reste une preuve imparfaite : elle conclut au plus `consistent with`. Elle signale une journée à regarder, elle ne remplace pas le diagnostic. @@ -147,7 +147,7 @@ Lecture de chaque case, avec le nombre de jours observés sur VERMONT (184 jours - **Jour gris** : l'état ou la tendance est inconnu (moins de 20 h mesurées sans recharge complète ni passage sous le plateau, ou pas de veille). La matrice ne traite pas encore ces cas (D-020, D-021). - **Pourquoi `NO_CHARGE` → est rouge et non orange** : en orange, une coupure d'alimentation passerait du rouge (1er jour, ↘) à l'orange (2e jour, →) alors qu'elle continue. Une batterie assez grande pour rester sur le plateau ne change rien : sans apport, la station tombera (D-004). -### Station sur secteur (`DAILY_MAINS_POWER`) +### Station sur secteur (`DAILY_POWER_SOURCE`) La matrice ne s'applique qu'aux stations **qui ne sont pas sur secteur** (`NOT_MAINS`, ou statut inconnu). Sur secteur, la batterie reste pleine : chaque jour serait `FULL_CHARGE`, et la perte du secteur ne deviendrait rouge que le lendemain (29 à 40 h de retard sur MISSISSIPPI). @@ -167,7 +167,7 @@ La matrice ne s'applique qu'aux stations **qui ne sont pas sur secteur** (`NOT_M Commandes : `python3 src/energy/final.py` écrit la page livrée, `python3 src/energy/all_analyses.py` la page de comparaison ; chacune est écrite dans `out/` et ouverte dans le navigateur. -- `_daily.html` : le graphique destiné au site de monitoring (D-021), soit les panneaux `DAILY_BATTERY_STATE`, `DAILY_BATTERY_TREND` et `DAILY_MAINS_POWER` décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (`_daily.json`), pour `Plotly.newPlot`. +- `_daily.html` : le graphique destiné au site de monitoring (D-021), soit les panneaux `DAILY_BATTERY_STATE`, `DAILY_BATTERY_TREND` et `DAILY_POWER_SOURCE` décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (`_daily.json`), pour `Plotly.newPlot`. - `_energy.html` : la page de comparaison des cinq analyses (`all_analyses.py`), avec ces trois panneaux, et une courbe par mesure dessous. - `_focus_.html` : le focus sur un jour et sa veille (D-024), pour comprendre une couleur. Commande : `python3 src/energy/focus_jour.py 27.09`. Le terminal affiche les faits qui ont produit la couleur ; le graphique montre les 48 h de `BusVoltage`, avec les heures sans mesure en gris, les seuils de 14,0 et 12,8 V, le maximum et la fin de nuit de chaque jour, et une flèche de la fin de nuit de la veille à celle du jour (bleue ↗, grise →, rouge ↘). @@ -184,7 +184,7 @@ Commandes : `python3 src/energy/final.py` écrit la page livrée, `python3 src/e - couleur : bleu ↗, gris →, rouge ↘ ; - tirets : la zone morte de ±0,05 V ; - quand l'état décide, la couleur suit la tendance, même si la barre est petite ou de signe contraire (voir § 6). -- **Panneau `DAILY_MAINS_POWER`**, un point par jour, placé à midi UTC : +- **Panneau `DAILY_POWER_SOURCE`**, un point par jour, placé à midi UTC : - courbe foncée : la moyenne des 3 jours avant J ; courbe claire : le minimum du jour ; - tirets : les seuils de 14,0 V (bleu, statut) et de 13,4 V (rouge, perte) ; - marqueurs sur la moyenne : ● bleu `on mains`, ○ gris `not on mains` ; ✕ rouge sur le minimum : `mains lost`. diff --git a/docs/energy/matrice-etat-tendance.drawio b/docs/energy/matrice-etat-tendance.drawio index 676dc10..88e8479 100644 --- a/docs/energy/matrice-etat-tendance.drawio +++ b/docs/energy/matrice-etat-tendance.drawio @@ -182,7 +182,7 @@ - + diff --git a/maquettes/support/home.py b/maquettes/support/home.py index 385781e..234d619 100644 --- a/maquettes/support/home.py +++ b/maquettes/support/home.py @@ -1,7 +1,7 @@ """Maquette côté support « Home » : page d'accueil du site de monitoring (toutes les stations), avec en haut une section Status. Elle porte une notification par station et par domaine dont le dernier jour de la fenêtre est Orange ou Red (src//day_color.py : Energy, Storage, Cellular, Temperature ; D-025, D-030). Energy y ajoute son statut -d'alimentation, sur secteur ou non (DAILY_MAINS_POWER, D-043). +d'alimentation, sur secteur ou non (DAILY_POWER_SOURCE, D-043). La notification, comme la vignette de la station, mène à la vue client de la station (son menu principal) : out/maquette_user_.html, écrite par maquettes/user/summary.py (à lancer avec les mêmes dates). diff --git a/maquettes/user/summary.py b/maquettes/user/summary.py index f355124..3f84df6 100644 --- a/maquettes/user/summary.py +++ b/maquettes/user/summary.py @@ -4,7 +4,7 @@ Chaque bloc : couleur du dernier jour de la fenêtre et sa phrase (src//day_color.py), deux lignes en mots simples (Energy : échelle de batterie et tendance ; Storage : échelle de l'espace libre et date de saturation ; Cellular : envois du jour et échelle du signal ; Temperature : maximum des 24 h et limite), puis historique complet (src//final.py, D-021) et guide (partie 1), repliés. -Energy affiche aussi, dans son en-tête, si la station est sur secteur ou non (DAILY_MAINS_POWER, D-043). +Energy affiche aussi, dans son en-tête, si la station est sur secteur ou non (DAILY_POWER_SOURCE, D-043). Données réelles : une page par station de data/. Écrit out/maquette_user_.html et les ouvre dans le navigateur. Usage : python3 maquettes/user/summary.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28) """ diff --git a/maquettes/user/summary_template.html b/maquettes/user/summary_template.html index 7981d8e..4330eb1 100644 --- a/maquettes/user/summary_template.html +++ b/maquettes/user/summary_template.html @@ -267,7 +267,7 @@ for (const [key, dom] of Object.entries(DATA.domains)) { el.id = key; el.querySelector(".name").textContent = name; el.querySelector(".status").outerHTML = chip(c); - // Energy : sur secteur ou non, visible sans ouvrir le bloc (DAILY_MAINS_POWER, D-043) ; null = statut inconnu. + // Energy : sur secteur ou non, visible sans ouvrir le bloc (DAILY_POWER_SOURCE, D-043) ; null = statut inconnu. if (key === "energy") el.querySelector(".status").insertAdjacentHTML("afterend", `${R.power_label[cur.power ?? null]}`); el.querySelector(".meta").textContent = `${DATA.label} · ${ACTION[c] || "Check data"}`; diff --git a/src/energy/all_analyses.py b/src/energy/all_analyses.py index d07c3b8..2c5afdb 100644 --- a/src/energy/all_analyses.py +++ b/src/energy/all_analyses.py @@ -10,8 +10,8 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque) from common.stations import gaps, load_stations # noqa: E402 from plotly.subplots import make_subplots # noqa: E402 -from energy import battery_state as bs, battery_trend as bt, mains_power as mp, moving_average as ma # noqa: E402 -from energy.final import daily_state_panel, daily_trend_panel, mains_power_panel # noqa: E402 +from energy import battery_state as bs, battery_trend as bt, power_source as ps, moving_average as ma # noqa: E402 +from energy.final import daily_state_panel, daily_trend_panel, power_source_panel # noqa: E402 # Zones de BusVoltage selon l'état de la batterie (bandes de fond) : docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md. # [V] = VERMONT, 5e-95e centiles horaires ; [M] = manuel ; [E] = experts. Les zones « en charge » et « décharge » @@ -38,8 +38,8 @@ def figure(station, series, results): if result["analysis"] == bt.RULE["id"]: daily_trend_panel(fig, result, row) continue - if result["analysis"] == mp.RULE["id"]: - mains_power_panel(fig, result, row) + if result["analysis"] == ps.RULE["id"]: + power_source_panel(fig, result, row) continue analyse = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") thr = result["rule"]["threshold_v"] @@ -85,7 +85,7 @@ def main(paths): print(f"{station} : ignorée, pas de BusVoltage") continue path = ROOT / "out" / f"{station}_energy.html" - results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series), mp.run(series)] + results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series), ps.run(series)] figure(station, series, results).write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True}) print(path) diff --git a/src/energy/day_color.py b/src/energy/day_color.py index e7986a4..b14596c 100644 --- a/src/energy/day_color.py +++ b/src/energy/day_color.py @@ -1,4 +1,4 @@ -"""Couleur du jour : sur secteur (DAILY_MAINS_POWER), la perte du secteur décide (D-043) ; sinon, matrice +"""Couleur du jour : sur secteur (DAILY_POWER_SOURCE), la perte du secteur décide (D-043) ; sinon, matrice état (DAILY_BATTERY_STATE) × tendance (DAILY_BATTERY_TREND) -> vert / orange / rouge (D-020). Documentation : docs/energy/guide/diagnostic-energetique.md (§ 7, la matrice) @@ -6,7 +6,7 @@ Bibliothèque standard uniquement (cible : système embarqué de la station). """ from datetime import timedelta -from energy import battery_state as bs, battery_trend as bt, mains_power as mp +from energy import battery_state as bs, battery_trend as bt, power_source as ps # Matrice tenue par l'utilisateur dans docs/energy/matrice-etat-tendance.drawio : MATRIX[état][tendance]. MATRIX = { @@ -22,14 +22,14 @@ HEADLINE = {"GREEN": "The station is receiving enough energy.", "ORANGE": "The station's energy supply is uncertain.", "RED": "The station is not receiving enough energy."} -# Statut d'alimentation (DAILY_MAINS_POWER), en anglais (D-023), repris par les notifications du support. +# Statut d'alimentation (DAILY_POWER_SOURCE), en anglais (D-023), repris par les notifications du support. POWER_LABEL = {"MAINS": "On mains", "NOT_MAINS": "Not on mains", None: "Mains unknown"} RULE = { "id": "DAY_COLOR", "verdict": "aucun : anomaly = None ; la couleur est dans facts.color (None = inconnu, état ou tendance absent)", "mains": "power = MAINS : RED si une heure de J < mains_lost_v (hours_lost > 0), sinon GREEN ; la matrice sinon", - "mains_lost_v": mp.MAINS_LOST_V, + "mains_lost_v": ps.MAINS_LOST_V, "matrix": MATRIX, "doc": "docs/energy/guide/diagnostic-energetique.md", } @@ -38,8 +38,8 @@ RULE = { def run(series): """Couleur du jour, causale comme ses trois analyses (J, J−1, et les 3 jours avant J). Un point par jour UTC.""" points = [] - # Mêmes jours, même ordre : bt part de bs, mp parcourt les mêmes horodatages de BusVoltage. - for s, t, m in zip(bs.run(series)["points"], bt.run(series)["points"], mp.run(series)["points"]): + # Mêmes jours, même ordre : bt part de bs, ps parcourt les mêmes horodatages de BusVoltage. + for s, t, m in zip(bs.run(series)["points"], bt.run(series)["points"], ps.run(series)["points"]): facts = {**s["facts"], **t["facts"], **m["facts"]} if facts["power"] == "MAINS": # batterie toujours pleine : une heure sans chargeur suffit, sans attendre J+1 facts["color"] = None if facts["hours_lost"] is None else "RED" if facts["hours_lost"] else "GREEN" diff --git a/src/energy/final.py b/src/energy/final.py index 4128cfd..3d5e427 100644 --- a/src/energy/final.py +++ b/src/energy/final.py @@ -1,8 +1,8 @@ -"""Analyses livrées (D-020, D-043) : DAILY_BATTERY_STATE, DAILY_BATTERY_TREND et DAILY_MAINS_POWER, en une figure pour le site (D-021). +"""Analyses livrées (D-020, D-043) : DAILY_BATTERY_STATE, DAILY_BATTERY_TREND et DAILY_POWER_SOURCE, en une figure pour le site (D-021). Usage : python3 src/energy/final.py [CSV ou dossiers...] (défaut : data/VERMONT/) Écrit out/_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre. -Documentation : docs/energy/analyses/daily_battery_state.md, daily_battery_trend.md et daily_mains_power.md +Documentation : docs/energy/analyses/daily_battery_state.md, daily_battery_trend.md et daily_power_source.md """ import sys from pathlib import Path @@ -13,7 +13,7 @@ from datetime import datetime, time, timezone # noqa: E402 from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque) from common.stations import load_stations # noqa: E402 from plotly.subplots import make_subplots # noqa: E402 -from energy import battery_state as bs, battery_trend as bt, mains_power as mp # noqa: E402 +from energy import battery_state as bs, battery_trend as bt, power_source as ps # noqa: E402 # États de DAILY_BATTERY_STATE : couleurs validées par le skill dataviz (toutes paires, fond blanc). # Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol. @@ -86,12 +86,12 @@ def daily_trend_panel(fig, result, row): fig.update_yaxes(title_text="Δ night end [V]", row=row, col=1) -# Statuts de DAILY_MAINS_POWER : paire bleu/rouge et gris neutre déjà validés (TREND_STYLE), chacun avec son symbole. +# Statuts de DAILY_POWER_SOURCE : paire bleu/rouge et gris neutre déjà validés (TREND_STYLE), chacun avec son symbole. POWER_STYLE = {"MAINS": ("on mains", "#2a78d6", "circle"), "NOT_MAINS": ("not on mains", "#8c8c8c", "circle-open")} -def mains_power_panel(fig, result, row): - """Panneau DAILY_MAINS_POWER : moyenne des 3 jours avant J (statut en marqueurs), minimum de J (perte en croix).""" +def power_source_panel(fig, result, row): + """Panneau DAILY_POWER_SOURCE : moyenne des 3 jours avant J (statut en marqueurs), minimum de J (perte en croix).""" group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}") rule, pts = result["rule"], result["points"] x = [noon(p["t"].date()) for p in pts] @@ -124,12 +124,12 @@ def mains_power_panel(fig, result, row): def daily_figure(station, series): """Graphique pour le site de monitoring (D-021) : DAILY_BATTERY_STATE en haut, DAILY_BATTERY_TREND dessous, - puis DAILY_MAINS_POWER (D-043), même axe du temps.""" + puis DAILY_POWER_SOURCE (D-043), même axe du temps.""" fig = make_subplots(rows=3, cols=1, shared_xaxes=True, vertical_spacing=0.06, - subplot_titles=[f"Analysis {r['id']}" for r in (bs.RULE, bt.RULE, mp.RULE)]) + subplot_titles=[f"Analysis {r['id']}" for r in (bs.RULE, bt.RULE, ps.RULE)]) daily_state_panel(fig, bs.run(series), 1) daily_trend_panel(fig, bt.run(series), 2) - mains_power_panel(fig, mp.run(series), 3) + power_source_panel(fig, ps.run(series), 3) fig.update_xaxes(showticklabels=True) fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS fig.update_layout(title=f"{station}: battery state and trend, mains power", height=1000, barmode="overlay", diff --git a/src/energy/focus_jour.py b/src/energy/focus_jour.py index 56a7388..36db641 100644 --- a/src/energy/focus_jour.py +++ b/src/energy/focus_jour.py @@ -12,7 +12,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c from common.page import ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque) from common.stations import gaps, load_stations # noqa: E402 import plotly.graph_objects as go # noqa: E402 -from energy import battery_state as bs, battery_trend as bt, day_color as dc, mains_power as mp # noqa: E402 +from energy import battery_state as bs, battery_trend as bt, day_color as dc, power_source as ps # noqa: E402 from energy.final import STATE_STYLE, TREND_STYLE, noon # noqa: E402 # Statuts : noms et couleurs de la maquette System Summary (maquettes/user/summary_template.html). @@ -38,9 +38,9 @@ def summary(station, f): """Résumé texte traçable : couleur, règle, faits de J−1 et de J, tendance et ce qui l'a décidée.""" d, prev, cur = f["day"], f["prev"], f["cur"] lines = [f"{station}, {d:%d/%m/%Y}: {COLOR[f['color']][0]}"] - if cur["power"] == "MAINS": # sur secteur, la perte du secteur décide (fiche daily_mains_power) - lines.append(f" rule: on mains (3-day mean {cur['mean_3_days_v']} V ≥ {mp.MAINS_MEAN_V} V):" - f" {cur['hours_lost']} h < {mp.MAINS_LOST_V} V → {f['color'] or 'unknown'}") + if cur["power"] == "MAINS": # sur secteur, la perte du secteur décide (fiche daily_power_source) + lines.append(f" rule: on mains (3-day mean {cur['mean_3_days_v']} V ≥ {ps.MAINS_MEAN_V} V):" + f" {cur['hours_lost']} h < {ps.MAINS_LOST_V} V → {f['color'] or 'unknown'}") else: lines.append(f" rule: {dc.POWER_LABEL[cur['power']].lower()}, matrix state × trend (user manual § 7):" f" {cur['state']} × {cur['trend']} → {f['color'] or 'unknown'}") diff --git a/src/energy/mains_power.py b/src/energy/power_source.py similarity index 83% rename from src/energy/mains_power.py rename to src/energy/power_source.py index 9d8c16d..177cb64 100644 --- a/src/energy/mains_power.py +++ b/src/energy/power_source.py @@ -1,6 +1,6 @@ -"""DAILY_MAINS_POWER : la station est-elle sur secteur ? Sur secteur, a-t-elle perdu le secteur ce jour-là ? +"""DAILY_POWER_SOURCE : la station est-elle sur secteur ? Sur secteur, a-t-elle perdu le secteur ce jour-là ? -Documentation : docs/energy/analyses/daily_mains_power.md +Documentation : docs/energy/analyses/daily_power_source.md Bibliothèque standard uniquement (cible : système embarqué de la station). """ import math @@ -9,25 +9,25 @@ from datetime import timedelta from energy import battery_state as bs -# Constantes (fiche daily_mains_power, « Constantes et sources »). +# Constantes (fiche daily_power_source, « Constantes et sources »). WINDOW_DAYS = 3 # demande de l'utilisateur : moyenne glissante sur les 3 jours qui précèdent J MAINS_MEAN_V = bs.FULL_CHARGE_V # 14,0 V : moyenne sur 3 jours, solaire <= 13,50 V (VERMONT), secteur >= 14,08 V (4 stations) MAINS_LOST_V = 13.4 # haut du plateau (table OCV) : secteur présent >= 13,65 V à l'heure, heure pleine sans secteur 13,11-13,30 V (MISSISSIPPI) MIN_COVERAGE = bs.MIN_COVERAGE # 0,8 : 58 h mesurées sur 72 RULE = { - "id": "DAILY_MAINS_POWER", + "id": "DAILY_POWER_SOURCE", "verdict": "aucun : anomaly = None ; le statut est dans facts.power, la perte du secteur dans facts.hours_lost", "window_days": WINDOW_DAYS, "mains_mean_v": MAINS_MEAN_V, "mains_lost_v": MAINS_LOST_V, "min_coverage": MIN_COVERAGE, - "doc": "docs/energy/analyses/daily_mains_power.md", + "doc": "docs/energy/analyses/daily_power_source.md", } def run(series): - """Analyse DAILY_MAINS_POWER, causale : le statut de J vient des 3 jours avant J, la perte des heures de J. + """Analyse DAILY_POWER_SOURCE, causale : le statut de J vient des 3 jours avant J, la perte des heures de J. Un point par jour UTC, les mêmes jours que DAILY_BATTERY_STATE.""" v = series["BusVoltage"] days, last = defaultdict(list), {}