Files
Support-Agent/docs/energy/analyses/moving_average_7_days_drop.md
T
maximeandClaude Opus 5.5 c3e9eef4e4 Move the VERMONT CSVs into data/VERMONT
New data will be added per station without mixing with the working set.
All scripts now default to data/VERMONT/; docs and D-029 follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:10:35 +02:00

10 KiB
Raw Blame History

MOVING_AVERAGE_7_DAYS_DROP : tendance de la tension batterie

  • Statut : prototype, en place (2026-10-09).
  • Script : python3 src/energy/all_analyses.py [CSV ou dossiers] (défaut : data/VERMONT/). Il écrit out/<STATION>_energy.html et l'ouvre dans le navigateur. Cette analyse est le premier panneau, et MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP est juste dessous (D-016). Elle sert à la comparaison seulement : elle n'est pas livrée (D-020).
  • Code :
    • src/energy/moving_average.py : calcul, bibliothèque standard uniquement. run() appelle _ma_drop(), commun avec MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP. Les séries sont chargées par common.stations.load_stations ;
    • src/energy/all_analyses.py : graphique plotly.

Question posée

Le régime énergétique de la station se dégrade-t-il, et depuis quand ? Voir D-004 : anomalie = régime non soutenable.

Principe

La moyenne de BusVoltage sur 7 jours est comparée à son propre maximum des 30 jours précédents. Si elle est descendue de plus de 0,2 V, le point est en anomalie. Comparer la station à son propre passé évite d'avoir un seuil de tension absolu, qui ne se transpose pas d'une station à l'autre (secteur ~14,25 V, solaire ~13,4 V).

Calcul exact, sur la grille horaire et pour chaque horodatage t :

  1. ma(t) = moyenne des valeurs non vides sur les 168 créneaux t−167 h … t. Elle n'est définie que si au moins 80 % des créneaux sont remplis.
  2. ref(t) = maximum de ma sur les 720 créneaux t−720 h … t−1 h. Elle n'est définie que si au moins 24 de ces ma existent.
  3. value(t) = ma(t) − ref(t), en V.
  4. anomaly(t) = value < −0,2 ; vaut None (UNKNOWN) si ma ou ref n'est pas défini.

Le calcul est causal : le point t n'utilise que les données ≤ t, donc il équivaut au temps réel embarqué. Une valeur vide, un créneau absent, NaN ou inf comptent comme « pas de mesure ». Un horodatage hors de la grille horaire lève une erreur.

Constantes et sources

Constante Valeur Source
WINDOW_H 168 Multiple de 24 h, pour annuler le cycle jour/nuit. Avec 72 h, la météo dominait : 2 jours nuageux faisaient baisser JUNGFRAU (sain) d'environ −100 mV/j, autant qu'un vrai déficit.
REF_H 720 30 jours, pour contenir le dernier régime sain avant un déficit. Choix de conception.
MIN_COVERAGE 0,8 À 50 %, la fenêtre réellement remplie est trop courte en début d'historique : JUNGFRAU tombait à −0,19 V. À 80 %, il reste à −0,13 V.
MIN_REF_POINTS 24 Au moins un jour de référence. Choix de conception.
THRESHOLD_V −0,2 Calé sur 5 stations (voir « Calibration »). Pire cas sain : −0,16 V (VERMONT, mai, 3 jours nuageux).

Graphique

Disposition (D-011) :

  • 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 MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP, mêmes conventions, pour comparer les deux méthodes (D-016).
  • Puis le panneau DAILY_BATTERY_STATE : état de la batterie jour par jour (fiche daily_battery_state.md).
  • Puis le panneau DAILY_BATTERY_TREND : tendance de la batterie d'un jour à l'autre (fiche daily_battery_trend.md).
  • Dessous, un graphique par série temporelle, chacun avec sa propre échelle : BusVoltage d'abord (bandes grises sur ses trous, et en fond les 3 zones d'état de la batterie : décharge 12,0–13,2 V, en charge 13,1–13,8 V, pleine charge 14,0–14,4 V, d'après docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md ; ZONES dans src/energy/all_analyses.py), 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 src/common/page.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 (sur la moyenne) : il affiche l'écart, le verdict et les faits du point (ma_v, ref_v, ref_t, couverture).

Le résumé texte et out/<STATION>_energy.json ont été supprimés (D-026) ; les périodes d'anomalie restent visibles, en rouge, sur la page.

Résultats sur VERMONT (jeu de travail)

  • Anomalie à partir du 2026-09-24 07:00, jusqu'à la fin de l'export. La première coupure nocturne est le 2026-09-27 01:00, donc ~2,8 jours d'avance.
  • Pire écart le 2026-10-09 01:00 : moyenne sur 7 jours 12,78 V, soit 0,55 V sous son maximum du 2026-09-09 06:00 (13,33 V).
  • 198 h sans verdict sur 4393, surtout la montée en charge des fenêtres au début de l'historique.
  • Le diagnostic expert situe le début du déficit vers le 20/09.

Calibration (historique : stations désormais dans data/archive/)

Station Diagnostic expert Résultat
FLORIDA secteur, sain aucune anomalie, pire écart −0,04 V
JUNGFRAU solaire, sain aucune anomalie, pire écart −0,13 V
WILDSTRUBEL décharge profonde anomalie dès le 2026-09-06 14:00, coupure le 2026-09-09 22:00 (~3,3 j d'avance)
MISSISSIPPI coupures secteur anomalie dès le 2025-12-09 12:00, 1re coupure énergétique le 2025-12-25 14:00. Résumé : 5 mois sans verdict, du 2025-12-26 23:00 au 2026-06-07 16:00

Options écartées

Option Pourquoi écartée
Score d'anomalie continu entre 0 et 1 C'est une pseudo-probabilité, interdite. On garde un écart en volts, qui est une grandeur physique.
Échelle à 4 niveaux avec des règles séparées solaire/secteur L'utilisateur préférait une seule analyse simple. La combinaison viendra de plusieurs analyses (D-005).
Seuil absolu sur le minimum nocturne (ex. 13,0 V) Il ne se transpose pas d'une station à l'autre : JUNGFRAU, station saine, a des nuits à 12,9 V.
Seuil absolu au coude LiFePO4 (12,8 V) Il se déclenche trop tard (0 à 1 jour avant la coupure) et décrit le niveau de charge, pas la soutenabilité (D-004).
Fenêtre de 72 h La météo domine : 2 jours nuageux font baisser une station saine autant qu'un vrai déficit.
Couverture minimale de 50 % En début d'historique, la fenêtre réellement remplie devient trop courte : JUNGFRAU tombait à −0,19 V.
Taux de jours à charge complète comme règle principale Plus précoce (~10 jours pour VERMONT), mais la moyenne glissante a été retenue comme première analyse simple. Il reste une piste.
Autonomie sans apport, ou bilan net par cycle La capacité de la batterie (7 ou 21 Ah) est inconnue, et le plateau LiFePO4 rend la charge illisible. Reporté.
Traiter les NaN à la lecture du CSV (load_csv) Ils sont traités dans run(), qui est le point de passage commun à toutes les sources de données futures.

Limites connues

  1. Marge mince : le pire cas sain est à −0,16 V pour un seuil à −0,2 V. Depuis D-009, plus aucune station saine n'est dans le jeu de travail pour revérifier ce point.
  2. Retard sur une perte secteur : elle n'est détectée que 25 à 31 h après le début (MISSISSIPPI). Une station débranchée avec une petite batterie (7 Ah, ~15 h d'autonomie à 5 W) coupe avant l'alerte.
  3. Biais pendant les coupures : ce sont les valeurs les plus basses de la nuit qui manquent, donc ma est biaisé vers le haut. Sous 80 % de couverture, le point passe en UNKNOWN.
  4. Accoutumance : après ~30 jours de déficit continu, la référence s'aligne sur le déficit et l'anomalie peut disparaître alors que la station coupe encore chaque nuit. C'est une propriété de la règle relative. Point ouvert.
  5. Retard en fin de période : MISSISSIPPI retrouve le secteur le 2025-12-12 12:00 mais reste signalée jusqu'au 2025-12-18 06:00 (~6 jours).
  6. Graphique dépendant d'internet : la page charge plotly.js depuis le CDN et ne s'affiche pas hors ligne.

Pistes (analyses suivantes, même contrat)

  • 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.
  • 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

  • 2026-10-09 : conçue en brainstorming, avec une spec et un plan superpowers (docs/superpowers/, documents de travail non maintenus). Ensuite, dans la même journée :
    • durcissement des entrées (NaN, CSV illisibles) ;
    • ligne « sans verdict » dans le résumé ;
    • graphique réorganisé (D-007), puis remis en graphiques séparés sous l'analyse (D-011), avec une ordonnée recalée à chaque zoom ;
    • 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). Zones d'état de la batterie ajoutées en fond du graphique BusVoltage (affichage seulement, aucun effet sur le calcul).
  • 2026-10-12 : fiche renommée d'après la règle (ex-analyse_01.md) et déplacée dans docs/energy/analyses/ ; code dans src/energy/ (D-026). Calcul inchangé.