From eacc0ecd4a52517826b7b590c0abeb48ee880817 Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 12 Oct 2026 10:53:15 +0200 Subject: [PATCH] Add analysis 03 entry point and documentation src/analyse_03.py launches the common page; sheet 03 moves to "prototype en place" with VERMONT results; CLAUDE.md, README and sheet 01 list the third panel. Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 8 +++++--- README.md | 2 +- docs/analyses/analyse_01.md | 1 + docs/analyses/analyse_03.md | 9 +++++---- src/analyse_01.py | 2 +- src/analyse_03.py | 10 ++++++++++ 6 files changed, 23 insertions(+), 9 deletions(-) create mode 100644 src/analyse_03.py diff --git a/CLAUDE.md b/CLAUDE.md index bd7f004..6148954 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -14,7 +14,8 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti - **Point ouvert de l'analyse 01** : l'accoutumance. Après plus de 30 jours de déficit, l'anomalie peut disparaître (voir sa fiche). - **2026-10-12** : analyse 02 (`MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, suggestion d'un collègue) en place, en panneau sous la 01 pour comparer. Elle est bien moins bruitée (pire cas sain −0,04 V contre −0,16 V), mais plus tardive sur VERMONT : 1 h avant la première coupure, contre ~2,7 jours pour la 01. - **2026-10-12, changement d'échelle (D-018)** : les analyses suivantes donnent l'état de la batterie jour par jour, avec des seuils physiques du matériel, pour être utilisables dès l'installation. Phase C (état seul), puis phase B (niveaux gradués). -- **Prochaine étape** : implémenter l'analyse 03 `DAILY_BATTERY_STATE` (phase C), conçue et spécifiée dans sa fiche ; puis la phase B. +- **2026-10-12** : analyse 03 `DAILY_BATTERY_STATE` en place (phase C, état seul). +- **Prochaine étape** : phase B de l'analyse 03 (niveaux gradués à partir des séries d'états, voir les pistes de sa fiche), puis la combinaison des analyses. ## Analyses @@ -22,14 +23,15 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti |---|---|---|---|---| | 01 | `MOVING_AVERAGE_7_DAYS_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | prototype en place | `docs/analyses/analyse_01.md` | | 02 | `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC de chaque jour | prototype en place | `docs/analyses/analyse_02.md` | -| 03 | `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | en conception | `docs/analyses/analyse_03.md` | +| 03 | `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | prototype en place | `docs/analyses/analyse_03.md` | Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-analyse/`). ## Commandes -- `python3 src/analyse_01.py` : point d'entrée de l'analyse 01. Il analyse `data/`, écrit `out/_energy.html` (panneaux des analyses 01 et 02, D-016) et l'ouvre dans le navigateur (via `explorer.exe` sous WSL). Il bascule seul sur `.venv` si plotly manque. +- `python3 src/analyse_01.py` : point d'entrée de l'analyse 01. Il analyse `data/`, écrit `out/_energy.html` (panneaux des analyses 01, 02 et 03, D-016) et l'ouvre dans le navigateur (via `explorer.exe` sous WSL). Il bascule seul sur `.venv` si plotly manque. - `python3 src/analyse_02.py` : point d'entrée de l'analyse 02 ; il lance la même page. +- `python3 src/analyse_03.py` : point d'entrée de l'analyse 03 ; il lance la même page. - `python3 src/energy_check.py data/` : résumé texte + `out/_energy.json` (`out/` est ignoré par git). - `.venv/bin/python src/energy_plot.py data/` : graphique seul (plotly.js est chargé depuis le CDN). diff --git a/README.md b/README.md index b52e4f5..61e206f 100644 --- a/README.md +++ b/README.md @@ -30,4 +30,4 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c ## État -Prototype expérimental, sans tests automatisés. Deux analyses sont en place : `MOVING_AVERAGE_7_DAYS_DROP`, la tendance de la tension batterie sur 7 jours, et `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, la même sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/analyses/` (section « Pistes »). +Prototype expérimental, sans tests automatisés. Trois analyses sont en place : `MOVING_AVERAGE_7_DAYS_DROP`, la tendance de la tension batterie sur 7 jours ; `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, la même sur la seule mesure de 00:00 UTC ; `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour. Les suivantes sont listées dans les fiches `docs/analyses/` (section « Pistes »). diff --git a/docs/analyses/analyse_01.md b/docs/analyses/analyse_01.md index 8d62dd7..c79574f 100644 --- a/docs/analyses/analyse_01.md +++ b/docs/analyses/analyse_01.md @@ -40,6 +40,7 @@ Disposition (D-011) : - 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). +- **Puis le panneau de l'analyse 03** (`DAILY_BATTERY_STATE`) : état de la batterie jour par jour (fiche `analyse_03.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/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. diff --git a/docs/analyses/analyse_03.md b/docs/analyses/analyse_03.md index bfd03ac..87b176b 100644 --- a/docs/analyses/analyse_03.md +++ b/docs/analyses/analyse_03.md @@ -1,9 +1,9 @@ # Analyse 03 — `DAILY_BATTERY_STATE` : état de la batterie jour par jour -- **Statut** : en conception (2026-10-12). Phase C : l'état seul, sans verdict. La phase B (niveaux gradués) viendra ensuite (D-018). +- **Statut** : prototype en place (2026-10-12). Phase C : l'état seul, sans verdict. La phase B (niveaux gradués) viendra ensuite (D-018). - **Script** : `python3 src/analyse_03.py [CSV ou dossiers]` (défaut : `data/`). Il lance la page commune de `analyse_01.py` : `out/_energy.html`, où cette analyse est le troisième panneau d'analyse (D-016). - **Code** : - - `src/battery_state.py` : calcul, bibliothèque standard uniquement. Il réutilise `energy_check.load_stations` ; + - `src/battery_state.py` : calcul, bibliothèque standard uniquement (`run()`, `day_facts()`). Il reçoit les séries chargées par `energy_check.load_stations` ; - `src/energy_plot.py` : graphique plotly. ## Question posée @@ -66,9 +66,9 @@ Sortie (contrat commun) : un point par jour. - l'état du jour, en marqueurs colorés sur la courbe du maximum, une couleur et une entrée de légende par état. - **Survol** : l'état et les faits du jour. -## Résultats attendus sur VERMONT (essai de conception, à confirmer à l'implémentation) +## Résultats sur VERMONT (jeu de travail) -- **Répartition sur 184 jours** : 139 `FULL_CHARGE`, 30 `PARTIAL_CHARGE`, 14 `BELOW_PLATEAU`, 1 `NO_CHARGE` (le 2026-05-05, au milieu de 3 jours nuageux), 0 UNKNOWN. +- **Répartition sur 184 jours** (identique à l'essai de conception) : 139 `FULL_CHARGE`, 30 `PARTIAL_CHARGE`, 14 `BELOW_PLATEAU`, 1 `NO_CHARGE` (le 2026-05-05, au milieu de 3 jours nuageux), 0 UNKNOWN. - **`PARTIAL_CHARGE`** : - jours isolés en août (03/08, 15/08, 18/08) ; - puis du 29/08 au 01/09 ; @@ -110,3 +110,4 @@ Sortie (contrat commun) : un point par jour. ## Historique - **2026-10-12** : conçue en brainstorming. L'utilisateur a choisi l'approche 1 (seuils physiques, jour UTC) et la phase C (état seul) avant la phase B. Elle ouvre le changement d'échelle de D-018. Spec écrite dans cette fiche (D-010). +- **2026-10-12** : implémentée (`src/battery_state.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_03.py`). Résultats conformes à l'essai de conception. diff --git a/src/analyse_01.py b/src/analyse_01.py index 0286202..60d2303 100644 --- a/src/analyse_01.py +++ b/src/analyse_01.py @@ -1,5 +1,5 @@ """Analyse 01 : MOVING_AVERAGE_7_DAYS_DROP (tendance de BusVoltage en moyenne glissante), graphiques HTML ouverts dans le navigateur. -La page montre aussi, juste dessous, l'analyse 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP), pour comparer les deux méthodes. +La page montre aussi, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP) et 03 (DAILY_BATTERY_STATE). Usage : python3 src/analyse_01.py [CSV ou dossiers...] (défaut : data/, sortie dans out/) Documentation : docs/analyses/analyse_01.md diff --git a/src/analyse_03.py b/src/analyse_03.py new file mode 100644 index 0000000..34fa082 --- /dev/null +++ b/src/analyse_03.py @@ -0,0 +1,10 @@ +"""Analyse 03 : DAILY_BATTERY_STATE (état de la batterie jour par jour, phase C). + +Son graphique est le troisième panneau d'analyse de la page commune : ce script lance analyse_01.py. +Usage : python3 src/analyse_03.py [CSV ou dossiers...] (défaut : data/, sortie dans out/) +Documentation : docs/analyses/analyse_03.md +""" +import runpy +from pathlib import Path + +runpy.run_path(str(Path(__file__).with_name("analyse_01.py")), run_name="__main__")