From 7b1da6d7cf0ffcd6fe9a8d0041a12036f2f65488 Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 12 Oct 2026 09:31:52 +0200 Subject: [PATCH] Add analysis 02 (midnight sample), simplify plots, spell out rule names - Analysis 02 MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP: same rule as analysis 01 on the 00:00 UTC BusVoltage sample only, one point per day. Shared computation in energy_check._ma_drop(); analysis 01 results unchanged on VERMONT. - Common page: one panel per analysis (02 under 01), then the time series (D-016); src/analyse_02.py launches that page. - Analysis panel reduced to two curves on one volt axis: 7-day mean and threshold; gap and reference moved to hover (D-015). - Date tick labels under every subplot. - Rule IDs spelled out: MA7D_DROP -> MOVING_AVERAGE_7_DAYS_DROP, MA7D_MIDNIGHT_DROP -> MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP (D-017). - Docs: analysis sheet 02, sheet 01, CLAUDE.md, README, decisions D-015..D-017, analysis rule and nouvelle-analyse skill. Co-Authored-By: Claude Opus 5.5 --- .claude/rules/analyses.md | 2 +- .claude/skills/nouvelle-analyse/SKILL.md | 1 + CLAUDE.md | 11 ++-- README.md | 2 +- docs/analyses/analyse_01.md | 17 ++--- docs/analyses/analyse_02.md | 80 ++++++++++++++++++++++++ docs/decisions.md | 23 +++++++ src/analyse_01.py | 3 +- src/analyse_02.py | 10 +++ src/energy_check.py | 63 +++++++++++++------ src/energy_plot.py | 72 +++++++++++---------- 11 files changed, 214 insertions(+), 70 deletions(-) create mode 100644 docs/analyses/analyse_02.md create mode 100644 src/analyse_02.py diff --git a/.claude/rules/analyses.md b/.claude/rules/analyses.md index 7831956..41d6926 100644 --- a/.claude/rules/analyses.md +++ b/.claude/rules/analyses.md @@ -19,7 +19,7 @@ paths: - **Code de calcul** : bibliothèque standard uniquement, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`). - **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source. - **Graphique** : - - en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011) ; + - en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011). Des analyses à comparer partagent une page, un panneau chacune (D-016) ; - zoom horizontal seulement, avec l'ordonnée recalée sur la plage visible (`post_script=energy_plot.AUTOSCALE_Y_JS`, ordonnées en `fixedrange`, D-013). - **Après modification** : - mettre à jour la fiche dans le même changement (résultats, limites, historique) ; diff --git a/.claude/skills/nouvelle-analyse/SKILL.md b/.claude/skills/nouvelle-analyse/SKILL.md index 1c40341..5916f62 100644 --- a/.claude/skills/nouvelle-analyse/SKILL.md +++ b/.claude/skills/nouvelle-analyse/SKILL.md @@ -22,6 +22,7 @@ description: Créer une nouvelle analyse numérotée (analyse_NN) dans le projet - les constantes **avec leur source** ; - les options écartées. - Statut : « en conception ». +- Nom de la règle : en anglais, majuscules, **mots complets sans abréviation** (ex. `MOVING_AVERAGE_7_DAYS_DROP`, D-017). ## 3. Écrire le code diff --git a/CLAUDE.md b/CLAUDE.md index 7f1a29b..6ef7a6c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,19 +12,22 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti - **2026-10-09** : l'analyse 01 est en place sur VERMONT et produit un graphique HTML. C'est un prototype expérimental, sans tests automatisés. - **Point ouvert de l'analyse 01** : l'accoutumance. Après plus de 30 jours de déficit, l'anomalie peut disparaître (voir sa fiche). -- **Prochaine étape** : choisir l'analyse 02 parmi les pistes de la fiche 01 (classement des trous, taux de jours à charge complète, perte secteur rapide, autonomie), puis combiner les analyses. +- **2026-10-12** : analyse 02 (`MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, suggestion d'un collègue) en place, en panneau sous la 01 pour comparer. Elle est bien moins bruitée (pire cas sain −0,04 V contre −0,16 V), mais plus tardive sur VERMONT : 1 h avant la première coupure, contre ~2,7 jours pour la 01. +- **Prochaine étape** : choisir l'analyse 03 parmi les pistes des fiches (classement des trous, taux de jours à charge complète, perte secteur rapide, autonomie, seuil resserré pour la 02), puis combiner les analyses. ## Analyses | N° | Nom | Question | Statut | Fiche | |---|---|---|---|---| -| 01 | `MA7D_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | prototype en place | `docs/analyses/analyse_01.md` | +| 01 | `MOVING_AVERAGE_7_DAYS_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | prototype en place | `docs/analyses/analyse_01.md` | +| 02 | `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC de chaque jour | prototype en place | `docs/analyses/analyse_02.md` | Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-analyse/`). ## Commandes -- `python3 src/analyse_01.py` : point d'entrée de l'analyse 01. Il analyse `data/`, écrit `out/_energy.html` et l'ouvre dans le navigateur (via `explorer.exe` sous WSL). Il bascule seul sur `.venv` si plotly manque. +- `python3 src/analyse_01.py` : point d'entrée de l'analyse 01. Il analyse `data/`, écrit `out/_energy.html` (panneaux des analyses 01 et 02, D-016) et l'ouvre dans le navigateur (via `explorer.exe` sous WSL). Il bascule seul sur `.venv` si plotly manque. +- `python3 src/analyse_02.py` : point d'entrée de l'analyse 02 ; il lance la même page. - `python3 src/energy_check.py data/` : résumé texte + `out/_energy.json` (`out/` est ignoré par git). - `.venv/bin/python src/energy_plot.py data/` : graphique seul (plotly.js est chargé depuis le CDN). @@ -69,7 +72,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana - **Analyses combinées** : chaque analyse est une preuve imparfaite, juste « dans la majorité des cas » ; la combinaison fait le diagnostic. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h). - 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. - Une analyse seule conclut au plus `consistent with`. -- **Livrable** : un graphique HTML par station. En haut, l'analyse (courbes superposées) ; dessous, un graphique par série temporelle. Zoom dans le temps seulement, avec l'ordonnée recalée sur la plage visible (D-011, D-013). +- **Livrable** : un graphique HTML par station. En haut, les analyses, un panneau chacune (courbes superposées, D-016) ; dessous, un graphique par série temporelle. Zoom dans le temps seulement, avec l'ordonnée recalée sur la plage visible (D-011, D-013). - **Ouvert** : architecture (à définir plus tard, ne pas la figer ici), destinataire du diagnostic (client final ou ingénieur support). ## L'essentiel du domaine (détail : `docs/domaine/`) diff --git a/README.md b/README.md index cce7980..b52e4f5 100644 --- a/README.md +++ b/README.md @@ -30,4 +30,4 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c ## État -Prototype expérimental, sans tests automatisés. Une analyse est en place : `MA7D_DROP`, la tendance de la tension batterie sur 7 jours. Les suivantes sont listées dans `docs/analyses/analyse_01.md` (section « Pistes »). +Prototype expérimental, sans tests automatisés. Deux analyses sont en place : `MOVING_AVERAGE_7_DAYS_DROP`, la tendance de la tension batterie sur 7 jours, et `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, la même sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/analyses/` (section « Pistes »). diff --git a/docs/analyses/analyse_01.md b/docs/analyses/analyse_01.md index 43057cd..2925572 100644 --- a/docs/analyses/analyse_01.md +++ b/docs/analyses/analyse_01.md @@ -1,9 +1,9 @@ -# Analyse 01 — `MA7D_DROP` : tendance de la tension batterie +# Analyse 01 — `MOVING_AVERAGE_7_DAYS_DROP` : tendance de la tension batterie - **Statut** : prototype, en place (2026-10-09). -- **Script** : `python3 src/analyse_01.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/_energy.html` et l'ouvre dans le navigateur. +- **Script** : `python3 src/analyse_01.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/_energy.html` et l'ouvre dans le navigateur. La page montre aussi l'analyse 02, juste dessous (D-016). - **Code** : - - `src/energy_check.py` : chargement et calcul, bibliothèque standard uniquement ; + - `src/energy_check.py` : chargement et calcul, bibliothèque standard uniquement. `run()` appelle `_ma_drop()`, commun avec l'analyse 02 ; - `src/energy_plot.py` : graphique plotly. ## Question posée @@ -35,14 +35,16 @@ Le calcul est **causal** : le point t n'utilise que les données ≤ t, donc il ## Graphique Disposition (D-011) : -- **En haut, l'analyse**, courbes superposées : - - l'écart, sur l'axe de gauche, avec une ligne à −0,2 V ; - - la moyenne sur 7 jours, la référence et le seuil en volts, sur l'axe de droite ; +- **En haut, l'analyse**, sur un seul axe en volts (D-015) : + - la moyenne sur 7 jours (bleu) ; + - le seuil = référence − 0,2 V (rouge) : l'anomalie commence là où la bleue passe sous la rouge ; - un fond rouge sur les périodes d'anomalie. +- **Juste dessous, le panneau de l'analyse 02** (`MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`), mêmes conventions, pour comparer les deux méthodes (D-016). - **Dessous, un graphique par série temporelle**, chacun avec sa propre échelle : `BusVoltage` d'abord (bandes grises sur ses trous), puis les autres champs par ordre alphabétique. +- **Abscisse** : les dates sont affichées sous chaque graphique, pas seulement sous le dernier. - **Zoom** : il est horizontal seulement, dans le temps, et commun à tous les graphiques. On zoome en tirant un rectangle ou à la molette (`scrollZoom`). Après chaque zoom ou déplacement, l'ordonnée de chaque graphique est recalée sur les points visibles, avec 5 % de marge (`AUTOSCALE_Y_JS` dans `energy_plot.py`). La ligne de seuil reste toujours visible. Un double-clic revient à la vue complète. - Le script utilise l'API interne de plotly.js (`_fullLayout`, `d2l`, `r2l`). La version de plotly.js chargée depuis le CDN est celle du paquet Python, donc figée, mais une mise à jour majeure de plotly pourrait casser ce script. -- **Survol** : il affiche les faits du point (`ma_v`, `ref_v`, `ref_t`, couverture). +- **Survol** (sur la moyenne) : il affiche l'écart, le verdict et les faits du point (`ma_v`, `ref_v`, `ref_t`, couverture). `python3 src/energy_check.py data/` produit en plus `out/_energy.json` (tous les points avec leurs faits) et un résumé texte. Ce résumé donne les périodes d'anomalie, les heures sans verdict et la plus longue plage UNKNOWN. @@ -102,3 +104,4 @@ Disposition (D-011) : - point d'entrée `analyse_01.py` ; - tests supprimés (D-008) ; - jeu réduit à VERMONT (D-009). +- **2026-10-12** : panneau d'analyse réduit à 2 courbes sur un seul axe (D-015) ; l'écart et la référence passent au survol. Le calcul passe dans `_ma_drop()`, partagé avec l'analyse 02 (résultats inchangés, vérifié sur VERMONT), et la page reçoit le panneau de l'analyse 02 (D-016). Renommée de `MA7D_DROP` en `MOVING_AVERAGE_7_DAYS_DROP` (D-017). diff --git a/docs/analyses/analyse_02.md b/docs/analyses/analyse_02.md new file mode 100644 index 0000000..73d3dd0 --- /dev/null +++ b/docs/analyses/analyse_02.md @@ -0,0 +1,80 @@ +# Analyse 02 — `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` : tendance de la tension batterie à minuit + +- **Statut** : prototype, en place (2026-10-12). +- **Script** : `python3 src/analyse_02.py [CSV ou dossiers]` (défaut : `data/`). Il lance la page commune de `analyse_01.py` : `out/_energy.html`, où cette analyse est le panneau placé sous `MOVING_AVERAGE_7_DAYS_DROP` (D-016). +- **Code** : + - `src/energy_check.py` : `run_midnight()` et `RULE_MIDNIGHT`, bibliothèque standard uniquement. Le calcul est celui de `MOVING_AVERAGE_7_DAYS_DROP` (`_ma_drop()`, commun aux deux analyses) ; + - `src/energy_plot.py` : graphique plotly. + +## Question posée + +La tension batterie relevée chaque jour à 00:00 UTC décroche-t-elle de son propre passé récent ? C'est la méthode de l'analyse 01 appliquée à une seule mesure par jour. Suggestion d'un collègue (2026-10-12), pour comparer les deux méthodes. Le lien avec D-004 (régime non soutenable) est le même que pour l'analyse 01, avec une réserve (voir « Limites connues », point 1). + +## Principe + +On ne garde que la mesure de 00:00 UTC de chaque jour d, puis on applique le calcul de `MOVING_AVERAGE_7_DAYS_DROP` avec des fenêtres converties en jours. Sur VERMONT, 00:00 UTC tombe la nuit : la batterie n'est pas en charge (voir « Constantes et sources »). + +Calcul exact, pour chaque jour d (un point par jour, horodaté à 00:00 UTC) : +1. `x(d)` = `BusVoltage` à d 00:00 UTC. Une valeur vide, `NaN` ou `inf` compte comme « pas de mesure ». +2. `ma(d)` = moyenne des `x` non vides sur les 7 jours d−6 … d. Elle n'est définie que si au moins 80 % des jours sont remplis, soit 6 sur 7. +3. `ref(d)` = maximum de `ma` sur les 30 jours d−30 … d−1. Elle n'est définie que si au moins 1 de ces `ma` existe. +4. `value(d)` = `ma(d)` − `ref(d)`, en V. +5. `anomaly(d)` = `value < −0,2` ; vaut `None` (UNKNOWN) si `ma` ou `ref` n'est pas défini. + +Le calcul est **causal** : le point d n'utilise que les mesures de minuit ≤ d. `facts` contient `coverage` (part des 7 jours remplis), `ma_v`, `ref_v` et `ref_t`. + +## Constantes et sources + +| Constante | Valeur | Source | +|---|---|---| +| Heure d'échantillonnage | 00:00 UTC | Suggestion du collègue. Sur VERMONT, c'est la nuit : profil horaire moyen de `BusVoltage` (avril–octobre 2026) avec un maximum à 13:00 UTC (13,93 V) et un plateau nocturne de 13,11 à 13,13 V de 23:00 à 05:00 UTC. | +| `window_d` | 7 | `WINDOW_H` / 24 (analyse 01). | +| `ref_d` | 30 | `REF_H` / 24 (analyse 01). | +| `min_coverage` | 0,8 | Repris de l'analyse 01 : 6 jours remplis sur 7. | +| `min_ref_points` | 1 | `MIN_REF_POINTS` / 24 : au moins un jour de référence, comme dans l'analyse 01. | +| `threshold_v` | −0,2 | Repris de l'analyse 01 pour comparer les méthodes à seuil égal. **Non recalibré** : voir « Pistes ». | + +## Graphique + +- **Page commune** (D-016) : le panneau `MOVING_AVERAGE_7_DAYS_DROP` en haut, ce panneau juste dessous, puis un graphique par série temporelle. +- Mêmes conventions que l'analyse 01 : + - moyenne sur 7 jours (bleu) et seuil = référence − 0,2 V (rouge), sur un seul axe en volts (D-015) ; + - fond rouge sur les périodes d'anomalie ; + - survol : écart, verdict et faits du point. +- Un point par jour, à 00:00 UTC. Un jour sans verdict coupe la courbe. + +## Résultats sur VERMONT (jeu de travail) + +- Anomalie **à partir du 2026-09-27 00:00**, jusqu'à la fin de l'export. La première coupure nocturne est le 2026-09-27 01:00 : **1 h d'avance seulement**. `MOVING_AVERAGE_7_DAYS_DROP` se déclenche le 2026-09-24 07:00, ~2,7 jours plus tôt. +- Pire écart le 2026-10-09 00:00 : moyenne sur 7 jours 12,56 V, soit 0,61 V sous son maximum du 2026-09-15 (13,17 V). +- **Bruit bien plus faible** : avant le 20/09 (début du déficit selon l'expert), le pire écart est −0,04 V (2026-05-11). C'est le même épisode nuageux de mai qui donne le pire cas sain de l'analyse 01, à −0,16 V. +- L'écart reste dans le bruit sain (≥ −0,05 V) jusqu'au 2026-09-23. Il vaut ensuite −0,06 V le 24/09, −0,09 V le 25/09 et −0,13 V le 26/09, sans atteindre le seuil de −0,2 V. +- **Pourquoi ~2,7 jours d'écart avec `MOVING_AVERAGE_7_DAYS_DROP`** (valeurs de septembre 2026) : + - la journée se dégrade d'abord : après le 08/09, seuls les 11, 18 et 19/09 atteignent 14 V, et la moyenne de 9 à 16 h UTC passe de 13,6–13,9 V à ~13,3 V. La nuit reste sur le plateau, entre 13,05 et 13,18 V, jusqu'au 22/09. `MOVING_AVERAGE_7_DAYS_DROP` voit l'apport baisser, cette analyse ne voit rien ; + - la nuit chute ensuite vite : la mesure de minuit est déjà à −0,19 V de la référence le 24/09 et à −0,23 V le 25/09. La moyenne sur 7 jours dilue cette chute, et ne passe le seuil que le 27/09. +- 6 jours sans verdict sur 183, tous en début d'historique (montée en charge des fenêtres). 3 minuits sans mesure : 2026-07-23, 2026-10-01 et 2026-10-08 (les deux derniers pendant la période des coupures nocturnes). + +## Options écartées + +| Option | Pourquoi écartée | +|---|---| +| Moyenne glissante horaire (analyse 01) évaluée seulement à 00:00 | Autre lecture de la suggestion. Elle donne exactement les valeurs de `MOVING_AVERAGE_7_DAYS_DROP` à minuit : rien de nouveau à comparer. | + +## Limites connues + +1. **Plus tardive** : la tension de nuit reste plate sur le plateau LiFePO4 (30–90 % de charge) et ne chute qu'au coude. La mesure de minuit ne bouge donc que lorsque la batterie est déjà basse. Elle décrit plutôt le niveau de charge que la soutenabilité (D-004), un peu comme le seuil absolu au coude écarté dans l'analyse 01. Sur VERMONT : 1 h d'avance sur la première coupure. +2. **Une mesure par jour** : un minuit manquant fait perdre un jour entier, et deux minuits manquants sur 7 font passer le point en UNKNOWN. Le risque augmente avec le déficit : si les coupures nocturnes commencent avant minuit, l'analyse devient aveugle au moment où la situation s'aggrave. Sur VERMONT, la couverture est déjà à 6/7 depuis le 2026-10-01. +3. **Heure en UTC** : 00:00 UTC n'est la nuit que pour une station dont la longitude s'y prête. Ailleurs, on mesurerait en pleine charge. Ce n'est pas une règle transposable telle quelle. +4. **Seuil non recalibré** : −0,2 V vient de l'analyse 01, dont le pire écart sain est 4 fois plus grand (−0,16 V contre −0,04 V). Aucune station saine n'est dans le jeu de travail pour recalibrer (D-009). +5. **Verdict une fois par jour** : jusqu'à 24 h de latence. +6. **Accoutumance** : comme pour l'analyse 01, la référence de 30 jours finit par s'aligner sur un déficit qui dure. +7. **Pas de résumé texte ni de JSON** : `python3 src/energy_check.py` ne traite que `MOVING_AVERAGE_7_DAYS_DROP`. + +## Pistes + +- **Resserrer le seuil** : avec un pire cas sain à −0,04 V, un seuil à −0,1 V se serait déclenché le 2026-09-26 00:00 (~1 jour avant la coupure), et un seuil à −0,05 V le 2026-09-24 00:00, mais avec une marge de 0,01 V seulement. À vérifier sur des stations saines (`data/archive/` contient `BusVoltage` de FLORIDA et JUNGFRAU, à réintroduire seulement sur demande). +- **Minimum nocturne relatif** au lieu de la valeur de minuit : il ne dépend plus de l'heure UTC et un seul trou ne fait plus perdre le jour. À distinguer du seuil absolu sur le minimum nocturne, écarté dans l'analyse 01. + +## Historique + +- **2026-10-12** : création, sur la suggestion d'un collègue. Calcul commun avec l'analyse 01 (`_ma_drop()`), panneau placé sous `MOVING_AVERAGE_7_DAYS_DROP` dans la page commune (D-016). Le même jour, renommée de `MA7D_MIDNIGHT_DROP` en `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` (D-017). diff --git a/docs/decisions.md b/docs/decisions.md index 82cf4bb..7f4a7bf 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -124,3 +124,26 @@ Règles du journal : - **Conséquence** : - `data/metadata.md` contient des identifiants techniques de station (SIM CCID, adresses IP), d'où un dépôt qui doit rester privé ; - les stations archivées deviennent récupérables, ce qui lève la raison « irréversible » évoquée dans D-009. + +## D-015 — 2026-10-12 — Panneau d'analyse : deux courbes sur un seul axe en volts +- **Statut** : active. Précise D-011 pour le panneau du haut. +- **Décision** : le panneau d'analyse ne montre que la moyenne sur 7 jours et le seuil (référence − 0,2 V), en volts, sur un seul axe, avec le fond rouge des anomalies. L'écart et la référence restent au survol. +- **Pourquoi** : les 5 tracés précédents (écart, ligne à −0,2 V, moyenne, référence, seuil, sur deux axes) montraient deux fois le même test. L'utilisateur a demandé à simplifier. +- **Options écartées** : + - l'écart seul face à −0,2 V : le plus compact, mais on ne voit plus le niveau de tension ; + - moyenne, référence et seuil (3 courbes) : la référence n'est que le seuil décalé de 0,2 V. +- **Conséquence** : le seuil est une courbe, donc `AUTOSCALE_Y_JS` le garde visible sans cas particulier. + +## D-016 — 2026-10-12 — Page commune : un panneau par analyse, pour les comparer +- **Statut** : active. Précise D-011 et D-006. +- **Décision** : les analyses énergétiques partagent une page, `out/_energy.html`. Chacune y a son panneau en haut, dans l'ordre de leur numéro (02 sous 01), puis viennent les graphiques des séries temporelles. Chaque analyse garde son point d'entrée `src/analyse_NN.py` (D-006), qui lance cette page. +- **Pourquoi** : demande de l'utilisateur, pour comparer `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` à `MOVING_AVERAGE_7_DAYS_DROP` sur le même axe de temps. C'est aussi un premier pas vers la combinaison des analyses (D-005). +- **Options écartées** : une page par analyse, qui obligerait à comparer deux onglets sans zoom commun. +- **Conséquence** : `energy_plot.figure()` prend une liste de résultats. Le calcul commun des deux analyses est `energy_check._ma_drop()`. + +## D-017 — 2026-10-12 — Identifiants de règle en mots complets +- **Statut** : active. +- **Décision** : l'identifiant d'une règle (champ `analysis`, titre du panneau, conclusions) s'écrit en anglais, en majuscules, avec des mots complets et sans abréviation. Les deux premières analyses sont renommées : `MA7D_DROP` devient `MOVING_AVERAGE_7_DAYS_DROP`, et `MA7D_MIDNIGHT_DROP` devient `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`. +- **Pourquoi** : demande de l'utilisateur : avec des abréviations, on ne comprend pas ce que fait la règle. L'identifiant est cité dans chaque conclusion, il doit se lire sans la fiche. +- **Options écartées** : les sigles courts (`MA7D_DROP`), illisibles pour qui ne connaît pas le projet. +- **Conséquence** : les documents de travail de `docs/superpowers/` gardent les anciens noms (historique non maintenu). diff --git a/src/analyse_01.py b/src/analyse_01.py index 6a9026c..0286202 100644 --- a/src/analyse_01.py +++ b/src/analyse_01.py @@ -1,4 +1,5 @@ -"""Analyse 01 : MA7D_DROP (tendance de BusVoltage en moyenne glissante), graphiques HTML ouverts dans le navigateur. +"""Analyse 01 : MOVING_AVERAGE_7_DAYS_DROP (tendance de BusVoltage en moyenne glissante), graphiques HTML ouverts dans le navigateur. +La page montre aussi, juste dessous, l'analyse 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP), pour comparer les deux méthodes. Usage : python3 src/analyse_01.py [CSV ou dossiers...] (défaut : data/, sortie dans out/) Documentation : docs/analyses/analyse_01.md diff --git a/src/analyse_02.py b/src/analyse_02.py new file mode 100644 index 0000000..a8e445e --- /dev/null +++ b/src/analyse_02.py @@ -0,0 +1,10 @@ +"""Analyse 02 : MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP (MOVING_AVERAGE_7_DAYS_DROP sur la seule mesure de 00:00 UTC). + +Son graphique est le panneau placé sous MOVING_AVERAGE_7_DAYS_DROP, dans la page commune : ce script lance analyse_01.py. +Usage : python3 src/analyse_02.py [CSV ou dossiers...] (défaut : data/, sortie dans out/) +Documentation : docs/analyses/analyse_02.md +""" +import runpy +from pathlib import Path + +runpy.run_path(str(Path(__file__).with_name("analyse_01.py")), run_name="__main__") diff --git a/src/energy_check.py b/src/energy_check.py index f2650cc..12f56e5 100644 --- a/src/energy_check.py +++ b/src/energy_check.py @@ -1,6 +1,7 @@ -"""Analyse énergétique MA7D_DROP : tendance de BusVoltage en moyenne glissante. +"""Analyses énergétiques : tendance de BusVoltage en moyenne glissante. -Documentation : docs/analyses/analyse_01.md +- MOVING_AVERAGE_7_DAYS_DROP (docs/analyses/analyse_01.md) : sur toutes les heures ; +- MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP (docs/analyses/analyse_02.md) : le même calcul sur la seule mesure de 00:00 UTC. Bibliothèque standard uniquement (cible : système embarqué de la station). """ import argparse @@ -14,6 +15,7 @@ import sys from datetime import datetime, timedelta HOUR = timedelta(hours=1) +DAY = timedelta(days=1) # Constantes de calibration (fiche analyse_01, « Constantes et sources »). WINDOW_H = 168 # multiple de 24 h : annule le cycle jour/nuit ; 72 h ne lisse pas la météo @@ -23,7 +25,7 @@ MIN_REF_POINTS = 24 # au moins un jour de référence (choix de conception) THRESHOLD_V = -0.2 # cas de régression : pire écart sain -0,16 V (VERMONT 05-11) RULE = { - "id": "MA7D_DROP", + "id": "MOVING_AVERAGE_7_DAYS_DROP", "window_h": WINDOW_H, "ref_h": REF_H, "min_coverage": MIN_COVERAGE, @@ -33,6 +35,19 @@ RULE = { "doc": "docs/analyses/analyse_01.md", } +# Analyse 02 : les mêmes constantes, converties en jours (un point par jour, fiche analyse_02). +RULE_MIDNIGHT = { + "id": "MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP", + "sample": "BusVoltage à 00:00 UTC", + "window_d": WINDOW_H // 24, + "ref_d": REF_H // 24, + "min_coverage": MIN_COVERAGE, + "min_ref_points": MIN_REF_POINTS // 24, + "threshold_v": THRESHOLD_V, + "threshold_source": "repris de MOVING_AVERAGE_7_DAYS_DROP pour comparer les méthodes, non recalibré (fiche analyse_02)", + "doc": "docs/analyses/analyse_02.md", +} + NAME_RE = re.compile(r"^(?P[^_]+)_(?P.+?)_\d{4}_\d{2}_\d{2}_\d{2}_\d{2} to .+\.csv$") @@ -78,29 +93,39 @@ def load_stations(paths): def run(series): - """Analyse MA7D_DROP, causale : le point t n'utilise que les données <= t (fiche analyse_01, « Principe »).""" - v = series["BusVoltage"] + """Analyse MOVING_AVERAGE_7_DAYS_DROP, causale : le point t n'utilise que les données <= t (fiche analyse_01, « Principe »).""" + return _ma_drop(series["BusVoltage"], HOUR, WINDOW_H, REF_H, MIN_REF_POINTS, RULE) + + +def run_midnight(series): + """Analyse MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP : le même calcul sur la seule mesure de 00:00 UTC (fiche analyse_02).""" + v = {t: x for t, x in series["BusVoltage"].items() if t.hour == t.minute == 0} + return _ma_drop(v, DAY, WINDOW_H // 24, REF_H // 24, MIN_REF_POINTS // 24, RULE_MIDNIGHT) + + +def _ma_drop(v, step, window, ref_n, min_ref, rule): + """Moyenne sur `window` pas de `step`, comparée à son maximum des `ref_n` pas précédents (causal).""" if not v: - return {"analysis": RULE["id"], "rule": RULE, "points": []} + return {"analysis": rule["id"], "rule": rule, "points": []} t0 = min(v) - if any((t - t0) % HOUR for t in v): - raise ValueError("BusVoltage : horodatages hors de la grille horaire") - grid = [t0 + i * HOUR for i in range((max(v) - t0) // HOUR + 1)] + if any((t - t0) % step for t in v): + raise ValueError(f"BusVoltage : horodatages hors de la grille (pas de {step})") + grid = [t0 + i * step for i in range((max(v) - t0) // step + 1)] # NaN/inf (ex. export pandas) = pas de mesure : sinon un NaN pollue la somme courante. vals = [x if x is not None and math.isfinite(x) else None for x in (v.get(t) for t in grid)] - # Moyenne glissante sur WINDOW_H créneaux (somme courante), définie si couverture suffisante. + # Moyenne glissante sur `window` créneaux (somme courante), définie si couverture suffisante. ma, cov = [None] * len(grid), [0.0] * len(grid) total = count = 0 for i, x in enumerate(vals): if x is not None: total += x count += 1 - if i >= WINDOW_H and vals[i - WINDOW_H] is not None: - total -= vals[i - WINDOW_H] + if i >= window and vals[i - window] is not None: + total -= vals[i - window] count -= 1 - cov[i] = count / WINDOW_H - if count >= MIN_COVERAGE * WINDOW_H: + cov[i] = count / window + if count >= MIN_COVERAGE * window: ma[i] = total / count points = [] @@ -111,16 +136,16 @@ def run(series): value = anomaly = None if ma[i] is not None: facts["ma_v"] = round(ma[i], 3) - lo = max(0, i - REF_H) + lo = max(0, i - ref_n) ref_vals = [m for m in ma[lo:i] if m is not None] - if len(ref_vals) >= MIN_REF_POINTS: + if len(ref_vals) >= min_ref: ref = max(ref_vals) value = ma[i] - ref - anomaly = value < THRESHOLD_V + anomaly = value < rule["threshold_v"] facts["ref_v"] = round(ref, 3) facts["ref_t"] = grid[ma.index(ref, lo, i)] points.append({"t": t, "value": value, "anomaly": anomaly, "facts": facts}) - return {"analysis": RULE["id"], "rule": RULE, "points": points} + return {"analysis": rule["id"], "rule": rule, "points": points} def periods(points): @@ -203,7 +228,7 @@ def summary(station, result, per): def main(argv=None): - ap = argparse.ArgumentParser(description="Analyse énergétique MA7D_DROP") + ap = argparse.ArgumentParser(description="Analyse énergétique MOVING_AVERAGE_7_DAYS_DROP") ap.add_argument("paths", nargs="+", help="fichiers CSV et/ou dossiers") ap.add_argument("--out", default="out", help="dossier de sortie (défaut : out/)") a = ap.parse_args(argv) diff --git a/src/energy_plot.py b/src/energy_plot.py index 3ef78f1..6672a59 100644 --- a/src/energy_plot.py +++ b/src/energy_plot.py @@ -1,6 +1,6 @@ -"""Graphique HTML de l'analyse MA7D_DROP (poste de dev, plotly dans .venv). +"""Graphique HTML des analyses énergétiques, un panneau par analyse (poste de dev, plotly dans .venv). -Documentation : docs/analyses/analyse_01.md +Documentation : docs/analyses/analyse_01.md, docs/analyses/analyse_02.md """ import argparse import os @@ -11,7 +11,7 @@ import energy_check as ec # Plotly ne recale pas l'ordonnée sur la plage visible : après chaque zoom ou déplacement horizontal, # ce script recalcule l'axe vertical de chaque graphique sur les points visibles (5 % de marge), -# en gardant la ligne de seuil visible. Double-clic : retour à la vue complète. +# seuil compris (c'est une courbe). Double-clic : retour à la vue complète. AUTOSCALE_Y_JS = """ const gd = document.getElementById('{plot_id}'); const name = (t, a) => a + 'axis' + (t[a + 'axis'] || a).slice(1); @@ -24,7 +24,7 @@ gd.on('plotly_relayout', ev => { gd.data.forEach(t => { upd[name(t, 'y') + '.autorange'] = true; }); return Plotly.relayout(gd, upd); } - const box = {yaxis: [__SEUIL__, __SEUIL__]}; + const box = {}; gd.data.forEach((t, i) => { if (t.visible === 'legendonly' || t.visible === false) return; const xa = gd._fullLayout[name(t, 'x')]; @@ -43,7 +43,7 @@ gd.on('plotly_relayout', ev => { } Plotly.relayout(gd, upd); }); -""".replace("__SEUIL__", str(ec.THRESHOLD_V)) +""" def gaps(v): @@ -60,50 +60,49 @@ def gaps(v): return out -def figure(station, series, result, per): - """Haut : l'analyse, courbes superposées. Dessous : une série temporelle par graphique (échelles propres).""" +def figure(station, series, results): + """Haut : une analyse par graphique, courbes superposées. Dessous : une série temporelle par graphique.""" metrics = ["BusVoltage"] + sorted(m for m in series if m != "BusVoltage") - fig = make_subplots(rows=1 + len(metrics), cols=1, shared_xaxes=True, vertical_spacing=0.02, - row_heights=[1.5] + [1] * len(metrics), - specs=[[{"secondary_y": True}]] + [[{}]] * len(metrics), - subplot_titles=[f"Analyse {ec.RULE['id']}"] + metrics) + n = len(results) + fig = make_subplots(rows=n + len(metrics), cols=1, shared_xaxes=True, vertical_spacing=0.03, + row_heights=[1.5] * n + [1] * len(metrics), + subplot_titles=[f"Analyse {r['analysis']}" for r in results] + metrics) - analyse = dict(legendgroup="analyse", legendgrouptitle_text="Analyse") - pts = result["points"] - x = [p["t"] for p in pts] - ref = [p["facts"].get("ref_v") for p in pts] - hover = [f"anomalie={p['anomaly']}
" + "
".join(f"{k}={val}" for k, val in p["facts"].items()) - for p in pts] - fig.add_scatter(x=x, y=[p["value"] for p in pts], name="écart", text=hover, - hovertemplate="%{y:.3f} V
%{text}", line=dict(color="black"), row=1, col=1, **analyse) - fig.add_scatter(x=x, y=[p["facts"].get("ma_v") for p in pts], name="moyenne 7 j", - line=dict(color="royalblue"), row=1, col=1, secondary_y=True, **analyse) - fig.add_scatter(x=x, y=ref, name="référence (max 30 j)", line=dict(color="green", dash="dot"), - row=1, col=1, secondary_y=True, **analyse) - fig.add_scatter(x=x, y=[None if r is None else r + ec.THRESHOLD_V for r in ref], name="seuil", - line=dict(color="red", dash="dash"), row=1, col=1, secondary_y=True, **analyse) - fig.add_hline(y=ec.THRESHOLD_V, line=dict(color="black", dash="dash"), row=1, col=1) - for p in per: - fig.add_vrect(x0=p["start"], x1=p["end"] or x[-1], fillcolor="red", opacity=0.15, - line_width=0, row=1, col=1) - fig.update_yaxes(title_text="écart [V]", row=1, col=1, secondary_y=False) - fig.update_yaxes(title_text="BusVoltage moyennée [V]", row=1, col=1, secondary_y=True) + for row, result in enumerate(results, start=1): + analyse = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") + thr = result["rule"]["threshold_v"] + pts = result["points"] + x = [p["t"] for p in pts] + ref = [p["facts"].get("ref_v") for p in pts] + hover = [f"écart={p['value'] if p['value'] is None else round(p['value'], 3)}
anomalie={p['anomaly']}
" + + "
".join(f"{k}={val}" for k, val in p["facts"].items()) for p in pts] + fig.add_scatter(x=x, y=[p["facts"].get("ma_v") for p in pts], name="moyenne 7 j", text=hover, + hovertemplate="%{y:.3f} V
%{text}", line=dict(color="royalblue"), row=row, col=1, + **analyse) + fig.add_scatter(x=x, y=[None if r is None else r + thr for r in ref], name=f"seuil (max 30 j {thr:+} V)", + line=dict(color="red", dash="dash"), row=row, col=1, **analyse) + for p in ec.periods(pts): + fig.add_vrect(x0=p["start"], x1=p["end"] or x[-1], fillcolor="red", opacity=0.15, + line_width=0, row=row, col=1) + fig.update_yaxes(title_text="BusVoltage moyennée [V]", row=row, col=1) mesures = dict(legendgroup="mesures", legendgrouptitle_text="Mesures") - for row, m in enumerate(metrics, start=2): + for row, m in enumerate(metrics, start=n + 1): s = series[m] fig.add_scatter(x=sorted(s), y=[s[t] for t in sorted(s)], name=m, line=dict(width=1), row=row, col=1, **mesures) for a, b in gaps(series["BusVoltage"]): - fig.add_vrect(x0=a, x1=b, fillcolor="gray", opacity=0.3, line_width=0, row=2, col=1) + fig.add_vrect(x0=a, x1=b, fillcolor="gray", opacity=0.3, line_width=0, row=n + 1, col=1) + fig.update_xaxes(showticklabels=True) # dates sous chaque graphique, pas seulement le dernier fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS - fig.update_layout(title=f"{station} : analyse {ec.RULE['id']}", height=300 * (1 + len(metrics)), + fig.update_layout(title=f"{station} : analyses " + ", ".join(r["analysis"] for r in results), + height=300 * (n + len(metrics)), legend=dict(groupclick="toggleitem")) return fig def main(argv=None): - ap = argparse.ArgumentParser(description="Graphique HTML de l'analyse MA7D_DROP") + ap = argparse.ArgumentParser(description="Graphique HTML des analyses énergétiques") ap.add_argument("paths", nargs="+", help="fichiers CSV et/ou dossiers") ap.add_argument("--out", default="out", help="dossier de sortie (défaut : out/)") a = ap.parse_args(argv) @@ -113,9 +112,8 @@ def main(argv=None): if "BusVoltage" not in series: print(f"{station} : ignorée, pas de BusVoltage") continue - result = ec.run(series) path = os.path.join(a.out, f"{station}_energy.html") - figure(station, series, result, ec.periods(result["points"])).write_html( + figure(station, series, [ec.run(series), ec.run_midnight(series)]).write_html( path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True}) print(path) paths.append(path)