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 <noreply@anthropic.com>
This commit is contained in:
1 parent
a3590fab62
commit
eacc0ecd4a
6 files changed
+23
-9
No files matched your search
@@ -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/<STATION>_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/<STATION>_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/<STATION>_energy.json` (`out/` est ignoré par git).
|
||||
- `.venv/bin/python src/energy_plot.py data/` : graphique seul (plotly.js est chargé depuis le CDN).
|
||||
|
||||
|
||||
@@ -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 »).
|
||||
@@ -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.
|
||||
|
||||
@@ -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/<STATION>_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.
|
||||
+1
-1
@@ -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
|
||||
|
||||
@@ -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__")
|
||||
Reference in new issue
Block a user