Add the day color matrix, the energy diagnostic manual and the site figure
D-020: the delivered energy diagnostic keeps analyses 03 and 04 only, combined by the state x trend matrix of cas-d-usage-03-04.drawio into one color per day (green / orange / red, grey when unknown), coded in src/day_color.py (standard library). docs/guide/diagnostic-energetique.md explains it: part 1 for the client, part 2 for support. D-021: energy_plot.daily_figure builds the figure for the monitoring site (panel 03 above panel 04, shared time axis), written by analyse_01.py as out/<STATION>_daily.html and .json. battery_state no longer imports energy_check, so analyses 03 and 04 ship on their own. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
129d4ff59b
commit
fc74fec10f
9 files changed
+467
-8
No files matched your search
@@ -172,3 +172,37 @@ Règles du journal :
|
||||
- décaler la fin de nuit d'un jour, pour qu'elle porte sur la même journée que l'état (la fin de nuit du matin de J porte le bilan de J−1). Essayé dans la 03, puis dans la 04 seule, et écarté par l'utilisateur les deux fois. Sur VERMONT, il ramenait les barres de la 04 contraires à l'état de 16 à 4 sur 28 changements d'état, au prix d'un jour de retard ;
|
||||
- garder `t` sur le jour J en prenant la fin de nuit de J+1 : non causal.
|
||||
- **Conséquence** : l'incohérence entre l'état et la barre reste une limite connue de l'analyse 04 (limite 6 de sa fiche).
|
||||
|
||||
## D-020 — 2026-10-12 — Diagnostic énergétique livré : couleur du jour (matrice 03 × 04) et manuel
|
||||
- **Statut** : active. Remplace, pour le diagnostic livré, la « phase B » de l'analyse 03 et la combinaison prévue par D-005.
|
||||
- **Décision** :
|
||||
- le diagnostic énergétique livré ne retient que les analyses 03 (`DAILY_BATTERY_STATE`) et 04 (`DAILY_BATTERY_TREND`) ;
|
||||
- elles se combinent par une matrice état × tendance en une **couleur par jour et par station** : vert (soutenable ce jour-là), orange (incertain, à surveiller), rouge (non soutenable). La matrice est tenue par l'utilisateur dans `cas-d-usage-03-04.drawio` ;
|
||||
- un manuel l'explique, en deux couches : une lecture rapide pour le client final, une annexe technique pour l'ingénieur support (`docs/guide/diagnostic-energetique.md`).
|
||||
- **Pourquoi** : demande de l'utilisateur. Il faut apprendre au lecteur à lire les signaux envoyés ; la couleur sert d'entrée en matière, les analyses de détail.
|
||||
- **Options écartées** :
|
||||
- `NO_CHARGE` × `STABLE` en orange : une coupure d'alimentation passerait du rouge (1er jour) à l'orange (jours suivants) alors qu'elle continue, contre D-004 ;
|
||||
- un manuel pour un seul public (client ou support).
|
||||
- **Conséquence** :
|
||||
- la matrice n'est pas encore codée : le manuel décrit la cible ;
|
||||
- les analyses 01 et 02 restent dans le code et sur la page HTML, mais ne font plus partie du diagnostic livré ;
|
||||
- les cas inconnus (état ou tendance) ne sont pas encore traités dans la matrice, laissés de côté par l'utilisateur ;
|
||||
- le destinataire du diagnostic n'est plus ouvert : le client et le support, en couches.
|
||||
|
||||
## D-021 — 2026-10-12 — Graphique des analyses 03 et 04 pour le site de monitoring
|
||||
- **Statut** : active. Complète D-020.
|
||||
- **Décision** :
|
||||
- le graphique destiné au site de monitoring (Plotly) est une seule figure : le panneau de l'analyse 03 en haut, celui de l'analyse 04 dessous, sur le même axe du temps. Ce sont les panneaux de la page des analyses (D-016), sans changement ;
|
||||
- `src/energy_plot.py` en écrit une page de démo (`out/<STATION>_daily.html`) et la figure en JSON (`out/<STATION>_daily.json`), que le site passe à `Plotly.newPlot` ;
|
||||
- la matrice de D-020 est codée dans `src/day_color.py` (bibliothèque standard, embarquable), mais n'est pas tracée. Quand l'état ou la tendance est inconnu, la couleur l'est aussi (gris).
|
||||
- **Pourquoi** : demande de l'utilisateur, qui veut intégrer le diagnostic au site (page « System Summary ») et trouve les deux panneaux plus clairs qu'une couleur par jour.
|
||||
- **Options écartées** :
|
||||
- une bande d'une case par jour (couleur de la matrice, flèche de tendance) au-dessus de `BusVoltage` horaire : essayée, jugée « pas claire » par l'utilisateur ;
|
||||
- superposer les deux panneaux en double axe (03 à gauche en V, 04 à droite en ΔV), dans un 3e panneau : essayé, mauvaise lisibilité selon l'utilisateur. Le zéro de l'axe de droite tombe vers 13,6 V, les tirets de la zone morte s'y lisent comme des seuils de tension, et les grandes barres cachent la fin de nuit. Deux superpositions sur un seul axe en V n'ont pas été essayées : la tendance en marqueurs ▲ ● ▼ sur la courbe de fin de nuit, ou chaque barre tracée de la fin de nuit de J−1 à celle de J ;
|
||||
- teinter le fond de la courbe `BusVoltage`, jour par jour : la teinte se lit moins bien que des cases, et elle gêne la lecture de la courbe ;
|
||||
- pour un jour inconnu, reprendre la couleur de la colonne de l'état quand elle est unique (`FULL_CHARGE` sans veille serait vert) : l'utilisateur préfère le gris, les cas inconnus restant à traiter (D-020).
|
||||
- **Conséquence** :
|
||||
- la couleur du jour est calculée mais n'apparaît sur aucun graphique ;
|
||||
- le calcul des analyses 03 et 04 (`battery_state.py`, `battery_trend.py`) n'importe plus rien des analyses 01 et 02 : il se livre seul ;
|
||||
- le format d'intégration côté site (JSON, fragment HTML ou backend Python) reste à choisir avec l'équipe du site.
|
||||
|
||||
Reference in new issue
Block a user