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
@@ -16,7 +16,9 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti
|
||||
- **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).
|
||||
- **2026-10-12** : analyse 03 `DAILY_BATTERY_STATE` en place (phase C, état seul).
|
||||
- **2026-10-12** : analyse 04 `DAILY_BATTERY_TREND` en place (tendance markovienne : chaque jour face à la veille, mieux / stable / pire).
|
||||
- **Prochaine étape** : phase B de l'analyse 03 (niveaux gradués à partir des séries d'états et des tendances de la 04, voir les pistes des fiches), puis la combinaison des analyses.
|
||||
- **2026-10-12, recentrage (D-020)** : le diagnostic énergétique livré ne retient que les analyses 03 et 04, combinées par la matrice état × tendance de `cas-d-usage-03-04.drawio` en une couleur par jour (vert / orange / rouge). Le manuel `docs/guide/diagnostic-energetique.md` (brouillon) l'explique au client et au support.
|
||||
- **2026-10-12 (D-021)** : graphique pour le site de monitoring (Plotly) : une seule figure, panneau 03 en haut et 04 dessous, écrite en page de démo et en JSON. La matrice est codée (`src/day_color.py`, jours inconnus en gris), mais pas tracée (la bande de couleurs a été écartée).
|
||||
- **Prochaine étape** : mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique.
|
||||
|
||||
## Analyses
|
||||
|
||||
@@ -31,7 +33,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
|
||||
## 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 à 04, 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 à 04, D-016) et `out/<STATION>_daily.html` + `.json` (analyses 03 et 04 pour le site, D-021), puis les 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/analyse_04.py` : point d'entrée de l'analyse 04 ; il lance la même page.
|
||||
@@ -49,6 +51,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
- `cas-annotes-par-l-expert.md` : diagnostics experts des 5 stations.
|
||||
- `colonnes-des-deplacements.md` : colonnes des déplacements (cas d'usage suivant).
|
||||
- `docs/guide/diagnostic-energetique.md` : manuel du diagnostic énergétique, pour le client (partie 1) et le support (partie 2). À tenir à jour avec la matrice et les fiches 03 et 04.
|
||||
- **Règle de travail** :
|
||||
- une décision projet prise en conversation donne une entrée dans `docs/decisions.md` ;
|
||||
- toute modification d'une analyse met à jour sa fiche dans le même changement ;
|
||||
@@ -67,7 +70,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
- `AIMsight FAQ.pdf` et `AIMsight Test Manual.pdf` (ce dernier est en réalité le manuel de la station) : définitions des signaux et des colonnes CSV, alimentation, schedules. Pour les lire : `pdftotext -layout "doc/<fichier>.pdf" -`.
|
||||
- `data/` : **jeu de travail = VERMONT seule**, le seul dataset complet (les 7 métriques système, telles qu'extraites de la plateforme) + diagnostics experts (`metadata.md`, `d.md`). Les analyses tournent uniquement sur ce jeu.
|
||||
- `data/archive/` : `BusVoltage` seule des autres stations (incomplètes), mises de côté le 2026-10-09. Non analysées ; ne pas les réintroduire sans demande.
|
||||
- `src/analyse_NN.py` : point d'entrée de chaque analyse. Code partagé : `src/energy_check.py` (analyses 01 et 02, bibliothèque standard uniquement, embarquable), `src/battery_state.py` (analyse 03, idem), `src/battery_trend.py` (analyse 04, idem) et `src/energy_plot.py` (plotly, poste de dev).
|
||||
- `src/analyse_NN.py` : point d'entrée de chaque analyse. Code partagé : `src/energy_check.py` (analyses 01 et 02, bibliothèque standard uniquement, embarquable), `src/battery_state.py` (analyse 03, idem), `src/battery_trend.py` (analyse 04, idem), `src/day_color.py` (matrice 03 × 04, couleur du jour, idem) et `src/energy_plot.py` (plotly, poste de dev).
|
||||
- `src/__main__ (3).py` : copie de référence du collecteur `system_info` embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω). Source des unités. Ne pas modifier.
|
||||
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
||||
|
||||
@@ -81,7 +84,8 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
- Contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Calcul causal (le point t n'utilise que les données ≤ t). `anomaly = None` signifie UNKNOWN (exception : analyses 03 en phase C et 04, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`).
|
||||
- Une analyse seule conclut au plus `consistent with`.
|
||||
- **Livrable** : un graphique HTML par station. En haut, les analyses, un panneau chacune (courbes superposées, D-016) ; dessous, un graphique par série temporelle. Zoom dans le temps seulement, avec l'ordonnée recalée sur la plage visible (D-011, D-013).
|
||||
- **Ouvert** : architecture (à définir plus tard, ne pas la figer ici), destinataire du diagnostic (client final ou ingénieur support).
|
||||
- **Destinataire du diagnostic** : le client final et l'ingénieur support, en couches (D-020).
|
||||
- **Ouvert** : architecture (à définir plus tard, ne pas la figer ici).
|
||||
|
||||
## L'essentiel du domaine (détail : `docs/domaine/`)
|
||||
|
||||
|
||||
Reference in new issue
Block a user