# 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/_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. `run()` appelle `_ma_drop()`, commun avec l'analyse 02 ; - `src/energy_plot.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 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, 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/domaine/tensions-selon-l-etat-de-la-batterie.md` ; `ZONES` dans `energy_plot.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 `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** (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/_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/`) | 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).