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
@@ -14,7 +14,7 @@ paths:
|
||||
- **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 : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`) ;
|
||||
- `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`.
|
||||
- **Code de calcul** : bibliothèque standard uniquement, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`).
|
||||
- **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source.
|
||||
|
||||
@@ -15,7 +15,8 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti
|
||||
- **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).
|
||||
- **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.
|
||||
- **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.
|
||||
|
||||
## Analyses
|
||||
|
||||
@@ -24,14 +25,16 @@ 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 ? | prototype en place | `docs/analyses/analyse_03.md` |
|
||||
| 04 | `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | prototype en place | `docs/analyses/analyse_04.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, 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_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_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.
|
||||
- `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).
|
||||
|
||||
@@ -64,7 +67,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) 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) 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.
|
||||
|
||||
@@ -75,7 +78,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
- **Pas de LLM, pas de données synthétiques** (ni CSV simulés, ni générateur de scénarios : refus explicite de l'utilisateur). Le code d'analyse est **embarquable** : bibliothèque standard, calcul léger.
|
||||
- **Anomalie énergétique = régime non soutenable** (l'apport ne couvre pas la consommation), pas une batterie basse. Une station débranchée avec une batterie pleine est déjà en anomalie.
|
||||
- **Analyses combinées** : chaque analyse est une preuve imparfaite, juste « dans la majorité des cas » ; la combinaison fait le diagnostic. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
|
||||
- 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 : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`).
|
||||
- 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).
|
||||
|
||||
@@ -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. 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 »).
|
||||
Prototype expérimental, sans tests automatisés. Quatre 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 ; `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les suivantes sont listées dans les fiches `docs/analyses/` (section « Pistes »).
|
||||
@@ -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).
|
||||
+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, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP) et 03 (DAILY_BATTERY_STATE).
|
||||
La page montre aussi, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP), 03 (DAILY_BATTERY_STATE) et 04 (DAILY_BATTERY_TREND).
|
||||
|
||||
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 04 : DAILY_BATTERY_TREND (tendance de la batterie d'un jour à l'autre, J face à J−1).
|
||||
|
||||
Son graphique est le quatrième panneau d'analyse de la page commune : ce script lance analyse_01.py.
|
||||
Usage : python3 src/analyse_04.py [CSV ou dossiers...] (défaut : data/, sortie dans out/)
|
||||
Documentation : docs/analyses/analyse_04.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