Add analysis 04 entry point and documentation
src/analyse_04.py launches the common page; sheet 04 moves to "prototype en place" with VERMONT results; CLAUDE.md, the analyses rule, README and sheet 01 list the fourth panel and extend the "no verdict" contract exception to analysis 04. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e058a2e3e7
commit
3082f75429
7 files changed
+31
-12
No files matched your search
@@ -41,6 +41,7 @@ Disposition (D-011) :
|
||||
- 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`).
|
||||
- **Puis le panneau de l'analyse 04** (`DAILY_BATTERY_TREND`) : tendance de la batterie d'un jour à l'autre (fiche `analyse_04.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,6 +1,6 @@
|
||||
# Analyse 04 — `DAILY_BATTERY_TREND` : tendance de la batterie d'un jour à l'autre
|
||||
|
||||
- **Statut** : en conception (2026-10-12).
|
||||
- **Statut** : prototype en place (2026-10-12). Pas de verdict : `anomaly = None`, la tendance est dans `facts.trend`.
|
||||
- **Script** : `python3 src/analyse_04.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 quatrième panneau d'analyse (D-016).
|
||||
- **Code** :
|
||||
- `src/battery_trend.py` : calcul, bibliothèque standard uniquement (`run()`). Il s'appuie sur `battery_state.run()` (analyse 03) ;
|
||||
@@ -47,17 +47,20 @@ Sortie (contrat commun) : un point par jour.
|
||||
|
||||
- **Place** : quatrième panneau d'analyse de la page commune, sous `DAILY_BATTERY_STATE` (D-016). Les états du jour se lisent dans le panneau 03, juste au-dessus, sur le même axe du temps.
|
||||
- **Contenu** :
|
||||
- une barre par jour : `delta_night_end_v`, en V, colorée selon la tendance (vert : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre) ;
|
||||
- une barre par jour : `delta_night_end_v`, en V, colorée selon la tendance (bleu : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre). Ce sont la paire divergente et le gris neutre du skill dataviz. ;
|
||||
- la zone morte de ±0,05 V en tirets. Elle est tracée comme une courbe avec un point par jour, pour que le recalage au zoom (D-013) la garde visible.
|
||||
- Quand l'état décide, la couleur suit la tendance, même si la barre est petite ou de l'autre signe.
|
||||
- **Survol** : la tendance, ce qui l'a décidée, l'état de J−1 puis celui de J, et les trois écarts.
|
||||
|
||||
## Résultats sur VERMONT (jeu de travail)
|
||||
|
||||
Essai de conception (à confirmer à l'implémentation), sur 183 paires de jours :
|
||||
- **Répartition** : 137 `STABLE`, 26 `WORSE`, 20 `BETTER`, 0 UNKNOWN.
|
||||
- **Jours sains** : 120 paires `FULL_CHARGE` sur 125 sont `STABLE`.
|
||||
Sur 184 jours (du 2026-04-09 au 2026-10-09) :
|
||||
- **Répartition** : 137 `STABLE`, 26 `WORSE`, 20 `BETTER`, 1 UNKNOWN (le 2026-04-09, premier jour de l'export, sans veille).
|
||||
- **Jours sains** : sur 125 paires `FULL_CHARGE` enchaînées, 120 sont `STABLE`, 4 `BETTER` et 1 `WORSE`.
|
||||
- **`WORSE` isolés en août** (08-03, 08-15, 08-18) : des jours nuageux, chacun suivi d'un `BETTER`.
|
||||
- **Fin août à septembre** : des `WORSE` répétés (08-29, 08-30, 09-06, 09-08, 09-10, 09-12, 09-16, 09-20, 09-21, puis 09-25 à 09-27, passage sous le plateau). Chacun est suivi d'un `BETTER` le jour d'une pleine charge. C'est cohérent avec l'expert : charges complètes de plus en plus rares, puis déficit vers le 20/09.
|
||||
- **L'état décide contre la fin de nuit** : le 2026-08-29 (`FULL_CHARGE` → `PARTIAL_CHARGE`) est `WORSE`, alors que la fin de nuit monte de +0,041 V.
|
||||
- **Sous le plateau** (du 26/09 au 09/10) : des `BETTER` les 01/10, 03/10 et 08/10, faux (limite 1).
|
||||
|
||||
## Options écartées
|
||||
|
||||
@@ -68,6 +71,7 @@ Essai de conception (à confirmer à l'implémentation), sur 183 paires de jours
|
||||
| État seul | Ne voit ni la dérive sur le plateau (`PARTIAL_CHARGE` enchaînés, −0,1 V par jour fin septembre), ni l'aggravation sous le plateau. |
|
||||
| Bande de marqueurs mieux / stable / pire | Lisible d'un coup d'œil, mais cache l'ampleur de l'écart. L'utilisateur a choisi les barres. |
|
||||
| Mémoire au-delà de la veille (série de tendances, moyenne) | Hors du modèle markovien demandé. Relève de la phase B ou de la combinaison des analyses. |
|
||||
| Vert pour « mieux » (design validé en brainstorming) | Refusé par le validateur du skill dataviz : vert `#008300` et rouge `#d03b3b` ne se distinguent pas en deutéranopie (ΔE 5,9, sous le plancher de 6). Remplacé par le bleu de la paire divergente. |
|
||||
|
||||
## Limites connues
|
||||
|
||||
@@ -85,3 +89,4 @@ Essai de conception (à confirmer à l'implémentation), sur 183 paires de jours
|
||||
## Historique
|
||||
|
||||
- **2026-10-12** : conçue en brainstorming. L'utilisateur a choisi trois réponses plus l'inconnu, l'état d'abord puis la fin de nuit, et un panneau en barres. Spec écrite dans cette fiche (D-010).
|
||||
- **2026-10-12** : implémentée (`src/battery_trend.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_04.py`). Résultats conformes à l'essai de conception, à un UNKNOWN près (le premier jour, sans veille). Couleur de « mieux » : bleu au lieu de vert (skill dataviz).
|
||||
Reference in new issue
Block a user