Document the project: decisions log, analysis sheet, domain notes
- CLAUDE.md becomes a short map: status and next step, analyses index, documentation map, working rules. - docs/decisions.md: ADR-style project decision log (D-001..D-014). - docs/analyses/: living sheet per analysis (analyse_01) and template. - docs/domaine/: domain knowledge, one note per question. - .claude/rules/analyses.md: path-scoped rule loaded on src/ and docs/analyses/; .claude/skills/nouvelle-analyse: new-analysis workflow. - README.md: human entry point. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
0b950199b8
commit
8992bda17e
12 files changed
+588
-49
No files matched your search
@@ -0,0 +1,104 @@
|
||||
# Analyse 01 — `MA7D_DROP` : tendance de la tension batterie
|
||||
|
||||
- **Statut** : prototype, en place (2026-10-09).
|
||||
- **Script** : `python3 src/analyse_01.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_energy.html` et l'ouvre dans le navigateur.
|
||||
- **Code** :
|
||||
- `src/energy_check.py` : chargement et calcul, bibliothèque standard uniquement ;
|
||||
- `src/energy_plot.py` : graphique plotly.
|
||||
|
||||
## Question posée
|
||||
|
||||
Le régime énergétique de la station se dégrade-t-il, et depuis quand ? Voir D-004 : anomalie = régime non soutenable.
|
||||
|
||||
## Principe
|
||||
|
||||
La moyenne de `BusVoltage` sur 7 jours est comparée à son propre maximum des 30 jours précédents. Si elle est descendue de plus de 0,2 V, le point est en anomalie. Comparer la station à son propre passé évite d'avoir un seuil de tension absolu, qui ne se transpose pas d'une station à l'autre (secteur ~14,25 V, solaire ~13,4 V).
|
||||
|
||||
Calcul exact, sur la grille horaire et pour chaque horodatage t :
|
||||
1. `ma(t)` = moyenne des valeurs non vides sur les 168 créneaux t−167 h … t. Elle n'est définie que si au moins 80 % des créneaux sont remplis.
|
||||
2. `ref(t)` = maximum de `ma` sur les 720 créneaux t−720 h … t−1 h. Elle n'est définie que si au moins 24 de ces `ma` existent.
|
||||
3. `value(t)` = `ma(t)` − `ref(t)`, en V.
|
||||
4. `anomaly(t)` = `value < −0,2` ; vaut `None` (UNKNOWN) si `ma` ou `ref` n'est pas défini.
|
||||
|
||||
Le calcul est **causal** : le point t n'utilise que les données ≤ t, donc il équivaut au temps réel embarqué. Une valeur vide, un créneau absent, `NaN` ou `inf` comptent comme « pas de mesure ». Un horodatage hors de la grille horaire lève une erreur.
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| `WINDOW_H` | 168 | Multiple de 24 h, pour annuler le cycle jour/nuit. Avec 72 h, la météo dominait : 2 jours nuageux faisaient baisser JUNGFRAU (sain) d'environ −100 mV/j, autant qu'un vrai déficit. |
|
||||
| `REF_H` | 720 | 30 jours, pour contenir le dernier régime sain avant un déficit. Choix de conception. |
|
||||
| `MIN_COVERAGE` | 0,8 | À 50 %, la fenêtre réellement remplie est trop courte en début d'historique : JUNGFRAU tombait à −0,19 V. À 80 %, il reste à −0,13 V. |
|
||||
| `MIN_REF_POINTS` | 24 | Au moins un jour de référence. Choix de conception. |
|
||||
| `THRESHOLD_V` | −0,2 | Calé sur 5 stations (voir « Calibration »). Pire cas sain : −0,16 V (VERMONT, mai, 3 jours nuageux). |
|
||||
|
||||
## Graphique
|
||||
|
||||
Disposition (D-011) :
|
||||
- **En haut, l'analyse**, courbes superposées :
|
||||
- l'écart, sur l'axe de gauche, avec une ligne à −0,2 V ;
|
||||
- la moyenne sur 7 jours, la référence et le seuil en volts, sur l'axe de droite ;
|
||||
- un fond rouge sur les périodes d'anomalie.
|
||||
- **Dessous, un graphique par série temporelle**, chacun avec sa propre échelle : `BusVoltage` d'abord (bandes grises sur ses trous), puis les autres champs par ordre alphabétique.
|
||||
- **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.
|
||||
- Le script utilise l'API interne de plotly.js (`_fullLayout`, `d2l`, `r2l`). La version de plotly.js chargée depuis le CDN est celle du paquet Python, donc figée, mais une mise à jour majeure de plotly pourrait casser ce script.
|
||||
- **Survol** : il affiche les faits du point (`ma_v`, `ref_v`, `ref_t`, couverture).
|
||||
|
||||
`python3 src/energy_check.py data/` produit en plus `out/<STATION>_energy.json` (tous les points avec leurs faits) et un résumé texte. Ce résumé donne les périodes d'anomalie, les heures sans verdict et la plus longue plage UNKNOWN.
|
||||
|
||||
## Résultats sur VERMONT (jeu de travail)
|
||||
|
||||
- Anomalie **à partir du 2026-09-24 07:00**, jusqu'à la fin de l'export. La première coupure nocturne est le 2026-09-27 01:00, donc ~2,8 jours d'avance.
|
||||
- Pire écart le 2026-10-09 01:00 : moyenne sur 7 jours 12,78 V, soit 0,55 V sous son maximum du 2026-09-09 06:00 (13,33 V).
|
||||
- 198 h sans verdict sur 4393, surtout la montée en charge des fenêtres au début de l'historique.
|
||||
- Le diagnostic expert situe le début du déficit vers le 20/09.
|
||||
|
||||
## Calibration (historique : stations désormais dans `data/archive/`)
|
||||
|
||||
| Station | Diagnostic expert | Résultat |
|
||||
|---|---|---|
|
||||
| FLORIDA | secteur, sain | aucune anomalie, pire écart −0,04 V |
|
||||
| JUNGFRAU | solaire, sain | aucune anomalie, pire écart −0,13 V |
|
||||
| WILDSTRUBEL | décharge profonde | anomalie dès le 2026-09-06 14:00, coupure le 2026-09-09 22:00 (~3,3 j d'avance) |
|
||||
| MISSISSIPPI | coupures secteur | anomalie dès le 2025-12-09 12:00, 1re coupure énergétique le 2025-12-25 14:00. Résumé : 5 mois sans verdict, du 2025-12-26 23:00 au 2026-06-07 16:00 |
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| Score d'anomalie continu entre 0 et 1 | C'est une pseudo-probabilité, interdite. On garde un écart en volts, qui est une grandeur physique. |
|
||||
| Échelle à 4 niveaux avec des règles séparées solaire/secteur | L'utilisateur préférait une seule analyse simple. La combinaison viendra de plusieurs analyses (D-005). |
|
||||
| Seuil absolu sur le minimum nocturne (ex. 13,0 V) | Il ne se transpose pas d'une station à l'autre : JUNGFRAU, station saine, a des nuits à 12,9 V. |
|
||||
| Seuil absolu au coude LiFePO4 (12,8 V) | Il se déclenche trop tard (0 à 1 jour avant la coupure) et décrit le niveau de charge, pas la soutenabilité (D-004). |
|
||||
| Fenêtre de 72 h | La météo domine : 2 jours nuageux font baisser une station saine autant qu'un vrai déficit. |
|
||||
| Couverture minimale de 50 % | En début d'historique, la fenêtre réellement remplie devient trop courte : JUNGFRAU tombait à −0,19 V. |
|
||||
| Taux de jours à charge complète comme règle principale | Plus précoce (~10 jours pour VERMONT), mais la moyenne glissante a été retenue comme première analyse simple. Il reste une piste. |
|
||||
| Autonomie sans apport, ou bilan net par cycle | La capacité de la batterie (7 ou 21 Ah) est inconnue, et le plateau LiFePO4 rend la charge illisible. Reporté. |
|
||||
| Traiter les `NaN` à la lecture du CSV (`load_csv`) | Ils sont traités dans `run()`, qui est le point de passage commun à toutes les sources de données futures. |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. **Marge mince** : le pire cas sain est à −0,16 V pour un seuil à −0,2 V. Depuis D-009, plus aucune station saine n'est dans le jeu de travail pour revérifier ce point.
|
||||
2. **Retard sur une perte secteur** : elle n'est détectée que 25 à 31 h après le début (MISSISSIPPI). Une station débranchée avec une petite batterie (7 Ah, ~15 h d'autonomie à 5 W) coupe avant l'alerte.
|
||||
3. **Biais pendant les coupures** : ce sont les valeurs les plus basses de la nuit qui manquent, donc `ma` est biaisé vers le haut. Sous 80 % de couverture, le point passe en UNKNOWN.
|
||||
4. **Accoutumance** : après ~30 jours de déficit continu, la référence s'aligne sur le déficit et l'anomalie peut disparaître alors que la station coupe encore chaque nuit. C'est une propriété de la règle relative. **Point ouvert**.
|
||||
5. **Retard en fin de période** : MISSISSIPPI retrouve le secteur le 2025-12-12 12:00 mais reste signalée jusqu'au 2025-12-18 06:00 (~6 jours).
|
||||
6. **Graphique dépendant d'internet** : la page charge plotly.js depuis le CDN et ne s'affiche pas hors ligne.
|
||||
|
||||
## Pistes (analyses suivantes, même contrat)
|
||||
|
||||
- **Classement des trous** : coupure d'alimentation, cause externe, début d'historique, retard de synchronisation. Il s'appuie sur la tension avant et après le trou, comparée au coude LiFePO4 (~12,8 V).
|
||||
- **Signature « station éteinte »** : chute de `sensor_thermal` pendant un trou (l'auto-échauffement de ~5 W s'arrête).
|
||||
- **Taux de jours à charge complète** (≥ 14,0 V) sur 7 jours : alerte plus précoce en solaire (~10 j pour VERMONT). Couvrirait la limite 4.
|
||||
- **Indicateur rapide de perte secteur** : sortie de la tension de maintien. Couvrirait la limite 2.
|
||||
- **Autonomie sans apport** : énergie restante ÷ `Power`. Demande la capacité de la batterie (7 ou 21 Ah ; les nuits de VERMONT sont cohérentes avec 21 Ah).
|
||||
|
||||
## Historique
|
||||
|
||||
- **2026-10-09** : conçue en brainstorming, avec une spec et un plan superpowers (`docs/superpowers/`, documents de travail non maintenus). Ensuite, dans la même journée :
|
||||
- durcissement des entrées (`NaN`, CSV illisibles) ;
|
||||
- ligne « sans verdict » dans le résumé ;
|
||||
- graphique réorganisé (D-007), puis remis en graphiques séparés sous l'analyse (D-011), avec une ordonnée recalée à chaque zoom ;
|
||||
- point d'entrée `analyse_01.py` ;
|
||||
- tests supprimés (D-008) ;
|
||||
- jeu réduit à VERMONT (D-009).
|
||||
Reference in new issue
Block a user