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 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 09:31:52 +02:00
1 parent 8992bda17e
commit 7b1da6d7cf
11 files changed
+214 -70

No files matched your search

+10 -7
View File
@@ -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/<STATION>_energy.html` et l'ouvre dans le navigateur.
- **Script** : `python3 src/analyse_01.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_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/<STATION>_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).
+80
View File
@@ -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/<STATION>_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).
+23
View File
@@ -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/<STATION>_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).