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:
maximeandClaude Opus 5.5 committed 2026-10-09 23:29:42 +02:00
1 parent 0b950199b8
commit 8992bda17e
12 files changed
+588 -49

No files matched your search

+29
View File
@@ -0,0 +1,29 @@
---
paths:
- "src/**"
- "docs/analyses/**"
---
# Travailler sur une analyse
- **Avant de modifier** une analyse, lire sa fiche `docs/analyses/analyse_NN.md`. En particulier :
- le principe ;
- les constantes et leurs sources ;
- les limites connues ;
- les **options écartées** (ne pas les reproposer sans raison nouvelle).
- **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 ;
- 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.
- **Graphique** :
- en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011) ;
- zoom horizontal seulement, avec l'ordonnée recalée sur la plage visible (`post_script=energy_plot.AUTOSCALE_Y_JS`, ordonnées en `fixedrange`, D-013).
- **Après modification** :
- mettre à jour la fiche dans le même changement (résultats, limites, historique) ;
- si c'est une décision projet, ajouter une entrée dans `docs/decisions.md` ;
- si c'est un savoir métier nouveau, l'ajouter dans `docs/domaine/`.
- **Vérifier à la main** avec `python3 src/analyse_NN.py` sur VERMONT (`data/`). Pas de tests automatisés en phase prototype (D-008).
- **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.
+54
View File
@@ -0,0 +1,54 @@
---
name: nouvelle-analyse
description: Créer une nouvelle analyse numérotée (analyse_NN) dans le projet de diagnostic AIMsight — script, fiche, index, journal. À utiliser dès que l'utilisateur veut ajouter, concevoir ou prototyper une nouvelle analyse des séries temporelles d'une station.
---
# Créer une nouvelle analyse
## 1. Situer l'analyse
- Prendre le numéro suivant `NN` : voir le tableau « Analyses » de `CLAUDE.md` et `docs/analyses/`.
- Lire, sans tout charger :
- les « Pistes » et les « Limites connues » des fiches existantes. La nouvelle analyse en couvre souvent une ;
- `docs/decisions.md`, en particulier les options écartées ;
- la note de `docs/domaine/` qui concerne la question posée.
- Si la conception demande des choix, en discuter avec l'utilisateur. Avec superpowers (brainstorming), **la spec s'écrit directement dans la fiche** `docs/analyses/analyse_NN.md`, pas dans `docs/superpowers/specs/` (D-010).
## 2. Écrire la fiche
- Copier `docs/analyses/_modele.md` vers `docs/analyses/analyse_NN.md` et remplir :
- la question posée ;
- le principe et le calcul exact ;
- les constantes **avec leur source** ;
- les options écartées.
- Statut : « en conception ».
## 3. Écrire le code
- Le calcul respecte le contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`.
- Il est causal.
- Il utilise uniquement la bibliothèque standard.
- `value` est exprimé dans une unité physique, sans pseudo-probabilité.
- Une analyse seule conclut au plus `consistent with`.
- Réutiliser `src/energy_check.py` (`load_stations`, grille horaire, traitement des `NaN`) plutôt que de le recopier. Extraire du code partagé seulement quand une deuxième analyse en a vraiment besoin.
- Point d'entrée `src/analyse_NN.py`, sur le modèle de `src/analyse_01.py` :
- il s'exécute sur `data/` par défaut ;
- il bascule sur `.venv` si plotly manque ;
- il écrit le graphique dans `out/` et l'ouvre dans le navigateur.
- Graphique (D-011) : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle. Écrire le HTML avec `post_script=energy_plot.AUTOSCALE_Y_JS` et des ordonnées en `fixedrange`, pour que l'ordonnée se recale à chaque zoom.
- Pas de tests automatisés en phase prototype (D-008).
## 4. Vérifier
- Lancer `python3 src/analyse_NN.py` sur VERMONT.
- Comparer les résultats au diagnostic expert (`docs/domaine/cas-annotes-par-l-expert.md`).
- Reporter les dates et valeurs observées dans la section « Résultats » de la fiche.
## 5. Documenter
- Fiche : statut « prototype en place », résultats, limites, historique.
- `CLAUDE.md` :
- ajouter une ligne au tableau « Analyses » et la commande dans « Commandes » ;
- mettre à jour « État et prochaine étape ».
- `docs/decisions.md` : une entrée **seulement** si une décision de niveau projet a été prise (nouveau principe, changement de cap). Les choix propres à l'analyse restent dans sa fiche.
- Un savoir métier découvert en chemin va dans `docs/domaine/`.
+68 -49
View File
@@ -2,69 +2,86 @@
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Ce fichier est une **carte**, chargée à chaque session : il doit rester court (< 200 lignes). Le détail est dans `docs/` et se lit quand on en a besoin.
## Projet ## Projet
Agent de diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et le mouvement de la caméra est compensé grâce à des cibles de référence. L'agent analyse les séries temporelles avec des **méthodes analytiques (pas de LLM)**, détecte les anomalies et explique chacune d'elles (preuves calculées + ce qui reste non établi) **avant** que le client ne pose la question. Cible d'exécution idéale : **le système embarqué de la station**. Agent de diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et le mouvement de la caméra est compensé grâce à des cibles de référence. L'agent analyse les séries temporelles avec des **méthodes analytiques (pas de LLM)**, détecte les anomalies et explique chacune d'elles (preuves calculées + ce qui reste non établi) **avant** que le client ne pose la question. Cible d'exécution idéale : **le système embarqué de la station**. Langage : **Python**.
État : phase de conception. Pas de code. Langage : **Python**. Relancer `/init` quand du code existe. ## État et prochaine étape
- **2026-10-09** : l'analyse 01 est en place sur VERMONT et produit un graphique HTML. C'est un prototype expérimental, sans tests automatisés.
- **Point ouvert de l'analyse 01** : l'accoutumance. Après plus de 30 jours de déficit, l'anomalie peut disparaître (voir sa fiche).
- **Prochaine étape** : choisir l'analyse 02 parmi les pistes de la fiche 01 (classement des trous, taux de jours à charge complète, perte secteur rapide, autonomie), puis combiner les analyses.
## Analyses
| N° | Nom | Question | Statut | Fiche |
|---|---|---|---|---|
| 01 | `MA7D_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` |
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` et l'ouvre dans le navigateur (via `explorer.exe` sous WSL). Il bascule seul sur `.venv` si plotly manque.
- `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).
## Documentation (à lire à la demande)
- `docs/decisions.md` : journal des décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). Le lire avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
- `docs/analyses/analyse_NN.md` : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, historique). Modèle : `docs/analyses/_modele.md`.
- `docs/domaine/` : le savoir métier, une note par question.
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
- `comment-se-comporte-la-batterie.md` : LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité.
- `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).
- **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 ;
- un savoir métier nouveau va dans `docs/domaine/` ;
- un changement de cap met à jour « État et prochaine étape » ci-dessus.
- `.claude/rules/analyses.md` se charge seul quand Claude touche `src/` ou `docs/analyses/`.
- `docs/superpowers/` : documents de travail superpowers (specs, plans). C'est un historique, non maintenu après coup, et ce n'est pas une référence. La spec d'une nouvelle analyse s'écrit directement dans sa fiche `docs/analyses/analyse_NN.md` ; le plan peut rester dans `docs/superpowers/plans/`.
## Fichiers ## Fichiers
- `README.md` : point d'entrée pour un humain (lancer l'analyse, où trouver quoi). Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
- `doc/` : documentation AIMsight, à lire avant de concevoir. Ne pas re-demander à l'utilisateur ce qui y figure. - `doc/` : documentation AIMsight, à lire avant de concevoir. Ne pas re-demander à l'utilisateur ce qui y figure.
- `AIMsight_reference_quality_event_explainer_roadmap (2).md` : **référence qui fait autorité**. Elle couvre la couche diagnostique commune, l'explainer d'événements, les classifications (§4.3) et l'API indépendante de l'estimateur (§10). Le doc de contexte la cite sans le suffixe « (2) ». - `AIMsight_reference_quality_event_explainer_roadmap (2).md` : **référence qui fait autorité**. Elle couvre la couche diagnostique commune, l'explainer d'événements, les classifications (§4.3) et l'API indépendante de l'estimateur (§10). Le doc de contexte la cite sans le suffixe « (2) ».
- `AIMsight_agentic_support_project_context.md` : extension support. Contenu : chaîne de dépendance (§4), domaines dont la santé système (§5.1), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23). - `AIMsight_agentic_support_project_context.md` : extension support. Contenu : chaîne de dépendance (§4), domaines dont la santé système (§5.1), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23).
- Les deux docs prévoient un LLM/agent pour la synthèse : **ne pas suivre ce point**, le projet est 100 % analytique. - Les deux docs prévoient un LLM/agent pour la synthèse : **ne pas suivre ce point**, le projet est 100 % analytique.
- `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" -`. - `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/` : séries réelles et diagnostics experts (voir plus bas). - `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` (bibliothèque standard uniquement, embarquable) 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. - `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
## Décisions prises (2026-10-09) ## Principes (raisons, statuts et options écartées : `docs/decisions.md`)
- **Point d'entrée du POC : scan proactif d'un export.** L'agent détecte les événements, les classe et explique chacun. Le mode « question de support » (« pourquoi D-300-A a sauté ? ») viendra ensuite, sur le même socle. - **Point d'entrée du POC : scan proactif d'un export.** L'agent détecte les événements, les classe et explique chacun. Le mode « question de support » viendra ensuite, sur le même socle.
- **Premier cas d'usage : santé énergétique des stations** (tension batterie, interruptions de mesure ; stations solaires et sur secteur). Ici, le trou de données *est* l'anomalie. L'interprétation des déplacements viendra ensuite. - **Premier cas d'usage : santé énergétique des stations.** Ici, le trou de données *est* l'anomalie. L'interprétation des déplacements viendra ensuite.
- **Données** : des CSV simulent la future base de données ; Parquet/HDF5 viendront ensuite. Les schémas CSV historiques varient. - **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.
- **Pas de données synthétiques** : ne pas générer de CSV simulés ni de générateur de scénarios (refus explicite de l'utilisateur). - **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.
- **Pas de LLM** : détection, classement et explication par méthodes analytiques et règles. L'explication est générée à partir des faits calculés. - **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).
- **Embarqué** : le code doit pouvoir tourner sur la station, qui fonctionne souvent sur batterie et panneau solaire. Il faut donc un calcul léger et des dépendances minimales. - 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.
- **Ouvert** : architecture (à définir plus tard, ne pas la figer ici), destinataire du diagnostic (client final ou ingénieur support), unités des métriques système. - Une analyse seule conclut au plus `consistent with`.
- **Livrable** : un graphique HTML par station. En haut, l'analyse (courbes superposées) ; 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).
## Données (`data/`) ## L'essentiel du domaine (détail : `docs/domaine/`)
- Un CSV par station et par métrique : `<STATION>_<Metric>_<début> to <fin>.csv`. Colonnes `,time_utc,metric` (index sans nom, horodatage UTC, pas d'une heure). Une valeur `metric` vide = pas de mesure. - **Données** : un CSV par station et par métrique, `<STATION>_<Metric>_<début> to <fin>.csv`, colonnes `,time_utc,metric`, moyennes horaires en UTC. Une valeur vide signifie qu'il n'y a pas de mesure.
- Diagnostics experts (vérité de référence) dans `data/metadata.md` (avec le contexte matériel et un instantané de l'état système, unités `[unknown]`) et dans `data/d.md`. - **Unités** : `BusVoltage` [V], `BusCurrent` [mA], `Power` [mW], `ShuntVoltage` [mV]. Ces trois dernières sont une seule mesure : la **consommation**. **L'apport (panneau ou secteur) n'est pas mesuré.**
- Cas annotés (tension batterie `BusVoltage`) : - **Batterie LiFePO4 de 12,8 V** :
- entre 30 et 90 % de charge, la tension de nuit reste plate ; elle ne chute qu'au coude (~12,8 V, puis ~12,5 V) ;
| Station | Alimentation | Diagnostic expert | Signature observée | - sous 12 V, la station s'éteint et ne redémarre que vers ~12,6 V ;
|---|---|---|---| - ≥ 14,0 V dans la journée signale une charge complète.
| JUNGFRAU | solaire | sain | aucun trou, max quotidien ~14,1–14,2 V, jours nuageux sans montée diurne | - **Les seuils de tension absolus ne se transposent pas d'une station à l'autre** : comparer la station à son propre passé.
| VERMONT | solaire | interruptions nocturnes (déficit) | max quotidien plafonne ~13,2–13,5 V dès le 20/09, coupures nocturnes dès le 27/09 vers ~12,2 V | - **Un trou n'est pas forcément une coupure** : retard de synchronisation en fin de fichier, début d'historique, cause commune si plusieurs stations ont un trou en même temps.
| WILDSTRUBEL | solaire | décharge profonde sous 12 V (UVLO désactivé ?), coupure ~12 j, puis interruptions nocturnes | max 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). Quelques trous courts à tension normale : ce ne sont pas des coupures d'alimentation |
| MISSISSIPPI | secteur | coupures secteur : la batterie sert d'UPS puis le système se déconnecte | chute 14,2 → ~13,1 V, lente baisse, coude vers 12,5 V, puis décrochage ; nombreuses coupures déc. 2025–juin 2026, lectures jusqu'à 10,3 V |
- Pièges :
- Des valeurs vides **en fin de fichier** peuvent être un retard de synchronisation (`last_sync`), pas une coupure (WILDSTRUBEL, MISSISSIPPI le 09/10).
- Des trous **simultanés sur plusieurs stations** (FLORIDA et MISSISSIPPI le 22/07 à 14:00 et le 22/08 à 17:00) pointent plutôt vers une cause commune hors station.
- Un trou avec une tension normale avant et après n'est pas un problème d'énergie.
## Domaine : l'essentiel
Énergie (metadata + manuel de la station) :
- Batterie LiFePO4 de 12,8 V nominal (environ 7 ou 21 Ah). Panneau solaire 12 V, ~100 W conseillé. Entrée max 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'à ~12,6 V avant de redémarrer. 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.
Colonnes CSV des déplacements (cas d'usage suivant), préfixées par la cible (ex. `target_06_rch`) :
- `rch` / `rcv` : déplacement corrigé du mouvement caméra [mm], 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 / modèle inadapté.
## Règles non négociables ## Règles non négociables
@@ -75,12 +92,14 @@ Causes à départager pour une anomalie de déplacement : mouvement réel de l'o
- Ne pas confondre qualité image d'une cible et qualité du réseau de références, ni petit résidu et transformation bien contrainte. - Ne pas confondre qualité image d'une cible et qualité du réseau de références, ni petit résidu et transformation bien contrainte.
- Ne pas confondre mouvement en mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes. - Ne pas confondre mouvement en mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes.
- Séparer fait observé, fait dérivé, contexte opérateur, hypothèse et inconnu. Pas de pseudo-probabilités ; vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`. - Séparer fait observé, fait dérivé, contexte opérateur, hypothèse et inconnu. Pas de pseudo-probabilités ; vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`.
- Pas de règle spécifique à un site : les cas résolus deviennent des tests de régression. - Pas de règle spécifique à un site : les cas résolus deviennent des cas de régression.
- Lecture seule : aucune action sur les stations, la configuration ou le retraitement. - Lecture seule : aucune action sur les stations, la configuration ou le retraitement.
## Environnement ## Environnement
- `pandas` n'est pas installé dans l'environnement de dev ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`). - `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`).
- `.venv/` (Python 3.14) ne contient que plotly, pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
- Prototype expérimental : **pas de tests automatisés** (D-008). Vérifier les changements à la main en lançant `python3 src/analyse_01.py` sur VERMONT.
## Conventions ## Conventions
+33
View File
@@ -0,0 +1,33 @@
# Support-Agent — diagnostic proactif AIMsight
Agent de diagnostic **100 % analytique (sans LLM)** pour les stations AIMsight. Il analyse les séries temporelles d'une station, détecte les anomalies et les explique à partir de faits calculés, avant que le client ne pose la question. Premier cas d'usage : la **santé énergétique** des stations (batterie, alimentation, interruptions de mesure).
## Lancer l'analyse
```bash
python3 src/analyse_01.py
```
Le script analyse `data/` (station VERMONT), écrit `out/VERMONT_energy.html` et l'ouvre dans le navigateur.
Le graphique se lit ainsi :
- **en haut**, l'analyse ;
- **dessous**, une courbe par mesure de la station ;
- **zoom** : dans le temps, au rectangle ou à la molette ; double-clic pour revenir à la vue complète.
Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer cet environnement : `python3 -m venv .venv && .venv/bin/pip install plotly`.
## Où trouver quoi
| Besoin | Où |
|---|---|
| Vue d'ensemble, règles du projet, commandes | `CLAUDE.md` |
| Pourquoi le projet est comme il est (décisions, options écartées) | `docs/decisions.md` |
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/analyses/analyse_NN.md` |
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` |
| Documentation AIMsight d'origine | `doc/` |
| Données de travail (VERMONT) et diagnostics experts | `data/` |
## État
Prototype expérimental, sans tests automatisés. Une analyse est en place : `MA7D_DROP`, la tendance de la tension batterie sur 7 jours. Les suivantes sont listées dans `docs/analyses/analyse_01.md` (section « Pistes »).
+48
View File
@@ -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.
+104
View File
@@ -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).
+126
View File
@@ -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.
+13
View File
@@ -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.
+45
View File
@@ -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`).
+19
View File
@@ -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.
+17
View File
@@ -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.