- **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).
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). |
- **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.
- **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.
`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.
## 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/`)
| 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 ;
- **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).