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,48 @@
|
||||
# Analyse NN — `NOM_DE_LA_REGLE` : titre court
|
||||
|
||||
- **Statut** : idée | en conception | prototype en place | abandonnée (date).
|
||||
- **Script** : `python3 src/analyse_NN.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_<nom>.html` et l'ouvre dans le navigateur.
|
||||
- **Code** : les modules utilisés ; le calcul est en bibliothèque standard uniquement.
|
||||
|
||||
## Question posée
|
||||
|
||||
La question que cette analyse pose aux données, en une phrase. Préciser le lien avec la définition de l'anomalie (D-004) et ce que l'analyse ajoute aux analyses existantes.
|
||||
|
||||
## Principe
|
||||
|
||||
L'idée en 2 ou 3 phrases, puis le calcul exact, étape par étape, pour chaque horodatage t. Le calcul doit être **causal** et respecter le contrat commun (`run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`). Préciser ce que contiennent `value` (unité physique) et `facts`, et quand le point vaut UNKNOWN.
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| `…` | … | doc AIMsight, manuel, code embarqué, donnée observée (avec date et station), ou choix de conception assumé |
|
||||
|
||||
## Graphique
|
||||
|
||||
- **En haut** : l'analyse, avec ses courbes superposées.
|
||||
- **Dessous** : un graphique par série temporelle.
|
||||
|
||||
Préciser ce qui est affiché en plus : seuils, bandes, contenu du survol.
|
||||
|
||||
## Résultats sur VERMONT (jeu de travail)
|
||||
|
||||
Dates et valeurs observées, comparées au diagnostic expert (`docs/domaine/cas-annotes-par-l-expert.md`).
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| … | … |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. …
|
||||
|
||||
## Pistes
|
||||
|
||||
Ce qu'une autre analyse pourrait couvrir de ces limites.
|
||||
|
||||
## Historique
|
||||
|
||||
- **AAAA-MM-JJ** : création. Puis une ligne par modification notable, avec renvoi aux décisions `D-0XX` concernées.
|
||||
@@ -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).
|
||||
@@ -0,0 +1,126 @@
|
||||
# Journal des décisions
|
||||
|
||||
Décisions de niveau **projet**, au format ADR allégé (inspiré de MADR). Ce qui est propre à une analyse va dans sa fiche (`docs/analyses/analyse_NN.md`).
|
||||
|
||||
Règles du journal :
|
||||
- On ajoute, on ne réécrit pas.
|
||||
- Une décision qui change garde son texte : son **statut** devient « remplacée par D-0XX », et la nouvelle entrée cite l'ancienne.
|
||||
- Champs : **Statut**, **Décision**, **Pourquoi**, **Options écartées** (avec leur raison, pour ne pas les reproposer), **Conséquence**. Les champs sans objet sont omis.
|
||||
- Statuts : `active` · `remplacée par D-0XX` · `remplacée en partie par D-0XX` · `abandonnée`.
|
||||
|
||||
---
|
||||
|
||||
## D-001 — 2026-10-09 — Point d'entrée : scan proactif d'un export
|
||||
- **Statut** : active.
|
||||
- **Décision** : l'agent parcourt un export, détecte les événements, les classe et explique chacun.
|
||||
- **Pourquoi** : expliquer l'anomalie avant que le client ne pose la question.
|
||||
- **Options écartées** : commencer par le mode « question de support » (« pourquoi D-300-A a sauté ? ») ; il viendra ensuite, sur le même socle.
|
||||
|
||||
## D-002 — 2026-10-09 — Premier cas d'usage : santé énergétique des stations
|
||||
- **Statut** : active.
|
||||
- **Décision** : commencer par la tension batterie et les interruptions de mesure, sur des stations solaires et sur secteur.
|
||||
- **Pourquoi** : cas simple et fréquent, avec des diagnostics experts disponibles. Ici, le trou de données *est* l'anomalie.
|
||||
- **Options écartées** : commencer par l'interprétation des déplacements ; elle viendra ensuite.
|
||||
|
||||
## D-003 — 2026-10-09 — 100 % analytique, embarquable, données réelles
|
||||
- **Statut** : active.
|
||||
- **Décision** : pas de LLM ; pas de données synthétiques ; code d'analyse en bibliothèque standard Python.
|
||||
- **Pourquoi** : la cible est le système embarqué de la station, souvent sur batterie et panneau solaire. Chaque conclusion doit être traçable jusqu'aux faits calculés.
|
||||
- **Options écartées** :
|
||||
- le LLM ou l'agent de synthèse prévu par les docs AIMsight ;
|
||||
- les CSV simulés et les générateurs de scénarios (refus explicite de l'utilisateur) ;
|
||||
- pandas et numpy dans le code d'analyse.
|
||||
|
||||
## D-004 — 2026-10-09 — Définition : anomalie énergétique = régime non soutenable
|
||||
- **Statut** : active.
|
||||
- **Décision** : une anomalie énergétique est un régime qui menace le fonctionnement : l'apport ne couvre pas la consommation sur un cycle.
|
||||
- **Pourquoi** : une station débranchée du secteur avec une batterie pleine est déjà en situation critique. Le niveau de charge dit **quand** la station tombera, pas **si** elle tombera.
|
||||
- **Options écartées** : définir l'anomalie par une batterie basse ou par une zone de charge (plateau, coude). Ce n'est qu'un indicateur d'urgence.
|
||||
- **Conséquence** : l'apport n'est pas mesuré (l'INA219 mesure la consommation). Il se déduit de la réaction de la batterie.
|
||||
|
||||
## D-005 — 2026-10-09 — Analyses multiples et imparfaites, combinées
|
||||
- **Statut** : active.
|
||||
- **Décision** : chaque analyse est une preuve parmi d'autres. Il suffit qu'elle ait raison dans la majorité des cas. C'est la combinaison d'analyses indépendantes qui fait le diagnostic. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
|
||||
- **Pourquoi** : ne pas surinvestir dans la précision d'une seule règle.
|
||||
- **Options écartées** :
|
||||
- une seule analyse « parfaite » qui couvrirait tous les cas ;
|
||||
- un score continu de 0 à 1, qui serait une pseudo-probabilité, interdite.
|
||||
- **Conséquence** : toutes les analyses suivent le contrat commun `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Le calcul est causal. Une analyse seule conclut au plus `consistent with`.
|
||||
|
||||
## D-006 — 2026-10-09 — Un script et une fiche par analyse
|
||||
- **Statut** : active.
|
||||
- **Décision** : l'analyse NN a un point d'entrée `src/analyse_NN.py` et une fiche `docs/analyses/analyse_NN.md`.
|
||||
- **Pourquoi** : suivre une à une les analyses à venir, qui seront nombreuses.
|
||||
- **Options écartées** : un `main.py` unique à la racine (essayé, puis renommé et déplacé).
|
||||
|
||||
## D-007 — 2026-10-09 — Livrable : graphiques HTML ouverts dans le navigateur
|
||||
- **Statut** : remplacée en partie par D-011 (disposition des graphiques). Le reste est actif.
|
||||
- **Décision** : le livrable d'une analyse est un graphique plotly, ouvert automatiquement dans le navigateur. Disposition initiale : en haut, tous les champs superposés, comme sur la plateforme de monitoring de l'entreprise ; dessous, l'analyse.
|
||||
- **Pourquoi** : c'est le graphique qui sert, pas le texte.
|
||||
- **Options écartées** : le résumé texte dans le terminal comme livrable principal, jugé peu utile. Il reste disponible via `energy_check.py`.
|
||||
- **Conséquence** : plotly n'est installé que dans `.venv/`, sur le poste de dev. Le script y bascule seul.
|
||||
|
||||
## D-008 — 2026-10-09 — Prototype expérimental : pas de tests automatisés
|
||||
- **Statut** : active, jusqu'à la fin de la phase prototype.
|
||||
- **Décision** : les tests unitaires et de régression sont supprimés. On n'en ajoute pas.
|
||||
- **Pourquoi** : ils ajoutent de la complexité pour un code très expérimental.
|
||||
- **Options écartées** : des tests de régression sur données réelles (32 tests, supprimés).
|
||||
- **Conséquence** : on vérifie à la main en lançant le script de l'analyse. Les tests restent récupérables dans l'historique git (commit `53b4f7e`).
|
||||
|
||||
## D-009 — 2026-10-09 — Jeu de travail : VERMONT seule
|
||||
- **Statut** : active.
|
||||
- **Décision** : les analyses ne tournent que sur VERMONT, le seul dataset complet (les 7 métriques système, comme sur la plateforme), placé dans `data/`. Les autres stations (`BusVoltage` seule) sont mises de côté dans `data/archive/`.
|
||||
- **Pourquoi** : disposer de tous les champs vaut mieux qu'avoir plus de stations incomplètes.
|
||||
- **Options écartées** : supprimer les autres stations (irréversible, car non versionnées) ; continuer à analyser les 5 stations.
|
||||
- **Conséquence** : il n'y a plus de station saine pour vérifier qu'une analyse ne donne pas de fausse alerte. Les seuils calés avant cette décision gardent leur source historique.
|
||||
|
||||
## D-010 — 2026-10-09 — Organisation de la documentation
|
||||
- **Statut** : active, complétée par D-012.
|
||||
- **Décision** : trois niveaux.
|
||||
- `CLAUDE.md` est chargé à chaque session et reste court.
|
||||
- `docs/decisions.md` (ce journal) porte les décisions de niveau projet.
|
||||
- `docs/analyses/analyse_NN.md` porte la fiche vivante de chaque analyse.
|
||||
- **Pourquoi** : rien ne doit se perdre entre deux conversations, sans alourdir le contexte chargé en permanence.
|
||||
- **Options écartées** :
|
||||
- mettre à jour après coup les specs et plans superpowers ;
|
||||
- garder le savoir projet dans la mémoire automatique de Claude, qui est locale et non partagée.
|
||||
- **Conséquence** : `docs/superpowers/` est un historique de travail, pas une référence. La spec d'une nouvelle analyse s'écrit directement dans sa fiche.
|
||||
|
||||
## D-011 — 2026-10-09 — Disposition des graphiques : l'analyse en haut, une série par graphique dessous
|
||||
- **Statut** : active. Remplace la disposition de D-007.
|
||||
- **Décision** : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique séparé par série temporelle, chacun avec sa propre échelle.
|
||||
- **Pourquoi** : superposer tous les champs sur un seul axe écrase l'échelle, parce que les amplitudes vont de ~13 V à ~5000 mW.
|
||||
- **Options écartées** : tous les champs sur un même axe, à la manière de la plateforme de monitoring (D-007), essayée puis abandonnée.
|
||||
|
||||
## D-012 — 2026-10-09 — Documentation : une carte et des documents chargés à la demande
|
||||
- **Statut** : active. Complète D-010.
|
||||
- **Décision** :
|
||||
- `CLAUDE.md` devient une **carte** de moins de 200 lignes : état et prochaine étape, index des analyses, liens, règles non négociables, essentiel du domaine.
|
||||
- Le savoir métier va dans `docs/domaine/`, une note par question.
|
||||
- Une règle `.claude/rules/analyses.md` se charge seule quand Claude touche `src/` ou `docs/analyses/`.
|
||||
- Ce journal prend le format ADR allégé (statut, options écartées).
|
||||
- Un modèle de fiche `docs/analyses/_modele.md` et un skill `nouvelle-analyse` donnent la même forme à chaque analyse.
|
||||
- **Pourquoi** :
|
||||
- la doc officielle de Claude Code recommande moins de 200 lignes par CLAUDE.md, car un fichier plus long coûte du contexte à chaque session et est moins bien suivi ;
|
||||
- les règles limitées à certains chemins et les skills ne se chargent qu'à la demande (divulgation progressive) ;
|
||||
- les options écartées évitent de reproposer ce qui a déjà été rejeté.
|
||||
- **Options écartées** : un CLAUDE.md exhaustif à la manière de DocLab (1194 lignes, ~93 Ko). Il donne une très bonne vue d'ensemble, mais chaque session paie ce contexte et l'adhérence baisse.
|
||||
|
||||
## D-013 — 2026-10-09 — Graphiques : zoom dans le temps, ordonnée recalée sur la plage visible
|
||||
- **Statut** : active.
|
||||
- **Décision** : dans tous les graphiques d'analyse :
|
||||
- le zoom est horizontal seulement (dans le temps, au rectangle ou à la molette) et commun à tous les graphiques ;
|
||||
- après chaque zoom, l'ordonnée de chaque graphique est recalée sur les points visibles. Le script est `energy_plot.AUTOSCALE_Y_JS`, avec les ordonnées en `fixedrange` ;
|
||||
- la ligne de seuil reste visible ;
|
||||
- un double-clic revient à la vue complète.
|
||||
- **Pourquoi** : les graphiques sont peu hauts. Avec l'échelle de l'ensemble des données, les points sortaient du cadre dès qu'on zoomait, et plotly ne recale pas l'ordonnée tout seul.
|
||||
- **Options écartées** : le zoom libre en rectangle sur les deux axes, parce que l'ordonnée fixée à la main serait écrasée par le recalage automatique.
|
||||
- **Conséquence** : le script utilise l'API interne de plotly.js (`_fullLayout`, `d2l`, `r2l`). Il est à revérifier si plotly change de version majeure.
|
||||
|
||||
## D-014 — 2026-10-09 — Tout le projet est versionné et poussé sur le dépôt de l'entreprise
|
||||
- **Statut** : active.
|
||||
- **Décision** : `doc/` (documentation AIMsight), `data/` (dont `data/archive/`), `architecture.drawio` et la copie du collecteur `src/__main__ (3).py` sont versionnés et poussés sur `origin` (gitea de l'entreprise). Seuls `out/`, `.venv/` et `__pycache__/` restent ignorés.
|
||||
- **Pourquoi** : demande explicite de l'utilisateur. Le projet doit être complet et récupérable depuis le dépôt.
|
||||
- **Conséquence** :
|
||||
- `data/metadata.md` contient des identifiants techniques de station (SIM CCID, adresses IP), d'où un dépôt qui doit rester privé ;
|
||||
- les stations archivées deviennent récupérables, ce qui lève la raison « irréversible » évoquée dans D-009.
|
||||
@@ -0,0 +1,13 @@
|
||||
# Cas annotés par l'expert
|
||||
|
||||
Les diagnostics experts, qui font office de vérité de référence, sont dans `data/metadata.md` et `data/d.md`. Seule VERMONT est dans le jeu de travail (`data/`). Les autres stations, avec `BusVoltage` seule, sont dans `data/archive/` (D-009).
|
||||
|
||||
| Station | Alimentation | Diagnostic expert | Signature observée |
|
||||
|---|---|---|---|
|
||||
| VERMONT | solaire | interruptions nocturnes (déficit) | Le maximum quotidien plafonne vers 13,2–13,5 V dès le 20/09 (charges complètes déjà rares depuis fin août). Coupures nocturnes dès le 27/09, vers ~12,2 V. Les redémarrages ont lieu le matin, entre 12,35 et 12,62 V. |
|
||||
| JUNGFRAU | solaire | sain | Aucun trou, maximum quotidien ~14,1–14,2 V. Les jours nuageux, pas de montée diurne. |
|
||||
| WILDSTRUBEL | solaire | décharge profonde sous 12 V (UVLO désactivé ?), coupure d'environ 12 jours, puis interruptions nocturnes | Maximum quotidien en baisse dès le 04/09, 11,53 V le 09/09, puis 298 h sans mesure. |
|
||||
| FLORIDA | secteur | sain, sans interruption | 14,2–14,4 V sans cycle jour/nuit. Une baisse ponctuelle à 13,0 V le 10/07 (2 h). Quelques trous courts à tension normale, qui ne sont pas des coupures d'alimentation. |
|
||||
| MISSISSIPPI | secteur | coupures secteur : la batterie sert d'UPS, puis le système se déconnecte | Chute de 14,2 à ~13,1 V, lente baisse, coude vers 12,5 V, puis décrochage. Nombreuses coupures de décembre 2025 à juin 2026, avec des lectures jusqu'à 10,3 V. Presque aucune mesure de janvier à mai. |
|
||||
|
||||
Remède indiqué par l'expert pour VERMONT et WILDSTRUBEL : réactiver le mode veille profonde entre les mesures.
|
||||
@@ -0,0 +1,45 @@
|
||||
# Ce que mesure la station (et ce qu'elle ne mesure pas)
|
||||
|
||||
## Format des exports CSV
|
||||
|
||||
- Un CSV par station et par métrique : `<STATION>_<Metric>_<début> to <fin>.csv`.
|
||||
- Colonnes `,time_utc,metric` : un index sans nom, l'horodatage UTC (pas d'une heure), la valeur.
|
||||
- Une valeur `metric` vide signifie qu'il n'y a pas de mesure.
|
||||
- Les valeurs exportées sont des **moyennes horaires**.
|
||||
- Les CSV simulent la future base de données. Les schémas CSV historiques varient d'un export à l'autre. Parquet et HDF5 viendront ensuite.
|
||||
|
||||
## Métriques système et unités
|
||||
|
||||
La source est le collecteur embarqué `src/__main__ (3).py` : bibliothèque INA219, shunt de 0,1 Ω.
|
||||
|
||||
| Métrique | Unité | Sens |
|
||||
|---|---|---|
|
||||
| `BusVoltage` | V | tension du bus, proche de la tension batterie |
|
||||
| `BusCurrent` | mA | courant consommé par la station |
|
||||
| `Power` | mW | puissance consommée |
|
||||
| `ShuntVoltage` | mV | tension aux bornes du shunt (= courant × 0,1 Ω) |
|
||||
| `sensor_*_deg_c` | °C | températures internes (CPU, PLL, thermal, …) |
|
||||
|
||||
- **`Power`, `BusCurrent` et `ShuntVoltage` sont une seule et même mesure.** On le vérifie avec P/(V·I) ≈ 0,99 et Shunt/0,1 Ω ≈ I.
|
||||
- Ces trois métriques mesurent la **consommation** de la station. Le courant ne devient jamais négatif. Il baisse à midi quand la tension monte, comme une charge à puissance constante.
|
||||
- **L'apport (panneau ou secteur) n'est pas mesuré.** On ne le voit qu'à travers la réaction de la batterie.
|
||||
- Le courant augmente quand la tension baisse, alors que la puissance reste constante. Pour la consommation, raisonner en `Power`, pas en `BusCurrent`.
|
||||
- La température suit l'ensoleillement : son amplitude dans la journée est faible les jours nuageux. Elle chute aussi quand la station est éteinte, puisque l'auto-échauffement de ~5 W s'arrête.
|
||||
|
||||
## Calculs déjà présents dans le collecteur embarqué
|
||||
|
||||
Ces valeurs ne sont pas exportées dans les CSV actuels :
|
||||
- `BusVoltageOCV` : tension compensée de la chute dans la résistance interne, avec R = 0,34 Ω (mesure faite sur une station déployée) ;
|
||||
- `BusVoltageTrend` : pente en mV/min sur une fenêtre de 60 s ;
|
||||
- `BatteryState` et `BatteryPercent` : état de charge estimé par la table OCV LiFePO4 (voir `comment-se-comporte-la-batterie.md`).
|
||||
|
||||
## Instantanés d'état système
|
||||
|
||||
`data/metadata.md` contient des instantanés de l'état de WILDSTRUBEL et de VERMONT, avec des unités notées `[unknown]`. On y trouve par exemple `mode SLP` pour VERMONT, cohérent avec la réactivation du mode veille.
|
||||
|
||||
## Consommation observée sur VERMONT
|
||||
|
||||
- La consommation est d'environ 5,0 W constants d'avril à octobre (~120 Wh/j). Le déficit de fin septembre vient donc d'un apport en baisse, pas d'une consommation en hausse.
|
||||
- Exceptions :
|
||||
- ~3,3 W du 14/09 0 h au 15/09 13 h (essai du mode veille, probablement) ;
|
||||
- 2,2 à 3,2 W le 09/10 à partir de 13 h (cohérent avec `mode SLP`).
|
||||
@@ -0,0 +1,19 @@
|
||||
# Colonnes des déplacements (cas d'usage suivant)
|
||||
|
||||
Les colonnes CSV des déplacements sont préfixées par la cible (ex. `target_06_rch`) :
|
||||
- `rch` / `rcv` : déplacement corrigé du mouvement de la caméra [mm]. C'est le signal principal.
|
||||
- `x` / `y` : position brute dans l'image [px].
|
||||
- `rx` / `ry` : déplacement relatif avant correction caméra. **Ce n'est pas** `x - x0`.
|
||||
- `error` : erreur de reconnaissance de la cible, **pas** une incertitude. Seuil par défaut : 0,7.
|
||||
- `camera_pan|tilt|rotation` [deg], `camera_scale`, `camera_sigma0` (résidu du fit du réseau de références).
|
||||
- `inlier_{ch}`, `reproj_err_{ch}` : contribution et résidu de chaque référence.
|
||||
- Sharpness, FWHM, Dominance, Peak Intensity, Flux, SNR : **uniquement dans l'export HDF5**.
|
||||
|
||||
Causes à départager pour une anomalie de déplacement :
|
||||
- mouvement réel de l'ouvrage ;
|
||||
- mouvement de la caméra ;
|
||||
- instabilité de la compensation (cas Barcelone) ;
|
||||
- dégradation locale d'une cible ;
|
||||
- parallaxe ou modèle inadapté.
|
||||
|
||||
La référence qui fait autorité est `doc/AIMsight_reference_quality_event_explainer_roadmap (2).md`. Les règles non négociables qui s'y rapportent (`inlier` binaire, `sigma0`, mode commun) sont dans `CLAUDE.md`.
|
||||
@@ -0,0 +1,32 @@
|
||||
# Comment se comporte la batterie (alimentation de la station)
|
||||
|
||||
## Matériel (metadata et manuel de la station)
|
||||
|
||||
- Batterie LiFePO4 de 12,8 V nominal, environ 7 ou 21 Ah selon la station.
|
||||
- Panneau solaire 12 V, ~100 W conseillé. Tension d'entrée maximale : 26 V.
|
||||
- **Sur secteur**, la batterie reste connectée et sert d'UPS.
|
||||
- **Après une décharge profonde** (< 12 V), la station reste éteinte jusqu'à ce que la batterie remonte à ~12,6 V, puis redémarre. L'UVLO doit couper avant la décharge profonde.
|
||||
- Mesure quasi statique, typiquement toutes les 15 min.
|
||||
- Remède attendu en cas de déficit : réactiver le mode veille profonde (sleep) entre les mesures. Le « Continuous mode » (LED allumées) augmente la consommation.
|
||||
|
||||
## Tension et état de charge (table OCV du collecteur)
|
||||
|
||||
| Tension à vide | Charge | 0,1 V correspond à | Zone |
|
||||
|---|---|---|---|
|
||||
| ≥ 13,6 V | 100 % | — | pleine ; au-dessus, c'est le chargeur qui tient la tension |
|
||||
| 12,9 – 13,4 V | 40 – 90 % | ~10 % de charge | **plateau** : la tension dit peu de choses sur la charge |
|
||||
| 12,5 – 12,8 V | 20 – 30 % | ~3 % de charge | **coude** |
|
||||
| < 12,5 V | < 20 % | ~2 % de charge | zone raide ; sous 12 V, décharge profonde |
|
||||
|
||||
Vérification sur les données : VERMONT consomme 5 W constants, donc la vitesse de baisse de sa tension la nuit dessine la courbe. Elle vaut 7 mV/h à 13,2 V, 13 à 13,0 V, 48 à 12,8 V, et 126 à 192 mV/h entre 12,3 et 12,5 V. On retrouve les deux cassures, vers 12,8 V et vers 12,5 V. MISSISSIPPI a la même forme.
|
||||
|
||||
## Ce qu'il faut en retenir pour les analyses
|
||||
|
||||
- **La tension instantanée ne dit pas l'état de charge.**
|
||||
- Le jour, le chargeur la tire vers le haut : 14,2 V correspond à la fin de charge (absorption).
|
||||
- Sous la consommation de la station, la tension mesurée est un peu plus basse que la tension à vide (~0,4 A × 0,34 Ω ≈ 0,14 V).
|
||||
- Le meilleur indicateur avec `BusVoltage` seule est le minimum de fin de nuit.
|
||||
- **Plateau LiFePO4** : entre 30 et 90 % de charge, la tension de nuit reste plate. Elle ne chute qu'au coude, donc trop tard pour alerter.
|
||||
- **Charge complète** : une tension ≥ ~14,0 V dans la journée signale que la batterie a été remplie. Les jours nuageux, elle plafonne vers 13,4 V.
|
||||
- **Capacité** : une nuit de VERMONT consomme ~70 Wh. Avec 7 Ah (~90 Wh), il resterait ~22 % de charge au matin, soit ~12,6 V. On observe 13,15 V, ce qui est cohérent avec 21 Ah.
|
||||
- **Une batterie pleine ne garantit rien** : une station débranchée du secteur tient environ 15 h (7 Ah) à 46 h (21 Ah) à 5 W. Voir D-004.
|
||||
@@ -0,0 +1,17 @@
|
||||
# Pièges des données
|
||||
|
||||
- **Un trou n'est pas forcément une coupure.** Acquisition, transmission, ingestion et affichage sont des couches distinctes.
|
||||
- **En fin de fichier**, des valeurs vides peuvent n'être qu'un retard de synchronisation (`last_sync`) : WILDSTRUBEL, et MISSISSIPPI le 09/10.
|
||||
- **En début de fichier**, des valeurs vides précèdent la première mesure : ce n'est pas une coupure (VERMONT `Power` et températures, du 22/02 au 08/04).
|
||||
- **Des trous simultanés sur plusieurs stations** pointent plutôt vers une cause commune hors station :
|
||||
- le 22/07 à 14:00 : FLORIDA, MISSISSIPPI et VERMONT ;
|
||||
- le 19/08 à 15:00 : les mêmes trois stations ;
|
||||
- le 22/08 à 17:00 : FLORIDA et MISSISSIPPI.
|
||||
- **Un trou entouré d'une tension normale** n'est pas un problème d'énergie.
|
||||
- **Une coupure d'alimentation laisse une signature** :
|
||||
- la tension est sous le coude (~12,8 V) juste avant ou juste après le trou ;
|
||||
- la température chute pendant le trou, plus qu'aux mêmes heures les nuits sans trou. Sur VERMONT, l'écart va de 2,6 à 15 °C sur 12 trous.
|
||||
- **Les seuils de tension absolus ne se transposent pas d'une station à l'autre.** En bonne santé, les nuits de JUNGFRAU sont à 12,9 V et celles de VERMONT à 13,15 V. Le niveau moyen vaut ~14,25 V sur secteur et ~13,4 V en solaire. Préférer une comparaison de la station à son propre passé.
|
||||
- **Cycle jour/nuit** : une fenêtre glissante doit couvrir un nombre entier de jours. Sur 72 h, la météo domine : 2 jours nuageux font baisser JUNGFRAU (sain) autant qu'un vrai déficit.
|
||||
- **Une valeur `NaN` ou `inf`** dans un export (pandas, par exemple) doit être traitée comme une absence de mesure.
|
||||
- **Pendant une coupure, ce sont justement les valeurs les plus basses qui manquent** : toute moyenne est alors biaisée vers le haut.
|
||||
Reference in new issue
Block a user