Files
Support-Agent/docs/analyses/analyse_02.md
T
maximeandClaude Opus 5.5 7b1da6d7cf 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>
2026-10-12 09:31:52 +02:00

81 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).