Files
Support-Agent/docs/analyses/analyse_02.md
T
maximeandClaude Opus 5.5 5e039ef3bb Fix DAILY_BATTERY_STATE night end and rise, document phase C contract
The night end and rise were anchored on the first daily maximum,
which can be the 00:00 tail of the previous evening: 2026-05-05 was
read NO_CHARGE despite a +0.079 V rise, 2026-09-30 showed a wrong
night end, and 2026-09-26 stayed unknown from 04:00 to 11:00 when
evaluated mid-day. The rise now starts from an earlier minimum and
the knee is tested on the daily minimum (min_v). VERMONT: 139 / 31 /
14 / 0.

Docs: sheet 02 page order, battery_state.py in the CLAUDE.md map,
phase C exception to "anomaly = None means UNKNOWN".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 11:03:23 +02:00

7.5 KiB
Raw Blame History

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 le panneau de l'analyse 03 (DAILY_BATTERY_STATE), 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).