Compare commits
7
Commits
5a886b4e7e
...
997e842568
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
997e842568 | ||
|
|
9177982de1 | ||
|
|
28ed86baba | ||
|
|
27c52bac75 | ||
|
|
276c34ea38 | ||
|
|
f0990c16e6 | ||
|
|
28d441889f |
No files matched your search
@@ -14,7 +14,7 @@ paths:
|
||||
- **Contrat commun** :
|
||||
- `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}` ;
|
||||
- calcul **causal** : le point t n'utilise que les données ≤ t ;
|
||||
- `anomaly = None` signifie UNKNOWN (exception : `DAILY_BATTERY_STATE` en phase C, `DAILY_BATTERY_TREND`, `DAILY_LINK_STATE`, `DAILY_SIGNAL_STATE`, `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`, `facts.trend` ou `facts.filling`) ;
|
||||
- `anomaly = None` signifie UNKNOWN (exception : `DAILY_BATTERY_STATE` en phase C, `DAILY_BATTERY_TREND`, `DAILY_LINK_STATE`, `DAILY_SIGNAL_STATE`, `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et `DAILY_POWER_SOURCE`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`, `facts.trend`, `facts.filling` ou `facts.power`) ;
|
||||
- une analyse seule conclut au plus `consistent with`.
|
||||
- **Code de calcul** (`src/<domaine>/`) : bibliothèque standard uniquement et aucun import de `src/common/`, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`). Le chargement des CSV est dans `common.stations`.
|
||||
- **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source.
|
||||
@@ -25,5 +25,5 @@ paths:
|
||||
- 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/` (commun) ou `docs/<domaine>/domaine/`.
|
||||
- **Vérifier à la main** sur le jeu de travail du domaine : VERMONT (`data/VERMONT/`) pour Energy, avec `python3 src/energy/all_analyses.py`, et `python3 src/energy/final.py` si l'analyse est livrée ; WEISSHORN (`data/WEISSHORN/`) pour Storage et Cellular (D-030). Pas de tests automatisés en phase prototype (D-008).
|
||||
- **Vérifier à la main** sur le jeu de travail du domaine : VERMONT (`data/VERMONT/`) pour Energy, avec `python3 src/energy/all_analyses.py`, et `python3 src/energy/final.py` si l'analyse est livrée ; WEISSHORN (`data/WEISSHORN/`) pour Storage et Cellular (D-030) ; WEISSHORN et NORDEND pour Temperature (D-040). Pas de tests automatisés en phase prototype (D-008).
|
||||
- **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.
|
||||
@@ -49,8 +49,10 @@ Un domaine reprend le travail fait pour Energy : des analyses sans LLM, un verdi
|
||||
|
||||
## 7. Livrer et documenter
|
||||
|
||||
- Figure du site : `src/<domaine>/final.py`, sur le modèle de `src/energy/final.py` (D-021), en anglais.
|
||||
- Maquettes : proposer, puis attendre les consignes de l'utilisateur. Côté support, une notification sur `maquettes/support/home.py` ; côté client, un bloc dans la section Diagnostic.
|
||||
- **Si les maquettes ne parcourent pas encore une liste de domaines, faire ce passage d'abord, une seule fois** : déplacer `HEADLINE` d'Energy de `maquettes/support/home.py` vers `src/energy/day_color.py`, puis remplacer l'appel direct à `energy.day_color` par `DOMAINS = {"Energy": energy.day_color, "<Domaine>": <domaine>.day_color}`, parcouru pour les notifications (D-030).
|
||||
- Figure du site : `src/<domaine>/final.py`, sur le modèle de `src/cellular/final.py` (D-021, D-039), en anglais : `daily_figure(station, series)` et `out/<STATION>_<domaine>_daily.html` + `.json` ; la page de comparaison importe ses panneaux (`analysis_panels`).
|
||||
- Maquettes : proposer le contenu du bloc client (deux lignes en mots simples, sur le modèle des blocs existants), puis attendre les consignes de l'utilisateur. Les maquettes parcourent une liste de domaines (D-039) :
|
||||
- `HEADLINE` dans `src/<domaine>/day_color.py`, avec une phrase Green pour la vue client ;
|
||||
- côté support, ajouter le domaine à `DOMAINS` dans `maquettes/support/home.py` ;
|
||||
- côté client, l'ajouter à `DOMAINS` dans `maquettes/user/summary.py` (couleur, figure, guide), puis à `DOMAIN` et `ROWS` dans `maquettes/user/summary_template.html`.
|
||||
- Guide : `docs/<domaine>/guide/`, en deux couches, client puis support (D-020).
|
||||
- `CLAUDE.md` : tableau des analyses du domaine, « État et prochaine étape », commandes, carte. `docs/decisions.md` : une entrée pour le nouveau domaine (jeu de travail, sens des couleurs).
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"name": "Support-Agent",
|
||||
"image": "mcr.microsoft.com/devcontainers/python:3.14",
|
||||
"runArgs": ["--network=host"],
|
||||
"postCreateCommand": "pip install --user plotly"
|
||||
}
|
||||
@@ -10,14 +10,16 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti
|
||||
|
||||
L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.md`.
|
||||
|
||||
- **Energy, livré (prototype, D-020)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu). Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon.
|
||||
- **Energy, livré (prototype, D-020, D-043)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu) ; sur secteur (`DAILY_POWER_SOURCE`), la perte du secteur décide à la place de la matrice (rouge dès une heure < 13,4 V), statut `On mains` / `Not on mains` dans la notification du support et dans l'en-tête du bloc Energy de la vue client. Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon.
|
||||
- **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`).
|
||||
- **Maquettes du site (D-022)** : client « Energy » (section Diagnostic de la page System Summary) ; support « Home » (section Status, une notification par station Orange ou Red, lien vers la vue client, D-025).
|
||||
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
||||
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; ni figure du site, ni maquette, ni guide (étape 7 de `nouveau-domaine`).
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; ni figure du site, ni maquette, ni guide (étape 7 de `nouveau-domaine`). Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Températures (D-036)** : explorées sur les trois stations, pas de domaine pour l'instant (ni épisode de chaleur, ni seuil sourcé, ni cas de l'expert) ; constats, pistes et questions dans `docs/domaine/temperatures-de-la-station.md`.
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, puis la livraison (étape 7) ; `storage` : la livraison (étape 7 de `nouveau-domaine`, dans une autre conversation : figure du site `src/storage/final.py`, passage des maquettes à une liste de domaines, maquettes à proposer puis attendre les consignes, guide `docs/storage/guide/`) ; températures : rien à faire avant les réponses du spécialiste (questions de `docs/domaine/temperatures-de-la-station.md`) ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre « Energy » côté client pas à pas, puis le côté support pas à pas (points ouverts dans D-022).
|
||||
- **Enquête à la demande (D-042)** : approche auxiliaire pour les données de mesure : un agent enquête sur un événement (outils typés, réfutation obligatoire, preuves tracées), support d'abord puis client ; document seulement, rien n'est construit.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039).
|
||||
|
||||
## Analyses (domaine Energy)
|
||||
|
||||
@@ -29,6 +31,7 @@ Code dans `src/energy/`, fiche dans `docs/energy/analyses/<règle en minuscules>
|
||||
| `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (prototype, D-020) | `battery_trend.py` |
|
||||
| `MOVING_AVERAGE_7_DAYS_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | comparaison : ~2,7 jours d'avance sur la première coupure de VERMONT, mais bruitée (pire cas sain −0,16 V) | `moving_average.py` |
|
||||
| `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC de chaque jour | comparaison : peu bruitée (−0,04 V), mais 1 h d'avance seulement | `moving_average.py` |
|
||||
| `DAILY_POWER_SOURCE` | Chaque jour : sur secteur (moyenne des 3 jours avant J ≥ 14,0 V) ? Si oui, une heure de J < 13,4 V (perte du secteur) ? | livrée (prototype, D-043) ; vérifiée sur WEISSHORN, NORDEND et MISSISSIPPI (historique git) | `power_source.py` |
|
||||
|
||||
- **Couleur du jour** : `src/energy/day_color.py` (`MATRIX`, `focus()` pour J−1 / J), transcription de `docs/energy/matrice-etat-tendance.drawio`.
|
||||
- **Travailler sur une analyse** : `.claude/rules/analyses.md` (contrat `run(series)`, calcul causal, constantes sourcées, graphiques, fiche à jour) se charge seul dès qu'on touche `src/` ou `docs/*/analyses/`.
|
||||
@@ -45,6 +48,7 @@ Code dans `src/cellular/`, fiche dans `docs/cellular/analyses/<règle en minuscu
|
||||
| `DAILY_SIGNAL_STATE` | Chaque jour : médianes du RSRP et du RSRQ sur la grille publiée (excellent, bon, moyen, limite de cellule) | prototype (D-031) | `signal_state.py` |
|
||||
|
||||
- **Couleur du jour** : `src/cellular/day_color.py` (`MATRIX[lien][signal]`, `HEADLINE`), transcription de `docs/cellular/matrice-lien-signal.drawio` (D-037).
|
||||
- **Livré (D-039)** : figure du site `src/cellular/final.py` (panneaux partagés avec la page de comparaison), guide `docs/cellular/guide/diagnostic-cellulaire.md`.
|
||||
|
||||
## Analyses (domaine Storage)
|
||||
|
||||
@@ -56,24 +60,40 @@ Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscule
|
||||
| `DAYS_UNTIL_STORAGE_FULL` | Chaque jour : dans combien de jours le disque sera-t-il plein, au rythme médian des 7 derniers jours ? | prototype (D-034) | `days_until_full.py` |
|
||||
|
||||
- **Couleur du jour** : `src/storage/day_color.py` (`MATRIX[état][horizon]`, `HEADLINE`), transcription de `docs/storage/matrice-etat-horizon.drawio` (D-035).
|
||||
- **Livré (D-039)** : figure du site `src/storage/final.py` (panneaux partagés avec la page de comparaison), guide `docs/storage/guide/diagnostic-stockage.md`.
|
||||
|
||||
## Analyses (domaine Temperature)
|
||||
|
||||
Code dans `src/temperature/`, fiche dans `docs/temperature/analyses/<règle en minuscules>.md`, page de comparaison `src/temperature/all_analyses.py` (WEISSHORN et NORDEND, D-040).
|
||||
|
||||
| Règle | Question | Statut | Code |
|
||||
|---|---|---|---|
|
||||
| `DAILY_GPU_TEMPERATURE_LIMIT` | Chaque jour : une moyenne horaire du GPU a-t-elle atteint 97,5 °C (limite du constructeur) dans les 24 dernières heures ? | prototype (D-040) | `gpu_temperature_limit.py` |
|
||||
|
||||
- **Couleur du jour** : `src/temperature/day_color.py` (`COLOR`, `HEADLINE`) : Red si la limite est atteinte, Green sinon, sans matrice (D-040).
|
||||
- **Livré (D-041)** : figure du site `src/temperature/final.py` (panneau partagé avec la page de comparaison), guide `docs/temperature/guide/diagnostic-temperature.md`.
|
||||
|
||||
## Commandes
|
||||
|
||||
```bash
|
||||
python3 src/energy/final.py [données] # livré : out/<STATION>_daily.html + .json (figure du site, D-021)
|
||||
python3 src/energy/all_analyses.py [données] # les 4 analyses comparées (D-016) : out/<STATION>_energy.html
|
||||
python3 src/energy/all_analyses.py [données] # les 5 analyses comparées (D-016) : out/<STATION>_energy.html
|
||||
python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024) : faits + out/<STATION>_focus_<AAAA-MM-JJ>.html + .json
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_storage.html (défaut data/WEISSHORN/)
|
||||
python3 maquettes/user/energy.py [début] [fin] # maquette client : out/maquette_user_energy.html
|
||||
python3 src/cellular/final.py [données] # livré : out/<STATION>_cellular_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (même défaut)
|
||||
python3 src/storage/final.py [données] # livré : out/<STATION>_storage_daily.html + .json (défaut data/WEISSHORN/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_storage.html (même défaut)
|
||||
python3 src/temperature/final.py [données] # livré : out/<STATION>_temperature_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/temperature/all_analyses.py [données] # limite du GPU : out/<STATION>_temperature.html (même défaut)
|
||||
python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_<STATION>.html, une page par station de data/
|
||||
python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html
|
||||
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
|
||||
python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
```
|
||||
|
||||
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène à la maquette client : les lancer avec les mêmes dates.
|
||||
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène aux maquettes client : les lancer avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||||
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL).
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur VERMONT.
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine.
|
||||
|
||||
## Carte du dépôt
|
||||
|
||||
@@ -87,19 +107,20 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
### Fichiers
|
||||
|
||||
- `README.md` (40 l) : point d'entrée pour un humain.
|
||||
- `docs/decisions.md` (396 l, D-001 à D-037) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/decisions.md` (476 l, D-001 à D-043) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
- `colonnes-des-deplacements.md` : colonnes des déplacements (cas d'usage suivant).
|
||||
- `temperatures-de-la-station.md` : zones thermiques, constats sur trois stations, pistes non retenues, questions au spécialiste (D-036).
|
||||
- `docs/energy/` : le domaine Energy.
|
||||
- `analyses/<règle>.md` (80-120 l) : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, pistes, historique). Modèle : `.claude/skills/nouvelle-analyse/modele-fiche.md`.
|
||||
- `domaine/` (< 80 l) : `comment-se-comporte-la-batterie.md` (LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité) ; `tensions-selon-l-etat-de-la-batterie.md` (tensions et pentes en charge, pleine charge et décharge) ; `cas-annotes-par-l-expert.md` (diagnostics experts des 5 stations, vérité de référence).
|
||||
- `guide/diagnostic-energetique.md` (180 l, brouillon) : manuel, partie 1 pour le client (§1-4), partie 2 pour le support (§5-9). À tenir à jour avec la matrice et les fiches des deux analyses livrées.
|
||||
- `matrice-etat-tendance.drawio` : matrice état × tendance, tenue par l'utilisateur.
|
||||
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/` et ses questions ouvertes dans `domaine/questions-pour-l-expert.md`.
|
||||
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/`, ses questions ouvertes dans `domaine/questions-pour-l-expert.md` et son guide (~90 l, client puis support) dans `guide/`, dont la partie 1 est affichée dans la vue client.
|
||||
- `docs/temperature/` : domaine Temperature (D-040), sans matrice ; guide dans `guide/` (D-041). `domaine/point-de-depart.md` : zones thermiques, carte supposée (Jetson Nano) et ses limites, constats sur trois stations, pistes, questions au spécialiste ; fiche dans `analyses/`.
|
||||
- `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vivra à part (`agents/`, proposé, pas créé).
|
||||
- `docs/agents/enquete-a-la-demande.md` (233 l) : enquête à la demande sur un événement de mesure (D-042), même cadre ; harnais (§3), déroulé (§4), sortie et règle d'asymétrie (§5), étapes (§6), questions ouvertes (§9).
|
||||
- `docs/aimsight/` : documentation AIMsight d'origine, en anglais, non modifiée. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||||
- `AIMsight_agentic_support_project_context.md` (2 090 l) : extension support : chaîne de dépendance (§4), domaines dont la santé système (§5.1, le cas d'usage actuel), 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).
|
||||
@@ -109,16 +130,18 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
- `docs/superpowers/` : specs et plans superpowers (170-850 l chacun). Historique non maintenu, pas une référence. La spec d'une nouvelle analyse s'écrit dans sa fiche ; le plan peut aller dans `docs/superpowers/plans/`.
|
||||
- `data/` : un dossier par station (D-029).
|
||||
- `VERMONT/` : **jeu de travail = VERMONT seule** (D-009), le plus long historique : 7 CSV, un par métrique système (~5 000 l chacun). Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts).
|
||||
- `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, du 09/08 au 13/10, mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier ; le dépôt doit rester privé (D-014).
|
||||
- `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, du 09/08 au 13/10, mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030) ; sur secteur, avec NORDEND, il sert à `DAILY_POWER_SOURCE` (D-043). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier ; le dépôt doit rester privé (D-014).
|
||||
- `NORDEND/` : tous les champs d'une version plus ancienne du collecteur (export du 2026-10-13, 109 jours, sans `link`) ; deuxième jeu de travail de `cellular`, station à la liaison faible (D-032). Mêmes identifiants à ne pas recopier (`SIM_CCID`, `ip_*`).
|
||||
- Les notes brutes de l'expert (`metadata.md`, `d.md`) et `archive/` ont été retirées le 2026-10-13 (D-033) : leur résumé est dans `docs/energy/domaine/cas-annotes-par-l-expert.md`.
|
||||
- `src/` : un sous-dossier par domaine, plus le code commun (D-026).
|
||||
- `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
|
||||
- `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`.
|
||||
- `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; page plotly `all_analyses.py` (D-031).
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; page plotly `all_analyses.py` (D-034).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/energy.py` + `energy_template.html` (client), `support/home.py` + `home_template.html` (support).
|
||||
- `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `power_source.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`.
|
||||
- `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-031).
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
||||
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `settings.json` (lecture de `.env` interdite).
|
||||
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra.
|
||||
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
||||
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
|
||||
|
||||
@@ -169,3 +192,4 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
|
||||
- `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.
|
||||
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container » ; dans le conteneur, les pages restent dans `out/` sans s'ouvrir seules.
|
||||
@@ -10,7 +10,7 @@ python3 src/energy/final.py
|
||||
|
||||
Le script analyse `data/VERMONT/` et ouvre dans le navigateur `out/VERMONT_daily.html`, l'état et la tendance de la batterie jour par jour : ce sont les analyses livrées, destinées au site de monitoring. La figure Plotly est aussi écrite dans `out/VERMONT_daily.json`.
|
||||
|
||||
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`. Pages des autres domaines, sur WEISSHORN par défaut : `python3 src/storage/all_analyses.py` (espace disque) et `python3 src/cellular/all_analyses.py` (signal 4G).
|
||||
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`. Pages des autres domaines, sur WEISSHORN par défaut : `python3 src/storage/all_analyses.py` (espace disque) et `python3 src/cellular/all_analyses.py` (signal 4G) ; sur WEISSHORN et NORDEND, `python3 src/temperature/all_analyses.py` (limite du GPU).
|
||||
|
||||
La page de comparaison se lit ainsi :
|
||||
- **en haut**, l'analyse ;
|
||||
@@ -27,11 +27,11 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c
|
||||
| Pourquoi le projet est comme il est (décisions, options écartées) | `docs/decisions.md` |
|
||||
| Lire le diagnostic énergétique (manuel client et support) | `docs/energy/guide/diagnostic-energetique.md` |
|
||||
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
|
||||
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/<domaine>/domaine/` (`energy`, `storage`, `cellular`) |
|
||||
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/<domaine>/domaine/` (`energy`, `storage`, `cellular`, `temperature`) |
|
||||
| Documentation AIMsight d'origine | `docs/aimsight/` |
|
||||
| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular) | `data/<STATION>/` |
|
||||
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/energy.py`, `python3 maquettes/support/home.py` | `maquettes/` |
|
||||
| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular et Temperature) | `data/<STATION>/` |
|
||||
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/summary.py`, `python3 maquettes/support/home.py` | `maquettes/` |
|
||||
|
||||
## État
|
||||
|
||||
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »). Deux autres domaines sont en prototype, sans cas annotés par l'expert. Storage (espace disque) : `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et leur couleur du jour, avec des seuils arbitraires pour commencer (D-034, D-035) ; reste la livraison. Cellular (signal 4G) : `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE`, en pause en attendant le spécialiste. Le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).
|
||||
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »). Trois autres domaines sont en prototype, sans cas annotés par l'expert. Storage (espace disque) : `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et leur couleur du jour, avec des seuils arbitraires pour commencer (D-034, D-035) ; reste la livraison. Cellular (signal 4G) : `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE`, en pause en attendant le spécialiste. Temperature : `DAILY_GPU_TEMPERATURE_LIMIT` et sa couleur du jour, rouge si le GPU a atteint 97,5 °C, la limite du constructeur, dans les 24 dernières heures (D-040) ; restent la figure du site et le guide. Le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).
|
||||
@@ -0,0 +1,233 @@
|
||||
# Enquête à la demande : un agent qui explique un événement de mesure
|
||||
|
||||
- **Date** : 2026-10-13.
|
||||
- **Statut** : exploratoire. Rien n'est construit ; ce document fixe une direction et un démarrage par étapes. Décision liée : D-042 (`docs/decisions.md`).
|
||||
- **Place** : une approche **auxiliaire** du rapport `docs/agents/rapport-exploratoire.md` (D-027), plus simple, qui ne le remplace pas. Les deux partagent le même cadre (§3).
|
||||
- **Principe de travail** : commencer simple, ne complexifier que si le besoin apparaît.
|
||||
|
||||
---
|
||||
|
||||
## 1. Objet
|
||||
|
||||
Le diagnostic actuel porte sur les **états** de la caméra (batterie, disque, 4G, température). Le cas d'usage suivant porte sur les **données qu'elle mesure** : positions et déplacements des cibles, état de la compensation, qualité des références. On monte d'un cran : il faut départager un mouvement réel de l'ouvrage d'un artefact de mesure.
|
||||
|
||||
**Le problème.** Le client voit toutes les données mais ne sait pas les interpréter. Lors d'un événement sur le terrain, il ne peut pas dire s'il est problématique ou anodin. Aucune méthode n'aide à ce diagnostic : il contacte le support, qui enquête à la main.
|
||||
|
||||
**Le but.** Répondre au client automatiquement, avec preuves et explications, pour qu'il n'ait plus à solliciter le support.
|
||||
|
||||
**Le moyen.** Quand un événement pose question, un agent (Claude, via l'API d'Anthropic) reçoit la question et enquête avec un harnais : connaissance métier, outils en lecture, cas résolus. Il rend un diagnostic dont chaque preuve est traçable.
|
||||
|
||||
### Ce qui distingue cette approche du rapport exploratoire
|
||||
|
||||
| | Rapport exploratoire (D-027) | Enquête à la demande (ce document) |
|
||||
|---|---|---|
|
||||
| Déclenchement | Chaque jour, pour chaque station | Un événement qui pose question |
|
||||
| Unité de travail | Une session par (agent, station, jour) | Une session par question |
|
||||
| Rôle de l'agent | Annoter la couleur du jour, capter l'inconnu | Expliquer un événement précis |
|
||||
| Données | États de la station (Energy d'abord) | Données de mesure (déplacements), plus les états en contexte |
|
||||
| Infrastructure | Cron, SQL, flotte entière | Un script lancé à la main au départ |
|
||||
|
||||
Les docs AIMsight décrivent déjà ce processus : le *support query workflow* (§13 de `AIMsight_agentic_support_project_context.md`) et l'*explainer* d'événements (§4 de `AIMsight_reference_quality_event_explainer_roadmap.md`). La différence : l'agent mène l'enquête lui-même au lieu d'expliquer un dossier préparé d'avance.
|
||||
|
||||
---
|
||||
|
||||
## 2. Choix retenus
|
||||
|
||||
| Question | Choix | Raison |
|
||||
|---|---|---|
|
||||
| Qui reçoit le diagnostic | Le **support d'abord** (il relit, corrige et envoie), puis **le client directement** pour les classes sans enjeu pour l'ouvrage | Asymétrie du risque : dire « anodin » à tort est plus grave qu'une fausse alerte (§5) |
|
||||
| Qui déclenche l'enquête | Le **support à la main**, puis un **bouton client** sur le site, puis une **détection automatique** | Tester sur de vrais tickets sans toucher au site ; les critères automatiques viendront des tickets, pas d'un seuil inventé |
|
||||
| Forme de l'agent | Un **enquêteur avec des outils typés** (approche 2, §8) | Il creuse ce qui est utile, et chaque preuve renvoie à un appel d'outil |
|
||||
| Sources de données | **Pas encore connues** (CSV, HDF5, images, SQL) : les outils sont définis par **famille de preuves**, pas par format | Comme l'API indépendante de l'estimateur de la roadmap (§10) |
|
||||
| Cadre technique | Celui de D-027 : harnais maison, *Tool Runner* du SDK `anthropic`, agent en dossier déclaratif | Un seul cadre pour les deux approches |
|
||||
| Modèle | Opus 5.5 (`claude-opus-5-5`), niveau d'effort fixé explicitement (son défaut est `medium`) | À mesurer sur les premiers rejeux |
|
||||
|
||||
---
|
||||
|
||||
## 3. Le harnais
|
||||
|
||||
L'agent est un dossier déclaratif, comme prévu par D-027 (emplacement proposé : `agents/enquete/agent.md`). Il a trois pièces.
|
||||
|
||||
### 3.1 La connaissance (prompt système, mis en cache)
|
||||
|
||||
- **Les règles communes** : vocabulaire `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed` ; fait observé ≠ fait dérivé ≠ hypothèse ; aucun seuil inventé ; rien construit sur `inlier` binaire ; `sigma0` jamais suffisant seul ; mode commun ≠ mouvement structurel (règles de `CLAUDE.md`).
|
||||
- **La méthode**, par sections ciblées des docs AIMsight, pas les fichiers entiers :
|
||||
- la chaîne de dépendance (§4 du contexte support) ;
|
||||
- les familles d'hypothèses (§12) ;
|
||||
- les classifications de l'*explainer* (§4.3 de la roadmap) ;
|
||||
- le *workflow* en 8 étapes (§13).
|
||||
- **Des pointeurs vers `docs/`**, qui reste la seule source : `docs/domaine/colonnes-des-deplacements.md`, puis les notes de domaine à venir.
|
||||
- **Volume** : de l'ordre de 30 à 60 k tokens, à mesurer. Mis en cache, ce bloc est relu à chaque tour pour 0,20 $ par million de tokens.
|
||||
|
||||
### 3.2 Les outils (lecture seule)
|
||||
|
||||
On commence petit. Chaque outil répond « source indisponible » quand la donnée manque ; l'agent le reporte dans ses inconnus au lieu de conclure. Les outils de calcul renvoient des **valeurs**, pas des verdicts : un seuil de décision ne s'invente pas (§9).
|
||||
|
||||
| Outil | Rôle |
|
||||
|---|---|
|
||||
| `inventory(station, fenêtre)` | Ce qui existe : points, références, colonnes, sources, trous de mesure (étape 3 du *workflow*) |
|
||||
| `get_series(station, colonnes, fenêtre)` | Un résumé chiffré compact et un graphique en image. Un LLM lit mal des centaines de lignes de nombres, il lit bien un graphique |
|
||||
| `compare_before_after(station, colonnes, instant)` | Par colonne, avant et après l'instant : écart, persistance, retour à la normale (UC5 du contexte support) |
|
||||
| `common_mode(station, fenêtre)` | Part des cibles touchées, accord de signe, score de mode commun (famille *Spatial response*, §4.2 de la roadmap) : ce qui sépare l'ouvrage de la compensation |
|
||||
| `get_system_health(station, fenêtre)` | Les couleurs du jour **déjà livrées** (Energy, Storage, Cellular, Temperature) : le bas de la chaîne de dépendance, réutilisé tel quel depuis `src/<domaine>/day_color.py` |
|
||||
| `get_image(station, instant)` | La photo de la caméra, que l'agent regarde (l'API accepte une image dans un résultat d'outil). Brouillard, neige, végétation, cible masquée : ce qu'aucun script ne voit simplement. Seulement si une source d'images existe |
|
||||
| `submit_diagnosis(...)` | La fin obligatoire, au format du §5 |
|
||||
|
||||
Opus 5.5 refuse qu'on force l'appel d'un outil (`tool_choice` `any` ou `tool`). `submit_diagnosis` est donc appelé sur instruction, avec un schéma strict (`strict: true`).
|
||||
|
||||
**Volontairement absents** (comme dans D-027) : SQL libre, Bash, accès web, bac à sable de code (§8).
|
||||
|
||||
### 3.3 La base de cas
|
||||
|
||||
- **Un fichier par cas résolu** : la question du client, les preuves, le brouillon de l'agent, le diagnostic final validé par le support, l'écart entre les deux. C'est la forme prévue par le contexte support (§13 étape 8, §17).
|
||||
- **Au début**, tous les cas tiennent dans le prompt, en cache : pas d'outil de recherche. Un outil `find_cases` viendra quand il y en aura trop.
|
||||
- **Premier cas** : Barcelone (§15 de la roadmap, §16.1 du contexte support), rédigé d'après les docs comme cas documentaire, sans données.
|
||||
- **La base se remplit seule** : une enquête validée par le support devient un cas (§5).
|
||||
|
||||
---
|
||||
|
||||
## 4. Déroulé d'une enquête
|
||||
|
||||
### Lancement (déclenchement par le support)
|
||||
|
||||
```bash
|
||||
python3 agents/enquete.py WEISSHORN 2026-10-02T08:00 --points target_06 --question ticket.txt
|
||||
```
|
||||
|
||||
- Le support donne la station, l'instant et les points : plus fiable que de les faire deviner à l'agent dans le texte du client. Le texte du client part tel quel dans le premier message.
|
||||
- Le code ajoute la fenêtre par défaut : de quelques jours avant l'événement jusqu'à l'heure de la question.
|
||||
- **Borne dans le temps** : l'enquête lit les données **après** l'événement (c'est la seule façon de savoir s'il est revenu à la normale), mais rien après l'heure de la question. Un ticket passé se rejoue donc à l'identique, ce qui permet de juger l'agent.
|
||||
|
||||
### Les étapes demandées à l'agent (d'après le §13 du contexte support)
|
||||
|
||||
1. **Inventaire** (`inventory`) : ce qui est disponible, ce qui manque, et ce qui, en manquant, limite le diagnostic.
|
||||
2. **Le bas de la chaîne d'abord** (`get_system_health`) : une station coupée ou une liaison tombée explique un trou ou un saut sans que l'ouvrage y soit pour rien.
|
||||
3. **Les faits** (`compare_before_after`, `common_mode`, `get_series`, `get_image`) : amplitude, persistance, retour à la normale, nombre de cibles touchées.
|
||||
4. **Les hypothèses candidates**, prises dans les familles du §12 et classées sur les seules preuves.
|
||||
5. **La réfutation de l'hypothèse principale** : chercher la preuve qui la contredirait. Exemple : on pense à un mouvement de l'ouvrage. Les références ont-elles bougé ? La transformation a-t-elle sauté ? Toutes les cibles ont-elles bougé ensemble ? Cette tentative est **obligatoire** et figure dans la sortie.
|
||||
6. **`submit_diagnosis`**. « Rien d'anormal » est une conclusion valable.
|
||||
|
||||
### Garde-fous (tenus par le code, pas par le modèle)
|
||||
|
||||
- **Journal de session** : chaque appel d'outil est enregistré avec ses entrées et sa sortie, sous un identifiant.
|
||||
- **Preuves vérifiées** : chaque preuve du diagnostic cite l'identifiant d'un appel du journal. Le code refuse un diagnostic qui cite un identifiant inexistant, ce qui empêche les faits inventés.
|
||||
- **Budget** : un plafond par enquête, en tokens et en appels. S'il est atteint, l'agent conclut avec ce qu'il a (`insufficient evidence` si besoin) plutôt que d'être coupé en plein raisonnement.
|
||||
|
||||
---
|
||||
|
||||
## 5. Sortie et relecture
|
||||
|
||||
### Ce que rend `submit_diagnosis` (d'après §14-15 du contexte support)
|
||||
|
||||
| Champ | Contenu |
|
||||
|---|---|
|
||||
| `classification` | Une liste fermée : mouvement de l'ouvrage, événement de compensation (caméra ou références), solution de références faible, parallaxe ou modèle inadapté, cible dégradée, problème système (acquisition, transport), rien d'anormal, indéterminé. Classes du §4.3 de la roadmap, complétées du bas de la chaîne |
|
||||
| `affected_layer` | La couche de la chaîne de dépendance |
|
||||
| `qualifier` | `confirmed` … `insufficient evidence` |
|
||||
| `evidence` | Les faits, chacun avec l'identifiant de l'appel d'outil qui le prouve |
|
||||
| `refutation` | Ce qui a été vérifié contre l'hypothèse principale, et le résultat |
|
||||
| `alternatives` | Les autres explications, et pourquoi elles ne sont pas écartées |
|
||||
| `unknowns` | Les preuves manquantes qui limitent la conclusion |
|
||||
| `next_check` | La vérification suivante la plus discriminante |
|
||||
| `client_draft` | Un brouillon de réponse au client : court, sans jargon ni mécanisme, comme la vue client |
|
||||
|
||||
### La règle d'asymétrie (tenue par le code)
|
||||
|
||||
Le brouillon ne peut dire « sans conséquence pour l'ouvrage » que si :
|
||||
- l'explication « artefact » (compensation, cible, système) est au moins `strongly supported` ;
|
||||
- **et** le mouvement de l'ouvrage a été réfuté explicitement.
|
||||
|
||||
Sinon, le code remplace la conclusion du brouillon par une formule neutre (« événement en cours d'analyse par notre support »). La règle sert dès le départ (le support ne recopie pas une fausse assurance) et délimitera plus tard ce qui part directement au client.
|
||||
|
||||
### La relecture par le support
|
||||
|
||||
- **Un dossier par enquête** (emplacement proposé : `agents/enquetes/<date>_<station>/`) : le journal des appels, le diagnostic en JSON, une page HTML de relecture (diagnostic, preuves avec leurs graphiques, brouillon client).
|
||||
- **Le support relit, corrige le brouillon et l'envoie lui-même**, puis remplit une courte validation : accepté tel quel, ou corrigé (en quoi), et le diagnostic final.
|
||||
- **Une enquête validée devient un cas** de la base (§3.3), sans autre étape.
|
||||
- **Mesures qui décident de la suite** : le taux d'accord entre l'agent et le support (classification, qualificatif, brouillon envoyé tel quel ou réécrit), puis le temps gagné par ticket.
|
||||
- **Langue, par défaut** : la partie technique en anglais (termes AIMsight), le brouillon dans la langue du client.
|
||||
|
||||
---
|
||||
|
||||
## 6. Démarrage par étapes
|
||||
|
||||
Deux axes à ne pas confondre : **qui déclenche** (le support, puis le client, puis la détection automatique) et **qui reçoit** (le support, puis le client pour certaines classes). Chaque étape répond à une question, et sa réponse décide si la suivante est nécessaire.
|
||||
|
||||
1. **Le harnais sur les données existantes.** Cas d'usage UC3 (« pourquoi pas de données entre X et Y ? ») rejoué sur les coupures connues : les 11 coupures de la liaison de NORDEND, les incidents isolés de WEISSHORN. *Question* : la tuyauterie tient-elle (preuves vérifiées, réfutation, page de relecture), et à quel coût ? N'attend pas les données de déplacement.
|
||||
2. **Rejeu de cas de déplacement résolus**, dès qu'un export contient un événement expliqué (Barcelone idéalement). On branche `compare_before_after` et `common_mode` sur les CSV. *Question* : l'agent retrouve-t-il le diagnostic de l'expert, sans sur-conclure ?
|
||||
3. **Le support s'en sert sur ses vrais tickets.** *Question* : quel taux d'accord, quel temps gagné ?
|
||||
4. **Le bouton client sur le site** : la demande arrive au support déjà enquêtée. *Question* : les clients s'en servent-ils, et pour quels événements ?
|
||||
5. **Réponse directe au client** pour les classes sans enjeu pour l'ouvrage, si l'accord mesuré le justifie. Ensuite seulement, la **détection automatique**, sur des critères tirés des tickets réels. C'est là que les deux approches se rejoignent : une surveillance quotidienne (D-027) qui repère un événement peut lancer une enquête.
|
||||
|
||||
---
|
||||
|
||||
## 7. Coût, risques, prérequis
|
||||
|
||||
### Coût (hypothèse, à mesurer à l'étape 1)
|
||||
|
||||
Prix d'Opus 5.5 : 4 $ par million de tokens en entrée, 20 $ en sortie, 0,20 $ en lecture de cache, 5 $ en écriture de cache (1,25 × l'entrée, durée de vie de 5 minutes). Une image de 1280 × 720 coûte environ 1 200 tokens.
|
||||
|
||||
Hypothèse par enquête : 45 k tokens de connaissance, une dizaine de tours, 50 k tokens nouveaux (résultats d'outils, images), 20 k tokens de sortie (raisonnement compris). Les tickets étant espacés, le cache est **froid** au début de chaque enquête.
|
||||
|
||||
| Poste | Calcul | Coût |
|
||||
|---|---|---|
|
||||
| Écriture du cache (connaissance) | 45 k × 5 $/M | 0,23 $ |
|
||||
| Écriture du cache (résultats d'outils, images) | 50 k × 5 $/M | 0,25 $ |
|
||||
| Lectures du cache | 10 tours × ~60 k × 0,20 $/M | 0,12 $ |
|
||||
| Sortie | 20 k × 20 $/M | 0,40 $ |
|
||||
| **Par enquête** | | **~1 $ (0,5 à 2 $)** |
|
||||
|
||||
Le volume suit celui des tickets : le coût n'est pas limitant face au temps d'un ingénieur support.
|
||||
|
||||
### Risques
|
||||
|
||||
| Risque | Parade |
|
||||
|---|---|
|
||||
| Fausse assurance (« anodin » à tort) | Règle d'asymétrie tenue par le code (§5) ; relecture par le support jusqu'à l'étape 5 |
|
||||
| Faits inventés | Chaque preuve cite un appel du journal, vérifié par le code (§4) |
|
||||
| Sur-conclusion sur des données incomplètes | `inventory` en premier ; `unknowns` obligatoire ; `insufficient evidence` admis |
|
||||
| Graphique mal lu | Résumé chiffré à côté de l'image ; calculs déterministes dans les outils |
|
||||
| Trop peu de cas pour juger | Rejeu des tickets passés ; chaque enquête validée devient un cas |
|
||||
| Données client chez Anthropic | Accepté (D-027) ; conditions de conservation à valider avec la direction |
|
||||
|
||||
### Prérequis
|
||||
|
||||
- **Étape 1** : une clé API Anthropic (la même que pour D-027).
|
||||
- **Étape 2** : un export de déplacements avec un événement connu et son explication.
|
||||
- **`get_image`** : une source d'images, peut-être l'API REST de la caméra (attendue pour le dev container, D-038).
|
||||
|
||||
---
|
||||
|
||||
## 8. Options écartées
|
||||
|
||||
| Option | Raison |
|
||||
|---|---|
|
||||
| **1. Dossier de preuves, puis rédaction** (l'*explainer* de la roadmap, un seul appel au LLM) | L'agent ne peut pas creuser (autre cible, autre période, image) ; le dossier doit tout prévoir d'avance. Il reste le premier message de l'enquête, en version réduite |
|
||||
| **3. Enquêteur avec un bac à sable de code** | Calculs non relus, risque de seuils inventés, difficile à auditer devant un client inquiet pour son ouvrage. Reste un recours si l'agent lit mal les séries |
|
||||
| Réponse directe au client dès le départ | Le risque de fausse assurance serait d'emblée chez le client |
|
||||
| Détection automatique dès le départ | Il faudrait fixer des critères sur les déplacements avant d'avoir vu un seul ticket |
|
||||
| L'agent extrait station, instant et points du texte du client | Source d'erreur évitable tant que le support lance l'enquête ; à revoir avec le bouton client, qui fournit ces champs |
|
||||
| Recherche de cas (RAG) dès le départ | Inutile tant que les cas tiennent dans le prompt |
|
||||
|
||||
---
|
||||
|
||||
## 9. Questions ouvertes
|
||||
|
||||
1. **Sources de données** : lesquelles (CSV, HDF5, images, SQL), et quand ?
|
||||
2. **Premier cas avec données** : Barcelone ou un autre événement expliqué ?
|
||||
3. **Liste des classifications** : à valider avec l'expert, avec la façon de nommer chaque classe pour le client.
|
||||
4. **Seuils des outils de calcul** : `compare_before_after` et `common_mode` renvoient des valeurs ; d'où viendront les seuils qui disent « saut » ou « mode commun » (expert, docs AIMsight, cas résolus) ?
|
||||
5. **Critère d'ouverture au client** : quel taux d'accord avec le support, sur combien de tickets ?
|
||||
6. **Page de relecture** : son format, et la forme de la validation par le support.
|
||||
7. **Volume de tickets** : combien par semaine (coût total, cache froid ou non) ?
|
||||
8. **Emplacement du code et des dossiers d'enquête** : `agents/enquete/` et `agents/enquetes/` proposés ; versionner les dossiers d'enquête (données client, dépôt privé, D-014) ?
|
||||
|
||||
---
|
||||
|
||||
## Annexe : références
|
||||
|
||||
- `docs/aimsight/AIMsight_agentic_support_project_context.md` : §4 (chaîne de dépendance), §10 (règles épistémiques), §12 (familles d'hypothèses), §13 (*support query workflow*), §14-15 (format de réponse), §16-17 (cas de régression), §23 (cas d'usage UC1 à UC8).
|
||||
- `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md` : §4 (*explainer*, familles de preuves, classifications), §10 (API indépendante de l'estimateur), §15 (Barcelone).
|
||||
- `docs/agents/rapport-exploratoire.md` : le cadre commun (D-027).
|
||||
- `docs/decisions.md` : D-014 (dépôt privé), D-020 (destinataires en couches), D-027 (couche d'agents), D-038 (dev container), D-042 (cette direction).
|
||||
- API Claude (fonctionnalités citées) : *Tool Runner* du SDK `anthropic`, outils stricts (`strict: true`), images dans un résultat d'outil, *prompt caching*, *task budgets*.
|
||||
@@ -49,6 +49,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
## Graphique
|
||||
|
||||
- **En haut** : `received_percent` par jour, placé à midi UTC (D-019), un marqueur par état (couleur, symbole et légende propres ; couleurs validées par le skill dataviz).
|
||||
- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/cellular/final.py` (historique complet du bloc Cellular de la vue client, D-039) ; la page de comparaison l'importe de là.
|
||||
- **Dessous** : les séries du modem, et le nombre d'envois reçus par heure (`last_sync`, sinon `link`), en barres.
|
||||
|
||||
## Résultats (jeu de travail : WEISSHORN et NORDEND, D-032)
|
||||
@@ -110,3 +111,4 @@ NORDEND (109 jours, sans `link`, du 26/06 au 13/10) :
|
||||
- **2026-10-13** : `link` facultatif (exports sans `link`, NORDEND) ; `value` devient `received_percent` ; ajout de `n_sends` ; début d'historique en UNKNOWN ; pourcentages `None` sur un jour coupé (D-032).
|
||||
- **2026-10-13** : limites 9 (comptage par heure) et 10 (cadence supposée) ; deux corrections retenues sur le principe, non codées, en attente du spécialiste (« Pistes »).
|
||||
- **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours.
|
||||
- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/cellular/final.py` ; livraison du domaine (vue client, notifications, guide `docs/cellular/guide/`, D-039).
|
||||
@@ -42,6 +42,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
## Graphique
|
||||
|
||||
- **En haut, deux panneaux** (un par unité : pas de double axe, skill dataviz) : la médiane du jour du RSRP en dBm, puis celle du RSRQ en dB. Les planchers de la grille sont en pointillés, la classe de la mesure en marqueurs ; l'état du jour (la pire classe) est dans le survol.
|
||||
- **Site** : les mêmes deux panneaux, en anglais (D-023), dans la figure du site `src/cellular/final.py` (historique complet du bloc Cellular de la vue client, D-039) ; la page de comparaison les importe de là.
|
||||
- **Dessous** : les séries du modem.
|
||||
|
||||
## Résultats (jeu de travail : WEISSHORN et NORDEND, D-032)
|
||||
@@ -87,3 +88,4 @@ NORDEND (109 jours) :
|
||||
- **2026-10-13** : création (D-031).
|
||||
- **2026-10-13** : résultats sur NORDEND (D-032).
|
||||
- **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours.
|
||||
- **2026-10-13** : deux panneaux en anglais, partagés avec la figure du site `src/cellular/final.py` ; livraison du domaine (vue client, notifications, guide `docs/cellular/guide/`, D-039).
|
||||
@@ -0,0 +1,96 @@
|
||||
# Guide : lire le diagnostic 4G d'une station AIMsight
|
||||
|
||||
- **Statut** : brouillon, 2026-10-13. La couleur du jour est calculée par `src/cellular/day_color.py`, selon la matrice de `docs/cellular/matrice-lien-signal.drawio` (D-037). Prototype : aucun cas de l'expert, deux corrections de `DAILY_LINK_STATE` en attente du spécialiste.
|
||||
- **Lecteurs** : la partie 1 s'adresse au client final (elle est affichée dans le bloc Cellular de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight.
|
||||
|
||||
---
|
||||
|
||||
# Partie 1 : lecture rapide
|
||||
|
||||
## 1. Ce que surveille le diagnostic
|
||||
|
||||
La station envoie ses mesures par la 4G, toutes les 15 minutes, soit 96 envois par jour. Chaque jour, le diagnostic répond à une question : **tous les envois de la station sont-ils arrivés ?**
|
||||
|
||||
La réponse est une **couleur par jour**. Le bloc montre aussi la qualité du signal 4G reçu par la station.
|
||||
|
||||
## 2. Les couleurs, et ce qu'il faut faire
|
||||
|
||||
| Couleur | Ce que ça veut dire | Que faire |
|
||||
|---|---|---|
|
||||
| 🟢 **Vert** | Tous les envois sont arrivés. | Rien. |
|
||||
| 🟠 **Orange** | Quelques envois manquent, ou la 4G a été signalée coupée, mais la station a continué à mesurer. | Rien si l'orange est isolé : un envoi perdu suffit à le produire. **Prévenir le support si les oranges se suivent plusieurs jours.** |
|
||||
| 🔴 **Rouge** | La station s'est tue une grande partie de la journée (5 heures ou plus). | **Contacter le support.** Regarder aussi le bloc Energy : une station sans énergie se tait aussi. |
|
||||
| ⚪ **Gris** | Inconnu : journée incomplète (premier jour suivi, jour en cours), ou envois arrivés mais signal mesuré trop peu de temps. | Regarder les jours voisins. |
|
||||
|
||||
- **La couleur du jour peut encore changer** tant que la journée n'est pas terminée (minuit UTC).
|
||||
|
||||
## 3. Ce qu'affiche le bloc
|
||||
|
||||
- **Data sent** : « All data received », le nombre d'envois manquants sur 96, ou « 4G link reported down ».
|
||||
- **Signal** : la qualité du signal sur la journée, sur une échelle à quatre classes : Cell edge (limite de la zone couverte), Mid cell, Good, Excellent. **Le signal ne change pas la couleur** : une station en limite de zone peut tout transmettre. C'est un repère, pas une alerte.
|
||||
|
||||
## 4. Deux exemples réels (2026)
|
||||
|
||||
### WEISSHORN : une station bien couverte
|
||||
|
||||
| Jour | Couleur | Ce qui se passe |
|
||||
|---|---|---|
|
||||
| 20/08 | 🔴 | Fin de la mise en service : 18 heures de silence, 43 envois manquants. |
|
||||
| 22/08, 29/08, 30/08, 01/09, 05/09, 06/09 | 🟠 | Oranges isolés : un à trois envois perdus, la station revient au vert le lendemain. Rien à faire. |
|
||||
| 03/09 | 🟠 | La 4G est signalée coupée une fois, mais les 96 envois sont arrivés. |
|
||||
| 07/09 – 12/10 | 🟢 | Tous les envois arrivent. Signal « Good » tous les jours. |
|
||||
|
||||
### NORDEND : une station en limite de zone
|
||||
|
||||
| Période | Couleur | Ce qui se passe |
|
||||
|---|---|---|
|
||||
| 30/06 – 01/07, 11 – 13/07, 22 – 23/07, 19/08, 22/08 | 🔴 | Coupures de la liaison, de 1 à 23 heures sans envoi. |
|
||||
| 26/08 – 06/09 | 🟠 presque tous les jours | 1 à 5 envois perdus par jour : une série d'oranges, la situation où il faut prévenir le support (cas pas encore confirmé par l'expert). |
|
||||
| le reste | surtout 🟢 | Signal « Cell edge » presque tous les jours, et pourtant 76 jours sur 109 tous les envois arrivent. |
|
||||
|
||||
---
|
||||
|
||||
# Partie 2 : annexe technique (support)
|
||||
|
||||
La couleur du jour combine deux analyses des messages du modem : `link` et `last_sync` (deux messages par envoi), et les mesures radio `rsrp_dBm` et `rsrq_dB` (moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : `docs/cellular/analyses/daily_link_state.md` et `docs/cellular/analyses/daily_signal_state.md`. Une couleur conclut au plus `consistent with` : elle signale une journée à regarder.
|
||||
|
||||
## 5. Les deux analyses
|
||||
|
||||
- **`DAILY_LINK_STATE`** : envois attendus = 4 par heure × 24 (cadence **observée**, non documentée). Par heure, un envoi est arrivé si l'un de ses deux messages est arrivé. L'état se lit dans cet ordre :
|
||||
1. jour incomplet dans l'export, ou début d'historique : inconnu ;
|
||||
2. au moins un échantillon `link = down` : `DOWN` ;
|
||||
3. un envoi entier ou un message manquant : `MISSING` (la cause n'est pas établie : lien, énergie, serveur) ;
|
||||
4. sinon : `UP`.
|
||||
- **`DAILY_SIGNAL_STATE`** : médianes du jour du RSRP et du RSRQ, classées sur une grille publiée (attribuée au modem Quectel BG96 par KORE Wireless, identique au wiki Teltonika) : `EXCELLENT` ≥ −80 dBm / −10 dB, `GOOD` ≥ −90 / −15, `MID_CELL` ≥ −100 / −20, sinon `CELL_EDGE`. Le jour prend la pire des deux classes. Moins de 20 heures mesurées sur 24 : inconnu.
|
||||
|
||||
## 6. La matrice : du lien et du signal à la couleur
|
||||
|
||||
| Lien \ Signal | mesuré (toute classe) | inconnu (< 20 h) |
|
||||
|---|---|---|
|
||||
| `UP` | 🟢 | ⚪ |
|
||||
| `MISSING` | 🟠 | 🔴 |
|
||||
| `DOWN` | 🟠 | 🔴 |
|
||||
| inconnu | ⚪ | ⚪ |
|
||||
|
||||
- **Rouge** : des envois manquent et le signal n'est pas mesuré 20 heures sur 24, donc la station s'est tue 5 heures ou plus. Ce critère reprend `MIN_COVERAGE`, sans nouveau seuil : sur NORDEND, il retient 9 des 11 coupures lourdes, et aucun des petits manques (D-037).
|
||||
- **Pourquoi le signal ne change pas la couleur** : avec `UP` × `CELL_EDGE` en orange, NORDEND serait notifiée 76 jours sur 109 alors que tous ses envois sont arrivés.
|
||||
- **Totaux** : WEISSHORN (09/08 au 13/10/2026), 46 jours 🟢, 7 🟠, 1 🔴, 12 ⚪ ; NORDEND (26/06 au 13/10/2026), 76 🟢, 20 🟠, 9 🔴, 5 ⚪.
|
||||
|
||||
## 7. Lire la figure
|
||||
|
||||
`python3 src/cellular/final.py` écrit `out/<STATION>_cellular_daily.html` et sa figure en JSON (`.json`, pour `Plotly.newPlot`). C'est l'historique complet du bloc Cellular. La page de comparaison (`python3 src/cellular/all_analyses.py`, `out/<STATION>_cellular.html`) reprend les mêmes panneaux, avec les séries du modem et les envois reçus par heure dessous.
|
||||
|
||||
- **Panneau `DAILY_LINK_STATE`** : `sends received` en % des envois attendus, l'état en marqueurs (● vert `UP`, ◆ jaune `MISSING`, ✕ violet `DOWN`).
|
||||
- **Panneaux `DAILY_SIGNAL_STATE`** (RSRP en dBm, puis RSRQ en dB) : la `daily median`, les planchers de la grille en tirets, la classe en marqueurs.
|
||||
- **Survol** : tous les faits calculés du jour (envois reçus et manquants, échantillons `up` et `down`, médianes, couverture).
|
||||
- **Attention aux couleurs** : celles des panneaux distinguent les états et les classes, ce ne sont pas celles de la matrice.
|
||||
|
||||
## 8. Limites à connaître
|
||||
|
||||
1. **Aucun cas de l'expert** : les questions sont dans `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
2. **Cadence supposée de 15 minutes** sur toutes les stations : une station réglée autrement serait orange tous les jours.
|
||||
3. **Pas de croisement avec Energy** : une coupure d'énergie fait aussi manquer les envois, et donne un rouge Cellular.
|
||||
4. **Comptage par heure** : un envoi décalé d'une seconde change d'heure (NORDEND, 15/07 : orange à tort). Deux corrections sont retenues sur le principe mais non codées, en attente du spécialiste.
|
||||
5. **Un seul `down` suffit** : un état fugitif du modem colore la journée en orange (WEISSHORN, 03/09).
|
||||
6. **Grille du signal d'un autre modem**, présentée comme indicative : NORDEND est `CELL_EDGE` presque tous les jours et transmet presque tout.
|
||||
7. **Versions plus anciennes du collecteur** (NORDEND) : sans `link`, ni `DOWN` ni messages perdus ; seuls les envois entiers manquants se voient.
|
||||
+84
-4
@@ -207,7 +207,7 @@ Règles du journal :
|
||||
- le format d'intégration côté site (JSON, fragment HTML ou backend Python) reste à choisir avec l'équipe du site.
|
||||
|
||||
## D-022 — 2026-10-12 — Maquettes de page en HTML ; Figma seulement sur demande
|
||||
- **Statut** : active.
|
||||
- **Statut** : active, remplacée en partie par D-039 (maquettes multi-domaines, une vue client par station).
|
||||
- **Décision** : les maquettes de page (ex. « System Summary » du site de monitoring) sont des pages HTML générées à partir des données réelles, dans `maquettes/`. Un fichier Figma n'est produit que sur demande (designer, passation à l'équipe du site), à partir d'une maquette stable.
|
||||
- **Pourquoi** : choix de l'utilisateur, sur recommandation. Le HTML s'itère plus vite (rendu et vérification en local), garde les données réelles et vivantes (calcul par `src/`), permet l'interaction (survol traçable, zoom), utilise la technologie du livrable (HTML Plotly) et se versionne.
|
||||
- **Options écartées** : Figma comme référence. Chaque modification y passe par l'API Plugin, et le graphique n'y est qu'une image vectorielle figée, sans survol ni zoom. Un premier fichier, produit puis non maintenu, reste dans les brouillons Figma de l'utilisateur : https://www.figma.com/design/S16eZ7PoAAutFJWcyqAHSm.
|
||||
@@ -244,7 +244,7 @@ Règles du journal :
|
||||
- un jour en cours, ou le dernier jour d'un export, est signalé « provisional » : la couleur peut encore changer jusqu'à minuit UTC.
|
||||
|
||||
## D-025 — 2026-10-12 — Maquette support « Home » : section Status et lien vers la vue client
|
||||
- **Statut** : active. Complète D-022.
|
||||
- **Statut** : active, remplacée en partie par D-039 (maquettes multi-domaines, une vue client par station). Complète D-022.
|
||||
- **Décision** :
|
||||
- côté support, la maquette reprend la page d'accueil du site (une vignette par station : nom, dernière tension, courbe) et place en haut une section « Status » : une notification par station dont le dernier jour de la fenêtre est Orange ou Red (`src/day_color.py`), la plus grave d'abord. Green ne notifie rien ;
|
||||
- une notification donne la couleur, la station, le domaine (Energy), le jour, la phrase de la vue client, et un lien « Open <station> » vers la vue client de la station (son menu principal, `out/maquette_user_energy.html`). La vignette de la station mène au même endroit ;
|
||||
@@ -377,9 +377,9 @@ Règles du journal :
|
||||
- **Conséquence** : sur WEISSHORN, 52 jours Green et 14 gris (début d'historique jusqu'au 22/08, moins de 4 rythmes dans la fenêtre). Au rythme actuel, la station passerait Orange vers le 09/12 et Red vers le 17/01 (`CRITICAL`). La livraison (étape 7 : figure du site, maquettes, guide, passage des maquettes à une liste de domaines) se fera dans une autre conversation.
|
||||
|
||||
## D-036 — 2026-10-13 — Pas de domaine Températures pour l'instant
|
||||
- **Statut** : active. Le domaine candidat « surchauffe » (`sensor_*_deg_c`) n'est pas créé (D-030).
|
||||
- **Statut** : remplacée par D-040 (2026-10-13) : le domaine `temperature` est créé, sur la limite du GPU donnée par le constructeur. La comparaison au passé reste écartée.
|
||||
- **Décision** :
|
||||
- pas de domaine ni d'analyse de température pour l'instant ; l'exploration de VERMONT, WEISSHORN et NORDEND est rangée dans `docs/domaine/temperatures-de-la-station.md`, avec ses pistes et les questions pour le spécialiste ;
|
||||
- pas de domaine ni d'analyse de température pour l'instant ; l'exploration de VERMONT, WEISSHORN et NORDEND est rangée dans `docs/domaine/temperatures-de-la-station.md` (devenue `docs/temperature/domaine/point-de-depart.md`, D-040), avec ses pistes et les questions pour le spécialiste ;
|
||||
- la température reste une preuve d'appoint pour Energy (signature d'une coupure, `docs/domaine/pieges-des-donnees.md`), à combiner avec la tension, pas codée.
|
||||
- **Pourquoi** : choix de l'utilisateur, sur proposition. Aucun épisode de chaleur dans les données (maximum 62,7 °C, NORDEND, le 13/08), aucun seuil du matériel ni de la documentation AIMsight, aucun cas de l'expert : un verdict serait vert tous les jours, ou rouge sur un seuil inventé.
|
||||
- **Options écartées** : un domaine surchauffe comparant la station à son propre passé (il signalerait les jours d'été chauds, pas un défaut) ; l'amplitude du jour comme indice d'ensoleillement pour Energy (corrélation avec la tension maximale du jour de −0,03 à 0,32) ; la température au retour d'un trou comme preuve seule d'une coupure (le trou commun du 19/08 revient aussi ~7 °C sous l'habitude).
|
||||
@@ -394,3 +394,83 @@ Règles du journal :
|
||||
- **Pourquoi** : choix de l'utilisateur, sur proposition. Le Red reprend `MIN_COVERAGE`, déjà sourcé, sans nouveau seuil : sur NORDEND, il retient 9 des 11 jours de coupure lourde (23 à 95 envois manquants), et aucun des petits manques (1 à 5 envois).
|
||||
- **Options écartées** : `UP` × `CELL_EDGE` en Orange (NORDEND déclencherait une notification 76 jours sur 109 alors que tous ses envois sont arrivés ; la grille ne sépare pas ses bons jours des mauvais, fiche `daily_signal_state`) ; `DOWN` en Red dès un échantillon (le `down` fugitif du 03/09 sur WEISSHORN, les 96 envois arrivés) ; un nombre d'envois manquants comme seuil du Red (pas de source, pas de cas de l'expert).
|
||||
- **Conséquence** : WEISSHORN, 46 jours Green, 7 Orange, 1 Red (20/08, fin de la mise en service), 12 gris ; NORDEND, 76 Green, 20 Orange, 9 Red, 5 gris. Tant que le signal est connu, sa classe ne change pas la couleur. Restent hors de la matrice : le croisement avec Energy, les deux corrections de `DAILY_LINK_STATE` (le 15/07 de NORDEND repasserait Green) et les seuils du signal, en attente du spécialiste.
|
||||
|
||||
## D-038 — 2026-10-13 — Dev container : Docker Engine dans WSL, réseau de l'hôte
|
||||
- **Statut** : active. Prépare la communication avec la caméra (API REST, interface web, RTSP, FTP, MQTT ; manuel de la station, « Access Modes » et « Network Settings »).
|
||||
- **Décision** :
|
||||
- `.devcontainer/devcontainer.json` : image `mcr.microsoft.com/devcontainers/python:3.14` (la version de `.venv`), plotly installé à la création, `--network=host` ;
|
||||
- Docker Engine installé dans WSL (script de commodité, dépôt `apt` de Docker), pas Docker Desktop ;
|
||||
- le réseau de WSL reste en mode `mirrored` (`.wslconfig`) : WSL, donc le conteneur, voit les interfaces de Windows, dont le lien Ethernet direct vers la caméra (`192.168.1.2` par défaut).
|
||||
- **Pourquoi** : choix de l'utilisateur, sur proposition. Le réseau de l'hôte évite de publier un port pour ce que la caméra envoie au poste (FTP, MQTT) ; Docker Engine est le chemin le plus direct vers ce réseau, sans licence.
|
||||
- **Options écartées** : Docker Desktop for Windows (conteneurs dans sa propre distribution WSL, réseau de l'hôte à activer à part, licence payante au-delà d'une certaine taille d'entreprise) ; Docker Desktop for Linux (fait pour un Linux natif, pas pour WSL) ; le réseau `bridge` (suffit pour joindre la caméra, pas pour en recevoir).
|
||||
- **Conséquence** : vérifié le 2026-10-13 (Docker 29.9.0, Python 3.14.8) : `all_analyses.py` et `final.py` tournent sur VERMONT dans le conteneur ; dans le conteneur, les pages ne s'ouvrent pas seules (pas de navigateur), elles restent dans `out/`. À reprendre quand on connaîtra la version de Python et l'architecture de la station (imiter la station), et la doc de l'API REST (dans l'interface web de la caméra). Le jeton d'API reste hors du dépôt ; les échanges avec la caméra restent en lecture seule.
|
||||
|
||||
## D-039 — 2026-10-13 — Livraison de Storage et Cellular : maquettes multi-domaines, figures du site, guides
|
||||
- **Statut** : active. Étape 7 de `nouveau-domaine` pour Storage (D-035) et Cellular (D-037) ; remplace en partie D-022 (script et page de la vue client) et D-025 (VERMONT seule, domaine Energy seul) ; applique le passage multi-domaines prévu par D-030.
|
||||
- **Décision** :
|
||||
- **vue client** : `maquettes/user/energy.py` devient `maquettes/user/summary.py` (gabarit `summary_template.html`), qui écrit une page System Summary par station de `data/` : `out/maquette_user_<STATION>.html`. La section Diagnostic a un bloc par domaine dont la station a les mesures (VERMONT : Energy ; WEISSHORN : Energy, Storage, Cellular ; NORDEND : Energy, Cellular), les autres sont masqués ;
|
||||
- chaque bloc garde la forme d'Energy (D-022) : couleur du dernier jour, phrase, deux lignes en mots simples, dérouleurs « Full history » (figure du site du domaine) et « Guide » (partie 1 du guide du domaine). Storage : échelle de l'espace libre (Critical < 10 %, Low < 20 %, OK, planchers de D-034) et date de saturation (« Full around <date> (about N months) ») ; Cellular : envois du jour en mots (« All data received », « N of 96 sends missing », « 4G link reported down ») et échelle du signal en quatre classes, sans dBm, le trait au milieu de la classe du jour ;
|
||||
- pas de bouton d'action pour Storage ni Cellular : aucun remède connu (purge, antenne), à revoir avec l'expert ;
|
||||
- **vue support** : `maquettes/support/home.py` charge toutes les stations de `data/` et parcourt `DOMAINS = {"Energy", "Storage", "Cellular"}` : une notification par station et par domaine Orange ou Red, la plus grave d'abord, avec le lien vers la vue client de la station ;
|
||||
- `HEADLINE` de chaque domaine vit dans `src/<domaine>/day_color.py`, avec une phrase Green pour la vue client (Green ne notifie toujours rien). Storage Green : « The station has enough storage space. » ; Cellular Green : « The station sent all its data over 4G. » ;
|
||||
- **figures du site** : `src/storage/final.py` et `src/cellular/final.py`, sur le modèle de `src/energy/final.py` (D-021), écrivent `out/<STATION>_<domaine>_daily.html` + `.json`. Leurs panneaux, en anglais (D-023), sont partagés avec les pages de comparaison ;
|
||||
- **guides** : `docs/storage/guide/diagnostic-stockage.md` et `docs/cellular/guide/diagnostic-cellulaire.md`, en deux couches comme celui d'Energy (D-020), plus courts.
|
||||
- **Pourquoi** : demande de l'utilisateur, qui veut Storage et Cellular dans les maquettes avec le même protocole qu'Energy, et un petit guide par domaine. Choix des blocs validés par l'utilisateur, sur proposition ; la page support réunit déjà toutes les stations, la vue client reste celle d'une station, comme sur le site.
|
||||
- **Options écartées** : une seule vue client, WEISSHORN (VERMONT perdrait son histoire Energy de septembre) ; le bloc Cellular sans le signal (choix de l'utilisateur : les deux analyses, comme Energy) ; le bloc Storage sans échelle.
|
||||
- **Conséquence** :
|
||||
- sur la fenêtre par défaut (18/09-28/09), Storage et Cellular sont Green : la seule notification reste VERMONT Energy Red. La fenêtre `2026-08-12 2026-08-22` montre NORDEND Cellular Red et WEISSHORN Cellular Orange ;
|
||||
- la livraison de Cellular précède les réponses du spécialiste : les deux corrections de `DAILY_LINK_STATE` et les seuils du signal restent en attente (D-037) ;
|
||||
- le tableau des métriques de la vue client écarte les identifiants (`SIM_CCID`, `ip*`) et les métriques texte ;
|
||||
- points ouverts : les guides sont en français dans une page en anglais (comme Energy, D-022) ; le panneau `DAYS_UNTIL_STORAGE_FULL` montre en vue complète le pic de 7 798 jours du 23/08 sur WEISSHORN, qui écrase l'échelle (zoom nécessaire) ; le jour affiché n'est pas encore signalé comme provisoire côté client.
|
||||
|
||||
## D-040 — 2026-10-13 — Domaine Temperature : limite du GPU donnée par le constructeur, sur 24 h
|
||||
- **Statut** : active. Remplace D-036. Étapes 1 à 6 de `nouveau-domaine` ; la figure du site et le guide (étape 7) ne sont pas faits.
|
||||
- **Décision** :
|
||||
- domaine `temperature` (`src/temperature/`, `docs/temperature/`), une analyse : `DAILY_GPU_TEMPERATURE_LIMIT`. Chaque jour UTC, une moyenne horaire de `sensor_GPU_deg_c` a-t-elle atteint 97,5 °C dans les 24 h qui finissent à la dernière heure du jour (la journée entière pour un jour fini, les 24 dernières heures pour le jour en cours) ?
|
||||
- seuil : T.gpu = 97,5 °C, température maximale de fonctionnement du *Jetson Nano Thermal Design Guide* (table 2-1, § 4.3), au-delà de laquelle le module réduit ses performances. Carte supposée : Jetson Nano (zones thermiques du collecteur), à confirmer sur une station ;
|
||||
- couleur du jour (`src/temperature/day_color.py`) : Red si la limite est atteinte, Green sinon, gris sans mesure dans les 24 h. Pas d'orange ni de matrice ;
|
||||
- jeux de travail : WEISSHORN et NORDEND, les seuls avec le GPU. VERMONT (ancien collecteur) n'a pas le domaine ;
|
||||
- la note d'exploration `docs/domaine/temperatures-de-la-station.md` devient `docs/temperature/domaine/point-de-depart.md`.
|
||||
- **Pourquoi** : demande de l'utilisateur, à qui l'on a conseillé de faire tout de même le domaine : très simple, avec un seuil du matériel, pas inventé (ce qui manquait à D-036). La fenêtre de 24 h garde visible un dépassement qu'on aurait manqué en ne regardant qu'au moment où il se produit.
|
||||
- **Options écartées** : comparer la station à son propre passé (D-036) ; un orange dans la marge de ± 3 °C de précision du capteur (simple d'abord, aucun épisode connu) ; le CPU en plus du GPU (T.cpu = 97 °C, le CPU lit jusqu'à 2,5 °C de plus que le GPU : à reprendre après un premier épisode) ; un verdict limité au jour UTC (un dépassement à 23 h disparaîtrait le lendemain).
|
||||
- **Conséquence** : tous les jours mesurés sont Green (maximum 57,2 °C sur NORDEND, 50,9 °C sur WEISSHORN, à plus de 40 °C de la limite). Pas de cas de l'expert : le Red n'a jamais été observé. Les moyennes horaires peuvent cacher un pic bref (fiche, « Limites connues »). Restent la figure du site et le guide.
|
||||
|
||||
## D-041 — 2026-10-13 — Livraison de Temperature : figure du site, maquettes, guide
|
||||
- **Statut** : active. Étape 7 de `nouveau-domaine` pour Temperature ; complète D-040, sur le modèle de D-039.
|
||||
- **Décision** :
|
||||
- `src/temperature/final.py` écrit la figure du site (`out/<STATION>_temperature_daily.html` + `.json`) : le panneau `DAILY_GPU_TEMPERATURE_LIMIT` seul, partagé avec la page de comparaison ;
|
||||
- maquettes : `Temperature` rejoint `DOMAINS` côté support (notification Red) et côté client (bloc sur WEISSHORN et NORDEND ; VERMONT n'a pas le GPU). Le bloc a une seule ligne, en texte : « Hottest (24 h) 43 °C · limit 97.5 °C », la plus haute moyenne horaire des 24 h et la limite du constructeur. Pas de bouton d'action ;
|
||||
- guide `docs/temperature/guide/diagnostic-temperature.md`, en deux couches comme les autres.
|
||||
- **Pourquoi** : demande de l'utilisateur, même méthode que Storage et Cellular. Bloc en texte, choix de l'utilisateur sur proposition : un °C se comprend sans être spécialiste, contrairement à une tension.
|
||||
- **Options écartées** : une échelle de 0 à 110 °C (bornes d'affichage sans source).
|
||||
- **Conséquence** : sur les données reçues, Temperature est Green tous les jours mesurés : aucune notification support. Le panneau place les jours inconnus à 0 °C (marqueur gris), repris tel quel de la page de comparaison.
|
||||
|
||||
## D-042 — 2026-10-13 — Enquête à la demande : un agent qui explique un événement de mesure (exploratoire)
|
||||
- **Statut** : active, exploratoire (`docs/agents/enquete-a-la-demande.md`, rien n'est construit). Complète D-027 sans la remplacer : une approche auxiliaire, plus simple, sur le même cadre.
|
||||
- **Décision** :
|
||||
- pour les données de mesure (déplacements, compensation, références), un agent **enquête à la demande** : une session par question sur un événement, pas une surveillance quotidienne. Il suit le *support query workflow* des docs AIMsight (inventaire, bas de la chaîne d'abord, faits, hypothèses, **réfutation obligatoire de l'hypothèse principale**, conclusion) ;
|
||||
- **enquêteur avec des outils typés**, en lecture seule, définis par famille de preuves et non par format (sources encore inconnues) : `inventory`, `get_series`, `compare_before_after`, `common_mode`, `get_system_health` (couleurs du jour déjà livrées), `get_image` (si une source existe), et `submit_diagnosis` au format structuré des §14-15 du contexte support. Les outils de calcul renvoient des valeurs, pas des verdicts ;
|
||||
- **destinataire** : le support d'abord (il relit, corrige et envoie le brouillon client), puis le client directement pour les classes sans enjeu pour l'ouvrage ;
|
||||
- **déclenchement** : le support à la main, puis un bouton client sur le site, puis une détection automatique sur des critères tirés des tickets ;
|
||||
- **garde-fous tenus par le code** : chaque preuve cite un appel d'outil du journal de session ; règle d'asymétrie : le brouillon ne dit « sans conséquence pour l'ouvrage » que si l'artefact est au moins `strongly supported` et le mouvement de l'ouvrage réfuté ; budget par enquête ;
|
||||
- une enquête validée par le support devient un cas de la base de cas, chargée dans le prompt tant qu'elle y tient ;
|
||||
- démarrage : (1) harnais sur UC3 avec les données existantes (coupures de NORDEND et WEISSHORN), (2) rejeu d'un cas de déplacement résolu, (3) vrais tickets du support, (4) bouton client, (5) réponse directe, puis détection automatique.
|
||||
- **Pourquoi** : demande de l'utilisateur. Le client voit les données de mesure sans savoir les interpréter ; lors d'un événement, il ne peut pas dire s'il est grave ou anodin, et sollicite le support. Le but est de lui répondre automatiquement, avec preuves. Choix de l'utilisateur sur proposition : support d'abord (asymétrie du risque : une fausse assurance coûte plus qu'une fausse alerte), déclenchement par le support d'abord, approche à outils typés.
|
||||
- **Options écartées** :
|
||||
- dossier de preuves puis un seul appel de rédaction (l'*explainer* de la roadmap) : l'agent ne peut pas creuser ; il reste le premier message, en version réduite ;
|
||||
- bac à sable de code : calculs non relus, risque de seuils inventés, difficile à auditer. Reste un recours ;
|
||||
- réponse directe au client et détection automatique dès le départ ;
|
||||
- l'agent qui extrait station, instant et points du texte du client, tant que le support lance l'enquête ;
|
||||
- recherche de cas (RAG) tant que les cas tiennent dans le prompt.
|
||||
- **Conséquence** : même cadre que D-027 (harnais maison, *Tool Runner*, dossier déclaratif sous `agents/`, proposé). Coût estimé ~1 $ par enquête, à mesurer à l'étape 1. Prérequis : une clé API Anthropic ; pour l'étape 2, un export de déplacements avec un événement expliqué. Questions ouvertes (sources, liste des classifications, seuils des outils, critère d'ouverture au client) : §9 du document.
|
||||
|
||||
## D-043 — 2026-10-13 — Energy : cas particulier de la station sur secteur (`DAILY_POWER_SOURCE`)
|
||||
- **Statut** : active. Complète D-020 (couleur du jour) et D-021 (figure du site) ; précise D-009 pour cette analyse. Analyse renommée `DAILY_POWER_SOURCE` (ex-`DAILY_MAINS_POWER`) le jour même, choix de l'utilisateur.
|
||||
- **Décision** :
|
||||
- une nouvelle analyse, `DAILY_POWER_SOURCE`, déduit chaque jour si la station est sur secteur : moyenne de `BusVoltage` sur les 3 jours avant J ≥ 14,0 V (demande de l'utilisateur : moyenne glissante sur 3 jours, batterie toujours pleine) ;
|
||||
- **sur secteur, la perte du secteur décide de la couleur, sans la matrice** : rouge dès qu'une heure de J passe sous 13,4 V, vert sinon. Hors secteur (ou statut inconnu), la matrice état × tendance s'applique, inchangée. Le drawio de la matrice a les deux cas ;
|
||||
- la notification du support et l'en-tête du bloc Energy de la vue client affichent le statut : `On mains`, `Not on mains` ou `Mains unknown` ; la figure du site a un troisième panneau, sous l'état et la tendance ;
|
||||
- vérification sur les stations secteur réelles : WEISSHORN et NORDEND (`data/`), et FLORIDA et MISSISSIPPI relues depuis l'historique git sans revenir dans `data/` (D-033).
|
||||
- **Pourquoi** : demande de l'utilisateur. Sur secteur, la batterie sert d'UPS et reste pleine : la matrice lit le jour de la perte `FULL_CHARGE` (vert) et ne passe au rouge que 29 à 40 h plus tard (MISSISSIPPI), alors qu'une batterie de 7 Ah tient ~15 h. La règle secteur donne le rouge 1 à 2 h après la perte.
|
||||
- **Options écartées** : perte = une heure sous 14,0 V (WEISSHORN aurait été rouge 31 jours sur 52 sans coupure, ses moyennes horaires descendent à 13,9 V, celles de NORDEND à 13,65 V) ; une fenêtre qui inclut l'heure courante (la coupure ferait perdre le statut en ~12 h) ; un statut collant pendant la coupure (reporté, fiche « Pistes »).
|
||||
- **Conséquence** : `day_color.run()` fusionne les faits des trois analyses (`power`, `hours_lost` en plus) ; `focus_jour.py` cite la règle secteur quand elle a décidé ; limites dans la fiche `docs/energy/analyses/daily_power_source.md`, dont 3 jours sans statut après chaque coupure.
|
||||
@@ -18,7 +18,7 @@ La source est le collecteur embarqué `docs/aimsight/collecteur_system_info.py`
|
||||
| `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 de la carte de calcul (A0, CPU, GPU, PLL, thermal selon la version du collecteur ; `temperatures-de-la-station.md`) |
|
||||
| `sensor_*_deg_c` | °C | températures de la carte de calcul (A0, CPU, GPU, PLL, thermal selon la version du collecteur ; `docs/temperature/domaine/point-de-depart.md`) |
|
||||
|
||||
- **`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.
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
- **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. Seule, elle ne tranche pas : le trou commun du 19/08 revient aussi ~7 °C sous l'habitude, et une coupure revenue après le lever du soleil ne montre pas d'écart (`temperatures-de-la-station.md`).
|
||||
- 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. Seule, elle ne tranche pas : le trou commun du 19/08 revient aussi ~7 °C sous l'habitude, et une coupure revenue après le lever du soleil ne montre pas d'écart (`docs/temperature/domaine/point-de-depart.md`).
|
||||
- **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.
|
||||
- **La fin de nuit porte le bilan de la veille** : le minimum du matin du jour d vient avant la charge de d. Il résulte de la charge de d−1 et de la nuit qui suit. Pour juger la charge d'un jour, il faut lire la fin de nuit du lendemain. Exemple sur VERMONT : le 2026-04-12 est ensoleillé (`FULL_CHARGE`), mais sa fin de nuit du matin, 12,96 V, est en baisse de 0,19 V, car le 11/04 était nuageux. La fin de nuit qui suit le 12/04 remonte à 13,12 V.
|
||||
|
||||
@@ -98,7 +98,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
3. **Résolution horaire** : une absorption de moins d'une heure peut donner une moyenne sous 14,0 V, et le jour est alors lu `PARTIAL_CHARGE`. Exemple : le 2026-09-08, maximum 13,96 V.
|
||||
4. **`PARTIAL_CHARGE` n'est pas une anomalie** : 31 jours sur 184, dont des jours sains nuageux. C'est la répétition qui comptera en phase B.
|
||||
5. **Batterie de 7 Ah** : avec ~22 % de charge au matin (note de domaine), une station saine de 7 Ah à 5 W pourrait passer sous 12,8 V chaque nuit, et être lue `BELOW_PLATEAU` tous les jours. Ce n'est pas faux (la batterie quitte bien le plateau), mais c'est à vérifier sur une telle station. JUNGFRAU, station saine, a des nuits à 12,9 V : marge de 0,1 V.
|
||||
6. **Secteur** : la tension reste vers 14,2–14,4 V, donc chaque jour est lu `FULL_CHARGE`. Après une perte secteur, le jour suivant devrait être lu `NO_CHARGE` ou `BELOW_PLATEAU`. Ce n'est pas vérifiable sur le jeu de travail, qui est solaire.
|
||||
6. **Secteur** : la tension reste vers 14,2–14,4 V, donc chaque jour est lu `FULL_CHARGE`, le jour de la perte compris. Après une perte secteur, le jour suivant est lu `NO_CHARGE` ou `BELOW_PLATEAU`. Couverte par `DAILY_POWER_SOURCE` (2026-10-13, D-043) : sur secteur, la perte décide de la couleur dès la première heure sous 13,4 V.
|
||||
7. **Froid** : aucune donnée d'hiver. La charge LiFePO4 est en général bloquée sous 0 °C, d'où des jours `PARTIAL_CHARGE` ou `NO_CHARGE` possibles, même au soleil.
|
||||
8. **Ambiguïté de `anomaly = None`** en phase C (voir « Principe »).
|
||||
|
||||
|
||||
@@ -0,0 +1,104 @@
|
||||
# `DAILY_POWER_SOURCE` : sur secteur ou non, et perte du secteur
|
||||
|
||||
- **Statut** : prototype en place (2026-10-13), dans la couleur du jour (D-043).
|
||||
- **Script** : troisième panneau de `python3 src/energy/final.py [CSV ou dossiers]` (figure du site, D-021) et cinquième de `python3 src/energy/all_analyses.py` (comparaison, D-016) ; défaut `data/VERMONT/` (solaire), lancer sur `data/WEISSHORN data/NORDEND` pour voir des stations secteur.
|
||||
- **Code** : `src/energy/power_source.py` (calcul, bibliothèque standard, importe seulement `battery_state` pour ses constantes) ; `src/energy/day_color.py` l'applique ; panneau `power_source_panel()` dans `src/energy/final.py`.
|
||||
|
||||
## Question posée
|
||||
|
||||
La station est-elle sur secteur ? Si oui, a-t-elle perdu le secteur ce jour-là ?
|
||||
|
||||
- **Lien avec D-004** : sur secteur, la batterie reste pleine et sert d'UPS. Une station qui perd le secteur est en anomalie dès la première heure, même batterie pleine : elle tombera en 15 h (7 Ah) à 46 h (21 Ah) à 5 W.
|
||||
- **Ce que l'analyse ajoute** : la matrice état × tendance lit le jour de la perte `FULL_CHARGE` (les heures d'avant la perte sont à 14,2 V), donc vert. Elle ne passe au rouge que le lendemain, une fois 20 h mesurées (`NO_CHARGE`) ou le coude franchi (`BELOW_PLATEAU`) : 29 à 40 h après la perte sur MISSISSIPPI. Sur secteur, une heure sans chargeur suffit.
|
||||
|
||||
## Principe
|
||||
|
||||
Le statut vient des 3 jours qui précèdent J : une moyenne au niveau de la pleine charge veut dire qu'il n'y a pas de nuit, donc un chargeur toujours présent. Sur secteur, J est rouge dès qu'une heure tombe sous le haut du plateau.
|
||||
|
||||
Calcul exact, pour chaque jour UTC J ayant au moins une ligne `BusVoltage` :
|
||||
1. Heures mesurées : valeurs non vides et finies, comme `DAILY_BATTERY_STATE`.
|
||||
2. Fenêtre : les heures mesurées de J−3, J−2 et J−1 (72 h, J exclu). `coverage_3_days` = heures mesurées / 72 ; `mean_3_days_v` = leur moyenne.
|
||||
3. `power` :
|
||||
- `None` (UNKNOWN) si `coverage_3_days` < `MIN_COVERAGE` ;
|
||||
- `MAINS` si `mean_3_days_v` ≥ `MAINS_MEAN_V` ;
|
||||
- `NOT_MAINS` sinon.
|
||||
4. `hours_lost` = nombre d'heures mesurées de J sous `MAINS_LOST_V`, seulement si `power = MAINS` et que J a une mesure ; `None` sinon.
|
||||
5. `min_v` = minimum de J (le même que `DAILY_BATTERY_STATE`).
|
||||
|
||||
**Pourquoi J est exclu de la fenêtre** : sinon la coupure qu'on veut signaler ferait baisser la moyenne, et la station repasserait `NOT_MAINS` une douzaine d'heures après la perte (MISSISSIPPI : 14,2 → 13,1 V, soit −0,015 V par heure sur la moyenne). Le statut est ainsi fixe pour toute la journée.
|
||||
|
||||
**Couleur du jour** (`day_color.py`, `docs/energy/matrice-etat-tendance.drawio`) :
|
||||
- `MAINS` : `RED` si `hours_lost` > 0, `GREEN` si `hours_lost` = 0, `None` si J n'a pas de mesure ;
|
||||
- `NOT_MAINS` ou `None` : la matrice état × tendance, inchangée.
|
||||
|
||||
Sortie (contrat commun) : un point par jour, les mêmes jours que `DAILY_BATTERY_STATE`.
|
||||
- `t` = dernière heure du jour présente dans la série.
|
||||
- `value` = `mean_3_days_v`, en V (`None` sans mesure dans la fenêtre).
|
||||
- `anomaly` = `None` : pas de verdict, comme `DAILY_BATTERY_STATE` ; la couleur est dans `day_color`.
|
||||
- `facts` = `{power, mean_3_days_v, coverage_3_days, min_v, hours_lost}`.
|
||||
|
||||
**Causalité** : J n'utilise que J−3 à J−1 (statut) et les heures de J (perte). En cours de journée, `hours_lost` ne peut que monter : un rouge ne redevient pas vert avant minuit.
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| `WINDOW_DAYS` | 3 jours | Demande de l'utilisateur (moyenne glissante sur les 3 derniers jours), le 2026-10-13. |
|
||||
| `MAINS_MEAN_V` | 14,0 V | `FULL_CHARGE_V` de `DAILY_BATTERY_STATE`. Moyenne sur 3 jours : VERMONT (solaire) 12,77 à 13,50 V sur 173 jours ; secteur hors coupure ≥ 14,08 V (WEISSHORN 14,09–14,19, NORDEND 14,08–14,16, FLORIDA 14,20–14,28, MISSISSIPPI jusqu'à 14,24). |
|
||||
| `MAINS_LOST_V` | 13,4 V | Haut du plateau de la table OCV du collecteur (12,9–13,4 V = 40–90 %, `docs/aimsight/collecteur_system_info.py`) : en dessous, le chargeur ne tient plus la batterie. Données : sur secteur, l'heure la plus basse sans coupure est à 13,65 V (NORDEND, 27/09 22:00 ; WEISSHORN 13,91 V). La première heure pleine sans secteur est entre 13,11 et 13,30 V (MISSISSIPPI, 10 coupures) ; l'heure où survient la perte, partielle, peut rester au-dessus (13,69, 13,86, 13,88 V), d'où le délai de 1 à 2 h. |
|
||||
| `MIN_COVERAGE` | 0,8 | Repris de `DAILY_BATTERY_STATE` : 58 h mesurées sur 72. |
|
||||
|
||||
## Graphique
|
||||
|
||||
- **Place** : troisième panneau de la figure du site, sous l'état et la tendance (D-021, D-043), et cinquième panneau de la page de comparaison.
|
||||
- **Contenu**, sur un axe en volts, un point par jour à midi UTC (D-019) :
|
||||
- la moyenne des 3 jours avant J (courbe foncée) et le minimum de J (courbe claire) ;
|
||||
- les seuils de 14,0 V (bleu) et 13,4 V (rouge) en tirets, tracés comme des courbes pour rester visibles au zoom (D-013) ;
|
||||
- le statut en marqueurs sur la moyenne : ● bleu `on mains`, ○ gris `not on mains` ;
|
||||
- la perte du secteur en ✕ rouge sur le minimum (`mains lost`).
|
||||
- **Survol** : le statut et les faits du jour.
|
||||
|
||||
## Résultats
|
||||
|
||||
VERMONT (solaire) est le jeu de travail d'Energy (D-009), mais il ne contient pas de secteur. WEISSHORN et NORDEND (dans `data/`) sont sur secteur : 14,1–14,2 V jour et nuit. FLORIDA et MISSISSIPPI, les deux stations secteur des cas experts, ont été retirées du dépôt (D-033). Elles se relisent depuis l'historique git, sans revenir dans `data/` : `git show "128d4bc:data/archive/MISSISSIPPI_BusVoltage_2025_10_18_14_00 to 2026_10_09_14_00.csv"` (de même pour `FLORIDA_BusVoltage_2026_04_13_14_00 to 2026_10_09_14_00.csv`).
|
||||
|
||||
| Station | Alimentation (expert) | Statut | Couleur, changements face à la matrice seule |
|
||||
|---|---|---|---|
|
||||
| VERMONT | solaire | 173 j `NOT_MAINS`, 11 j inconnus (début, coupures) | aucun : 138 🟢, 31 🟠, 14 🔴, 1 gris |
|
||||
| WEISSHORN | non annotée (secteur d'après la tension) | 52 j `MAINS`, 14 inconnus (mise en service) | aucun : tous les jours `MAINS` sont 🟢 |
|
||||
| NORDEND | non annotée (secteur d'après la tension) | 97 j `MAINS`, 13 inconnus (trous de juin–juillet) | aucun : tous les jours `MAINS` sont 🟢 |
|
||||
| FLORIDA | secteur, sain | 175 j `MAINS` | 1 jour 🟢 → 🔴 : le 10/07, 2 h à 13,06 puis 13,02 V |
|
||||
| MISSISSIPPI | coupures secteur | 160 j `MAINS`, 19 `NOT_MAINS`, 178 inconnus (station éteinte de janvier à mai) | 7 jours 🟢 → 🔴 (08/12, 23/12, 05/06, 02/08, 03/08, 15/08, 05/10) ; 10 jours 🔴 sur secteur en tout |
|
||||
|
||||
- **Délai de détection** (rejeu causal heure par heure, MISSISSIPPI) : rouge 1 à 2 h après la dernière heure à 14 V, contre 29 à 40 h avec la matrice seule (08/12 : 2 h contre 40 h ; 23/12 : 2 h contre 39 h ; 05/06, 15/08, 05/10 : 2 h contre 30 à 33 h). Le 02/08, la matrice ne voyait rien du tout : le secteur, perdu vers 16:00, est revenu le 03/08 vers 02:00, avant que l'état ne descende.
|
||||
- **Coupures non vues par la règle secteur** (statut `NOT_MAINS` ou inconnu ce jour-là) : 19/10/2025 (début de l'historique, fenêtre incomplète : la matrice la voit à +28 h), 11/12/2025 et 07/10/2026 (une deuxième coupure dans les 3 jours qui suivent la précédente, voir « Limites » ; la matrice ne les voit pas non plus dans les 72 h).
|
||||
- **FLORIDA, 10/07** : l'expert juge la station saine, mais note cette baisse à 13,0 V pendant 2 h. Sur secteur, c'est la signature d'une courte perte du secteur : le rouge est cohérent avec la règle, à confirmer avec l'expert.
|
||||
- **MISSISSIPPI, 17/09/2026** : 13,63 puis 13,50 V pendant 2 h, sans passer sous 13,4 V : vert. Peut-être une perte de moins d'une heure par heure, invisible en moyenne horaire.
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| Perte = une heure sous 14,0 V (`FULL_CHARGE_V`), la lecture directe de « toujours pleine » | Sur secteur, les moyennes horaires descendent souvent sous 14,0 V sans coupure : WEISSHORN aurait été rouge 31 jours sur 52 sur secteur, NORDEND 92 sur 97 (creux jusqu'à 13,65 V). |
|
||||
| Statut = toutes les heures des 3 jours ≥ 14,0 V | Même raison : WEISSHORN n'aurait été `MAINS` que par séries de 3 jours au plus. La moyenne absorbe ces creux. |
|
||||
| Fenêtre glissante de 72 h qui finit à l'heure courante | La coupure fait baisser la moyenne : la station repasse `NOT_MAINS` en ~12 h et le rouge disparaît, alors que la coupure continue. |
|
||||
| Un trou de mesure sur secteur compté comme une perte | Sur secteur, la batterie sert d'UPS : une perte se voit d'abord en tension, pas en trou. Un trou n'est pas une coupure (`docs/domaine/pieges-des-donnees.md`). |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. **Après une coupure, 3 jours aveugles** : la fenêtre contient la coupure, la station est `NOT_MAINS` et repasse sur la matrice. Une deuxième coupure dans ces 3 jours n'est vue qu'avec le retard de la matrice (MISSISSIPPI 11/12/2025 et 07/10/2026). La notification affiche alors `Not on mains`, ce qui est vrai pendant la coupure, mais pas pour la raison attendue.
|
||||
2. **Mise en service** : 3 jours complets sont nécessaires avant le premier statut. D'ici là, la matrice s'applique.
|
||||
3. **Pertes de moins d'une heure** : la moyenne horaire peut rester au-dessus de 13,4 V (MISSISSIPPI 17/09/2026, 13,50 V).
|
||||
4. **Chargeur réglé autrement** : un secteur dont le *float* serait sous 14,0 V (13,5–13,8 V en chimie générale) ne serait jamais `MAINS`. Les quatre stations secteur observées tiennent ~14,2 V.
|
||||
5. **Statut déduit, pas déclaré** : l'alimentation réelle de la station n'est pas dans les données (`get_station_meta`, rapport d'agents, n'existe pas encore). `MAINS` est `consistent with` un secteur.
|
||||
|
||||
## Pistes
|
||||
|
||||
- **Statut collant** : garder `MAINS` pendant une coupure en cours (tant que J−1 était `MAINS` et rouge), pour couvrir la limite 1. Change l'articulation : à voir avec le spécialiste avant de le coder.
|
||||
- **Alimentation déclarée** : lire le type d'alimentation dans la configuration de la station quand il sera accessible, et garder la règle comme contrôle.
|
||||
- **Phrase dédiée** : une `HEADLINE` « The station has lost mains power. » pour le rouge sur secteur. Le contrat de notification n'a qu'une phrase par couleur (D-030).
|
||||
|
||||
## Historique
|
||||
|
||||
- **2026-10-13** : créée à la demande de l'utilisateur (cas particulier secteur : batterie toujours pleine, perte à détecter tout de suite ; moyenne glissante sur 3 jours). Les deux seuils viennent des données : 14,0 V pour le statut, 13,4 V et non 14,0 V pour la perte, à cause des creux horaires de WEISSHORN et NORDEND. La couleur du jour, le drawio, le panneau du site et la notification du support l'intègrent (D-043).
|
||||
- **2026-10-13** : statut affiché aussi dans l'en-tête du bloc Energy de la vue client. Renommée `DAILY_POWER_SOURCE` (ex-`DAILY_MAINS_POWER`, `mains_power.py`), choix de l'utilisateur ; calcul inchangé.
|
||||
@@ -94,7 +94,7 @@ Le résumé texte et `out/<STATION>_energy.json` ont été supprimés (D-026) ;
|
||||
- **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.
|
||||
- **Indicateur rapide de perte secteur** : sortie de la tension de maintien. Couvrirait la limite 2. Fait par `DAILY_POWER_SOURCE` (2026-10-13, D-043) : rouge 1 à 2 h après la perte sur MISSISSIPPI.
|
||||
- **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
|
||||
|
||||
@@ -36,6 +36,7 @@ Sources, citées sur chaque chiffre :
|
||||
- **Les jours se répartissent en deux groupes nets** : sur 173 jours d'au moins 20 h mesurées, le maximum du jour est soit entre 13,01 et 13,55 V (35 jours), soit entre 14,02 et 14,33 V (135 jours). Seuls 3 jours tombent entre les deux : 13,59, 13,68 et 13,96 V [V]. Le seuil de 14,0 V sépare donc bien les deux.
|
||||
- **Durée** : un jour ensoleillé tient 14,05 – 14,2 V pendant 5 à 6 h (de 11 à 16 h UTC le 10/06 et le 05/07). Sur les 139 jours pleins, il y a de 3 à 6 h ≥ 14 V dans 124 cas [V].
|
||||
- **Pas de *float* visible en solaire** : à la résolution horaire, aucun palier distinct n'apparaît entre 13,5 et 13,8 V après l'absorption. Les heures de 9 à 16 h se regroupent autour de 13,4 V (charge) et de 14,1 – 14,2 V (absorption), avec un creux entre les deux [V].
|
||||
- **Sur secteur** (WEISSHORN et NORDEND, non annotées par l'expert mais 14,1–14,2 V jour et nuit ; FLORIDA, MISSISSIPPI [E]) : pas de cycle jour/nuit, moyenne sur 3 jours ≥ 14,08 V hors coupure. Les moyennes horaires descendent pourtant sous 14,0 V presque chaque jour, une heure à la fois, jusqu'à 13,65 V (NORDEND, 27/09/2026), sans coupure. Sans secteur, une heure pleine est à 13,1–13,3 V (MISSISSIPPI, 10 coupures). Fiche `DAILY_POWER_SOURCE`.
|
||||
- **Le soir**, la tension retombe vite : à 18 h UTC, elle est entre 13,16 et 13,24 V après un jour plein [V]. Ce retour rapide est connu en LiFePO4 [G].
|
||||
|
||||
## 3. En décharge
|
||||
|
||||
@@ -28,6 +28,7 @@ Une station peut avoir une batterie encore bien chargée et déjà être en diff
|
||||
|
||||
- **Pourquoi 3 jours** : sur la station de référence (VERMONT), en période saine, la plus longue série de jours sans recharge complète est de 3 jours (du 04 au 06/05/2026). Ce seuil reste à confirmer sur d'autres stations.
|
||||
- **La couleur du jour peut encore changer** tant que la journée n'est pas terminée (minuit UTC).
|
||||
- **Station sur secteur** : sa batterie reste toujours pleine. Le diagnostic le reconnaît seul, après 3 jours (« On mains » à côté de la couleur), et passe au rouge dans l'heure ou les deux heures qui suivent une perte du secteur.
|
||||
|
||||
## 3. La flèche : comparaison avec la veille
|
||||
|
||||
@@ -73,11 +74,12 @@ Diagnostic de l'expert : interruptions nocturnes dues à un déficit d'énergie.
|
||||
|
||||
# Partie 2 : annexe technique (support)
|
||||
|
||||
La couleur du jour combine deux analyses de la tension batterie (`BusVoltage`, moyennes horaires) :
|
||||
- l'**état** du jour (`DAILY_BATTERY_STATE`) ;
|
||||
- la **tendance** face à la veille (`DAILY_BATTERY_TREND`).
|
||||
La couleur du jour combine trois analyses de la tension batterie (`BusVoltage`, moyennes horaires) :
|
||||
- l'**alimentation** : sur secteur ou non (`DAILY_POWER_SOURCE`, D-043). Sur secteur, elle décide seule (§ 7, fin) ;
|
||||
- sinon, l'**état** du jour (`DAILY_BATTERY_STATE`) ;
|
||||
- et la **tendance** face à la veille (`DAILY_BATTERY_TREND`).
|
||||
|
||||
Le détail de chaque analyse (calcul exact, sources, résultats, options écartées) est dans sa fiche : `docs/energy/analyses/daily_battery_state.md` et `docs/energy/analyses/daily_battery_trend.md`.
|
||||
Le détail de chaque analyse (calcul exact, sources, résultats, options écartées) est dans sa fiche : `docs/energy/analyses/daily_battery_state.md`, `docs/energy/analyses/daily_battery_trend.md` et `docs/energy/analyses/daily_power_source.md`.
|
||||
|
||||
Une couleur reste une preuve imparfaite : elle conclut au plus `consistent with`. Elle signale une journée à regarder, elle ne remplace pas le diagnostic.
|
||||
|
||||
@@ -145,12 +147,28 @@ Lecture de chaque case, avec le nombre de jours observés sur VERMONT (184 jours
|
||||
- **Jour gris** : l'état ou la tendance est inconnu (moins de 20 h mesurées sans recharge complète ni passage sous le plateau, ou pas de veille). La matrice ne traite pas encore ces cas (D-020, D-021).
|
||||
- **Pourquoi `NO_CHARGE` → est rouge et non orange** : en orange, une coupure d'alimentation passerait du rouge (1er jour, ↘) à l'orange (2e jour, →) alors qu'elle continue. Une batterie assez grande pour rester sur le plateau ne change rien : sans apport, la station tombera (D-004).
|
||||
|
||||
### Station sur secteur (`DAILY_POWER_SOURCE`)
|
||||
|
||||
La matrice ne s'applique qu'aux stations **qui ne sont pas sur secteur** (`NOT_MAINS`, ou statut inconnu). Sur secteur, la batterie reste pleine : chaque jour serait `FULL_CHARGE`, et la perte du secteur ne deviendrait rouge que le lendemain (29 à 40 h de retard sur MISSISSIPPI).
|
||||
|
||||
- **Statut** : `MAINS` si la moyenne de `BusVoltage` sur les 3 jours avant J (72 h, au moins 58 h mesurées) est ≥ 14,0 V. Elle ne dépasse jamais 13,50 V en solaire (VERMONT), et reste ≥ 14,08 V sur secteur hors coupure (WEISSHORN, NORDEND, FLORIDA, MISSISSIPPI). J est exclu, pour que la coupure à signaler ne fasse pas changer le statut.
|
||||
- **Couleur, sur secteur** :
|
||||
|
||||
| Jour J | Couleur | Lecture |
|
||||
|---|---|---|
|
||||
| toutes les heures mesurées ≥ 13,4 V | 🟢 | le chargeur a tenu la batterie toute la journée |
|
||||
| au moins une heure < 13,4 V | 🔴 | `consistent with` une perte du secteur : la batterie seule alimente la station (UPS) |
|
||||
|
||||
- **Pourquoi 13,4 V et pas 14,0 V** : sur secteur, les moyennes horaires descendent souvent sous 14,0 V sans coupure (jusqu'à 13,65 V sur NORDEND). Sans secteur, une heure pleine est à 13,1–13,3 V. 13,4 V est le haut du plateau de la table OCV.
|
||||
- **Délai** : rouge 1 à 2 h après la perte, l'heure de la perte étant souvent partielle.
|
||||
- **La notification du support** et l'en-tête du bloc Energy de la vue client indiquent le statut : `On mains`, `Not on mains` ou `Mains unknown`.
|
||||
|
||||
## 8. Lire les pages HTML
|
||||
|
||||
Commandes : `python3 src/energy/final.py` écrit la page livrée, `python3 src/energy/all_analyses.py` la page de comparaison ; chacune est écrite dans `out/` et ouverte dans le navigateur.
|
||||
|
||||
- `<STATION>_daily.html` : le graphique destiné au site de monitoring (D-021), soit les panneaux `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND` décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (`<STATION>_daily.json`), pour `Plotly.newPlot`.
|
||||
- `<STATION>_energy.html` : la page de comparaison des quatre analyses (`all_analyses.py`), avec ces deux panneaux, et une courbe par mesure dessous.
|
||||
- `<STATION>_daily.html` : le graphique destiné au site de monitoring (D-021), soit les panneaux `DAILY_BATTERY_STATE`, `DAILY_BATTERY_TREND` et `DAILY_POWER_SOURCE` décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (`<STATION>_daily.json`), pour `Plotly.newPlot`.
|
||||
- `<STATION>_energy.html` : la page de comparaison des cinq analyses (`all_analyses.py`), avec ces trois panneaux, et une courbe par mesure dessous.
|
||||
- `<STATION>_focus_<AAAA-MM-JJ>.html` : le focus sur un jour et sa veille (D-024), pour comprendre une couleur. Commande : `python3 src/energy/focus_jour.py 27.09`. Le terminal affiche les faits qui ont produit la couleur ; le graphique montre les 48 h de `BusVoltage`, avec les heures sans mesure en gris, les seuils de 14,0 et 12,8 V, le maximum et la fin de nuit de chaque jour, et une flèche de la fin de nuit de la veille à celle du jour (bleue ↗, grise →, rouge ↘).
|
||||
|
||||
**Attention aux couleurs** : celles des panneaux ne sont pas celles de la matrice. Elles distinguent les états et les tendances ; elles ne disent pas le niveau de préoccupation. Par exemple, `BELOW_PLATEAU` y est en bleu.
|
||||
@@ -166,6 +184,10 @@ Commandes : `python3 src/energy/final.py` écrit la page livrée, `python3 src/e
|
||||
- couleur : bleu ↗, gris →, rouge ↘ ;
|
||||
- tirets : la zone morte de ±0,05 V ;
|
||||
- quand l'état décide, la couleur suit la tendance, même si la barre est petite ou de signe contraire (voir § 6).
|
||||
- **Panneau `DAILY_POWER_SOURCE`**, un point par jour, placé à midi UTC :
|
||||
- courbe foncée : la moyenne des 3 jours avant J ; courbe claire : le minimum du jour ;
|
||||
- tirets : les seuils de 14,0 V (bleu, statut) et de 13,4 V (rouge, perte) ;
|
||||
- marqueurs sur la moyenne : ● bleu `on mains`, ○ gris `not on mains` ; ✕ rouge sur le minimum : `mains lost`.
|
||||
- **Survol** : chaque point et chaque barre affichent les faits calculés du jour (état, tensions, écarts, ce qui a décidé la tendance).
|
||||
- **Dessous** : une courbe par mesure. Sur `BusVoltage`, les bandes grises marquent les heures sans mesure, et les bandes colorées les zones de tension (décharge, en charge, pleine charge).
|
||||
- **Zoom** : dans le temps seulement, au rectangle ou à la molette ; double-clic pour revenir à la vue complète.
|
||||
@@ -177,3 +199,4 @@ Commandes : `python3 src/energy/final.py` écrit la page livrée, `python3 src/e
|
||||
3. **Jours de coupure** : faux ↗ sous le plateau (voir § 7). La couleur reste rouge.
|
||||
4. **Dérive lente** : une baisse de moins de 0,05 V par jour est lue → (VERMONT, 22–24/09, alors que la station s'épuise). La série d'oranges, elle, la signale.
|
||||
5. **Froid** : aucune donnée d'hiver. Sous 0 °C, la charge d'une batterie LiFePO4 est en général bloquée : des jours orange ou rouges sont possibles même au soleil.
|
||||
6. **Après une perte du secteur, 3 jours sans statut `MAINS`** : la coupure est dans la fenêtre, la station repasse sur la matrice. Une deuxième perte dans ces 3 jours n'est vue qu'avec le retard de la matrice (MISSISSIPPI, 11/12/2025).
|
||||
@@ -182,6 +182,64 @@
|
||||
<mxCell id="TGVZEM_AKJCTuzFCSYRQ-4" parent="TGVZEM_AKJCTuzFCSYRQ-1" style="text;strokeColor=none;fillColor=light-dark(#FF0000,#FF0000);fontColor=#ffffff;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;" value="Rouge : non soutenable" vertex="1">
|
||||
<mxGeometry height="30" width="230" y="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-legend" parent="1" style="swimlane;fontStyle=0;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;" value="Alimentation (DAILY_POWER_SOURCE, 3 jours avant J)" vertex="1">
|
||||
<mxGeometry height="90" width="330" x="820" y="200" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-legend-i0" parent="MAINS-legend" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#2a78d6">● MAINS</font> : sur secteur (moyenne des 72 h ≥ 14,0 V)" vertex="1">
|
||||
<mxGeometry height="30" width="330" y="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-legend-i1" parent="MAINS-legend" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#8c8c8c">○ NOT_MAINS</font> : sur batterie (ou statut inconnu)" vertex="1">
|
||||
<mxGeometry height="30" width="330" y="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="NOT-MAINS-title" parent="1" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;whiteSpace=wrap;fontSize=12;" value="<b><font color="#8c8c8c">○ NOT_MAINS</font></b> (sur batterie, ou statut inconnu) : matrice état × tendance" vertex="1">
|
||||
<mxGeometry height="30" width="760" x="40" y="236" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-title" parent="1" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;whiteSpace=wrap;fontSize=12;" value="<b><font color="#2a78d6">● MAINS</font></b> (sur secteur) : la perte du secteur décide, sans la matrice (D-043)" vertex="1">
|
||||
<mxGeometry height="30" width="760" x="40" y="560" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table" parent="1" style="shape=table;startSize=0;container=1;collapsible=0;childLayout=tableLayout;fixedHeader=1;fontColor=#ffffff;strokeColor=light-dark(#FFFFFF,#FFFFFF);" value="" vertex="1">
|
||||
<mxGeometry height="102" width="417" x="40" y="592" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table-r0" parent="MAINS-table" style="shape=tableRow;horizontal=0;startSize=0;swimlaneHead=0;swimlaneBody=0;strokeColor=inherit;collapsible=0;dropTarget=0;fillColor=none;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;fixedHeader=1;" value="" vertex="1">
|
||||
<mxGeometry height="19" width="417" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table-r0-c0" parent="MAINS-table-r0" style="shape=partialRectangle;html=1;whiteSpace=wrap;connectable=0;strokeColor=inherit;overflow=hidden;pointerEvents=1;fontStyle=1;align=center;verticalAlign=middle;fillColor=#f5f5f5;" value="" vertex="1">
|
||||
<mxGeometry height="19" width="75" as="geometry">
|
||||
<mxRectangle height="19" width="75" as="alternateBounds" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table-r0-c1" parent="MAINS-table-r0" style="shape=partialRectangle;html=1;whiteSpace=wrap;connectable=0;strokeColor=inherit;overflow=hidden;pointerEvents=1;fontStyle=1;align=center;verticalAlign=middle;fillColor=#f5f5f5;" value="aucune heure &lt; 13,4 V" vertex="1">
|
||||
<mxGeometry height="19" width="171" x="75" as="geometry">
|
||||
<mxRectangle height="19" width="171" as="alternateBounds" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table-r0-c2" parent="MAINS-table-r0" style="shape=partialRectangle;html=1;whiteSpace=wrap;connectable=0;strokeColor=inherit;overflow=hidden;pointerEvents=1;fontStyle=1;align=center;verticalAlign=middle;fillColor=#f5f5f5;" value="une heure &lt; 13,4 V" vertex="1">
|
||||
<mxGeometry height="19" width="171" x="246" as="geometry">
|
||||
<mxRectangle height="19" width="171" as="alternateBounds" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table-r1" parent="MAINS-table" style="shape=tableRow;horizontal=0;startSize=0;swimlaneHead=0;swimlaneBody=0;strokeColor=inherit;collapsible=0;dropTarget=0;fillColor=none;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;fixedHeader=1;" value="" vertex="1">
|
||||
<mxGeometry height="83" width="417" y="19" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="MAINS-table-r1-c0" parent="MAINS-table-r1" style="shape=partialRectangle;html=1;whiteSpace=wrap;connectable=0;strokeColor=inherit;overflow=hidden;pointerEvents=1;fontStyle=1;align=center;verticalAlign=middle;fillColor=#f5f5f5;" value="<font color="#2a78d6">● MAINS</font>" vertex="1">
|
||||
<mxGeometry height="83" width="75" as="geometry">
|
||||
<mxRectangle height="83" width="75" as="alternateBounds" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<UserObject label="" tooltip="Vert : le secteur a tenu la batterie pleine toute la journée : soutenable ce jour-là.

Sur secteur, toutes les heures mesurées de J ≥ 13,4 V.
Lecture : cas sain d'une station sur secteur.
WEISSHORN : 52 j, NORDEND : 97 j, FLORIDA : 174 j, MISSISSIPPI : 150 j." id="MAINS-table-r1-c1">
|
||||
<mxCell parent="MAINS-table-r1" style="shape=partialRectangle;html=1;whiteSpace=wrap;connectable=0;strokeColor=inherit;overflow=hidden;pointerEvents=1;align=center;verticalAlign=middle;fontStyle=1;spacing=6;fontSize=11;fillColor=light-dark(#33FF33,#33FF33);fontColor=#ffffff;" vertex="1">
|
||||
<mxGeometry height="83" width="171" x="75" as="geometry">
|
||||
<mxRectangle height="83" width="171" as="alternateBounds" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
</UserObject>
|
||||
<UserObject label="" tooltip="Rouge : la station a perdu le secteur : la batterie seule l'alimente (UPS), coupure en 15 à 46 h (D-004).

Sur secteur, au moins une heure mesurée de J < 13,4 V.
Lecture : consistent with une perte du secteur ; rouge 1 à 2 h après la perte, sans attendre J+1 (29 à 40 h avec la matrice).
MISSISSIPPI : 10 j ; FLORIDA : 1 j (10/07, 2 h à 13,0 V)." id="MAINS-table-r1-c2">
|
||||
<mxCell parent="MAINS-table-r1" style="shape=partialRectangle;html=1;whiteSpace=wrap;connectable=0;strokeColor=inherit;overflow=hidden;pointerEvents=1;align=center;verticalAlign=middle;fontStyle=1;spacing=6;fontSize=11;fillColor=light-dark(#FF0000,#FF0000);fontColor=#ffffff;" vertex="1">
|
||||
<mxGeometry height="83" width="171" x="246" as="geometry">
|
||||
<mxRectangle height="83" width="171" as="alternateBounds" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
</UserObject>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
|
||||
@@ -38,6 +38,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
## Graphique
|
||||
|
||||
- **En haut** : `free_percent` jour par jour (ligne), les deux planchers en pointillés, l'état en marqueurs (couleur et symbole). Le survol donne tous les faits.
|
||||
- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/storage/final.py` (historique complet du bloc Storage de la vue client, D-039) ; la page de comparaison l'importe de là.
|
||||
- **Dessous** : `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`, en GiB.
|
||||
|
||||
## Résultats (jeu de travail : WEISSHORN, export de 65 jours)
|
||||
@@ -77,3 +78,4 @@ Sortie (contrat commun) : un point par jour.
|
||||
- **2026-10-13** : création (D-034).
|
||||
- **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours.
|
||||
- **2026-10-13** : combinée à l'autre analyse Storage dans la couleur du jour, matrice état × horizon (`docs/storage/matrice-etat-horizon.drawio`, colonnes ; D-035).
|
||||
- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/storage/final.py` ; livraison du domaine (vue client, notifications, guide `docs/storage/guide/`, D-039).
|
||||
@@ -38,6 +38,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
## Graphique
|
||||
|
||||
- **En haut** : `days_until_full` jour par jour ; le survol donne le rythme, la date estimée et le nombre de rythmes.
|
||||
- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/storage/final.py` (historique complet du bloc Storage de la vue client, D-039) ; la page de comparaison l'importe de là.
|
||||
- **Dessous** : les séries du disque (panneau commun avec `DAILY_STORAGE_STATE`).
|
||||
|
||||
## Résultats (jeu de travail : WEISSHORN, export de 65 jours)
|
||||
@@ -79,3 +80,4 @@ Sortie (contrat commun) : un point par jour.
|
||||
- **2026-10-13** : création (D-034).
|
||||
- **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours.
|
||||
- **2026-10-13** : combinée à l'autre analyse Storage dans la couleur du jour, matrice état × horizon (`docs/storage/matrice-etat-horizon.drawio`, lignes ; D-035).
|
||||
- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/storage/final.py` ; livraison du domaine (vue client, notifications, guide `docs/storage/guide/`, D-039).
|
||||
@@ -0,0 +1,84 @@
|
||||
# Guide : lire le diagnostic de stockage d'une station AIMsight
|
||||
|
||||
- **Statut** : brouillon, 2026-10-13. La couleur du jour est calculée par `src/storage/day_color.py`, selon la matrice de `docs/storage/matrice-etat-horizon.drawio` (D-035). Prototype : seuils arbitraires, une seule station, aucun cas de l'expert.
|
||||
- **Lecteurs** : la partie 1 s'adresse au client final (elle est affichée dans le bloc Storage de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight.
|
||||
|
||||
---
|
||||
|
||||
# Partie 1 : lecture rapide
|
||||
|
||||
## 1. Ce que surveille le diagnostic
|
||||
|
||||
La station enregistre ses mesures sur un disque (la partition `/data`). Chaque jour, le diagnostic répond à une question : **reste-t-il assez de place sur le disque, et pour combien de temps ?**
|
||||
|
||||
La réponse est une **couleur par jour**.
|
||||
|
||||
## 2. Les couleurs, et ce qu'il faut faire
|
||||
|
||||
| Couleur | Ce que ça veut dire | Que faire |
|
||||
|---|---|---|
|
||||
| 🟢 **Vert** | Le disque a assez de place, et il ne sera pas plein avant 2 mois au rythme actuel. | Rien. |
|
||||
| 🟠 **Orange** | La place baisse : moins de 20 % libres, ou disque plein dans moins de 2 mois au rythme actuel. | Surveiller, et prévenir le support : il reste du temps pour intervenir. |
|
||||
| 🔴 **Rouge** | Moins de 10 % libres, ou disque plein dans moins de 14 jours. | **Contacter le support.** |
|
||||
| ⚪ **Gris** | Inconnu : pas de mesure du disque ce jour-là, ou pas encore assez de jours mesurés pour connaître le rythme (il en faut au moins 5). | Regarder les jours voisins. |
|
||||
|
||||
- **Seuils provisoires** : 20 % et 10 % libres, 2 mois et 14 jours sont un premier choix, en attente de l'avis de l'expert.
|
||||
|
||||
## 3. Ce qu'affiche le bloc
|
||||
|
||||
- **Free space** : l'espace libre en fin de journée, en % de l'espace utilisable, placé sur une échelle à trois zones (Critical sous 10 %, Low sous 20 %, OK au-dessus).
|
||||
- **Full** : la date à laquelle le disque sera plein si le rythme des 7 derniers jours continue. C'est une estimation, pas une prévision : un changement de réglage de la station change le rythme. « Not expected » : le disque ne se remplit pas.
|
||||
|
||||
## 4. Un exemple réel (station WEISSHORN, 2026)
|
||||
|
||||
| Période | Couleur | Ce qui se passe |
|
||||
|---|---|---|
|
||||
| 09/08 – 22/08 | ⚪ | Début de l'historique, puis moins d'une semaine de mesures du disque : le rythme n'est pas encore connu. |
|
||||
| 23/08 – 02/09 | 🟢 | Mise en service : disque presque vide, qui ne se remplit pas. |
|
||||
| 31/08 | 🟢 | 1,3 GiB écrits en deux heures : l'espace libre passe de 99,7 % à 76,7 %. L'estimation ne s'affole pas pour un seul bloc. |
|
||||
| 03/09 – 13/10 | 🟢 | Remplissage régulier, 28 MiB par jour. Le 13/10 : 57 % libres, disque plein vers le 06/02/2027. |
|
||||
|
||||
Aucun jour orange ou rouge n'a encore été observé. Au rythme actuel, la station passerait orange vers le 09/12/2026 (plein dans moins de 2 mois), puis rouge vers le 17/01/2027 (moins de 10 % libres).
|
||||
|
||||
---
|
||||
|
||||
# Partie 2 : annexe technique (support)
|
||||
|
||||
La couleur du jour combine deux analyses de l'espace libre de `/data` (`data_storage_free_gb`, `data_storage_used_gb`, moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : `docs/storage/analyses/daily_storage_state.md` et `docs/storage/analyses/days_until_storage_full.md`. Une couleur conclut au plus `consistent with` : elle signale une journée à regarder.
|
||||
|
||||
## 5. Les deux analyses
|
||||
|
||||
- **`DAILY_STORAGE_STATE`** : la dernière mesure du jour. `free_percent` = libre / (libre + utilisé), la réserve de `root` exclue, comme le `percent` de `psutil`. État : `OK` si ≥ 20 %, `LOW` si ≥ 10 %, sinon `CRITICAL` (planchers **arbitraires**, D-034). Une mesure suffit ; sans mesure, l'état est inconnu.
|
||||
- **`DAYS_UNTIL_STORAGE_FULL`** : le rythme du jour est la baisse de l'espace libre depuis la fin de jour mesurée précédente, ramenée à un jour. Le rythme retenu est la médiane des rythmes des 7 derniers jours, s'il y en a au moins 4 ; sinon l'horizon est inconnu. Jours restants = libre / rythme. Un rythme ≤ 0 : le disque ne se remplit pas (`filling = False`). La médiane écarte un bloc isolé (le 31/08 sur WEISSHORN) ou une purge.
|
||||
|
||||
## 6. La matrice : du niveau et de l'horizon à la couleur
|
||||
|
||||
L'horizon est la classe de `DAYS_UNTIL_STORAGE_FULL` : moins de 14 jours, moins de 60 jours, 60 jours ou plus (ou disque qui ne se remplit pas), ou inconnu. Seuils de jours **arbitraires** (D-035).
|
||||
|
||||
| État \ Horizon | ≥ 60 j ou ne se remplit pas | < 60 j | < 14 j | inconnu |
|
||||
|---|---|---|---|---|
|
||||
| `OK` | 🟢 | 🟠 | 🔴 | ⚪ |
|
||||
| `LOW` | 🟠 | 🟠 | 🔴 | 🟠 |
|
||||
| `CRITICAL` | 🔴 | 🔴 | 🔴 | 🔴 |
|
||||
|
||||
- **Lecture** : la pire des deux analyses. Orange ou rouge peut venir d'une seule ; vert demande les deux. Un état inconnu donne un jour gris.
|
||||
- **Pourquoi deux analyses** : le niveau voit un bloc ponctuel que l'estimation ne prévoit pas ; l'estimation voit un disque qui fond alors que le niveau est encore confortable.
|
||||
- **WEISSHORN** (09/08 au 13/10/2026) : 52 jours 🟢, 14 ⚪ (jusqu'au 22/08), aucun 🟠 ni 🔴.
|
||||
|
||||
## 7. Lire la figure
|
||||
|
||||
`python3 src/storage/final.py` écrit `out/<STATION>_storage_daily.html` et sa figure en JSON (`.json`, pour `Plotly.newPlot`). C'est l'historique complet du bloc Storage. La page de comparaison (`python3 src/storage/all_analyses.py`, `out/<STATION>_storage.html`) reprend les mêmes panneaux, avec les séries du disque dessous.
|
||||
|
||||
- **Panneau `DAILY_STORAGE_STATE`** : `free space (end of day)` en %, les planchers de 20 % et 10 % en tirets, l'état en marqueurs (● vert `OK`, ◆ jaune `LOW`, ✕ violet `CRITICAL`).
|
||||
- **Panneau `DAYS_UNTIL_STORAGE_FULL`** : `days until full`, un point par jour estimé.
|
||||
- **Survol** : tous les faits calculés du jour (rythme en MiB/jour, date estimée, nombre de rythmes dans la fenêtre).
|
||||
- **Attention aux couleurs** : celles des panneaux distinguent les états, ce ne sont pas celles de la matrice.
|
||||
|
||||
## 8. Limites à connaître
|
||||
|
||||
1. **Seuils arbitraires** : 20 % et 10 % libres, 60 et 14 jours (D-034, D-035). Questions en suspens : `docs/storage/domaine/questions-pour-l-expert.md`.
|
||||
2. **Une seule station**, jamais sous 56 % libres : `LOW`, `CRITICAL`, orange et rouge n'ont jamais été observés ; aucun cas de l'expert.
|
||||
3. **Un bloc ponctuel n'est pas prévu** : sur un disque à moins de 1,3 GiB libres, le bloc du 31/08 l'aurait rempli sans que l'estimation ne bouge. Seul le niveau le voit, le jour même.
|
||||
4. **Disque plein : conséquence inconnue**. Une purge automatique ferait que « plein » n'arrive jamais ; si l'acquisition tourne en `root`, elle peut écrire dans la réserve (5,4 % du total sur WEISSHORN).
|
||||
5. **Projection linéaire** : un changement de schedule met 4 jours à dominer la médiane.
|
||||
6. **Versions plus anciennes du collecteur** (VERMONT, NORDEND) : pas de mesure de `/data`, donc pas de bloc Storage.
|
||||
@@ -0,0 +1,73 @@
|
||||
# `DAILY_GPU_TEMPERATURE_LIMIT` : le GPU a-t-il atteint sa limite dans les 24 dernières heures ?
|
||||
|
||||
- **Statut** : prototype en place (2026-10-13, D-040), sans cas de l'expert.
|
||||
- **Script** : `python3 src/temperature/all_analyses.py [CSV ou dossiers]` (défaut : `data/WEISSHORN/` et `data/NORDEND/`), écrit `out/<STATION>_temperature.html`.
|
||||
- **Code** : `src/temperature/gpu_temperature_limit.py` (analyse), `src/temperature/day_color.py` (couleur du jour) ; bibliothèque standard uniquement.
|
||||
|
||||
## Question posée
|
||||
|
||||
Chaque jour UTC : une moyenne horaire de `sensor_GPU_deg_c` a-t-elle atteint la température maximale de fonctionnement donnée par le constructeur, 97,5 °C, dans les 24 dernières heures ? Au-delà, le module réduit ses performances (Thermal Design Guide, § 4.3). Le seuil est celui du matériel, pas le passé de la station : D-036 écartait la comparaison au passé (elle signalerait les jours d'été chauds).
|
||||
|
||||
## Principe
|
||||
|
||||
Un dépassement isolé ne se voit que si l'on regarde au bon moment : le verdict porte donc sur une fenêtre de 24 h (demande de l'utilisateur).
|
||||
|
||||
Pour chaque jour UTC d présent dans la série :
|
||||
|
||||
1. t = dernière heure du jour d dans la série. La fenêtre est ]t − 24 h, t] : la journée entière pour un jour fini, les 24 dernières heures pour le jour en cours. Un dépassement à 23 h reste donc rouge le lendemain jusqu'à 23 h.
|
||||
2. Mesures de la fenêtre : les moyennes horaires non vides et finies.
|
||||
3. Aucune mesure : `value = None`, `anomaly = None` (UNKNOWN, gris).
|
||||
4. Sinon : `value` = la plus haute moyenne horaire de la fenêtre [°C] ; `anomaly` = `value >= 97,5`.
|
||||
|
||||
`facts` : `max_deg_c`, `max_at` (heure du maximum), `hours_measured`. Causal : le point d n'utilise que des heures ≤ t.
|
||||
|
||||
La couleur du jour (`day_color.py`) recopie l'analyse : `anomaly` vrai → `RED`, faux → `GREEN`, `None` → gris. Pas d'orange (D-040).
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| `GPU_LIMIT_DEG_C` | 97,5 °C | T.gpu, *Jetson Nano Thermal Design Guide* (NVIDIA), table 2-1 et § 4.3 « Tegra X1 SoC maximum operating temperature » : seuil sous lequel le module fonctionne sans réduction de performance, non réglable. Guide derrière une connexion NVIDIA : valeur lue dans [ce fil du forum NVIDIA](https://forums.developer.nvidia.com/t/operating-temperature-range-on-jetson-nano/73555) (citation du guide, confirmée par un modérateur NVIDIA). La carte est un Jetson Nano par **hypothèse** : les zones lues par le collecteur (0 A0, 1 CPU, 2 GPU, 3 PLL, 5 thermal ; la 4, PMIC-Die, figée à 100 °C, n'est pas lue) sont celles du Tegra X1 (`docs/temperature/domaine/point-de-depart.md`). |
|
||||
| `WINDOW` | 24 h | Demande de l'utilisateur (2026-10-13) : un dépassement reste visible pendant un jour. |
|
||||
|
||||
## Graphique
|
||||
|
||||
- **En haut** : la plus haute moyenne horaire des 24 h de chaque jour (à midi UTC), la limite de 97,5 °C en tirets, un marqueur par jour à la couleur du jour ; le survol donne les `facts`.
|
||||
- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/temperature/final.py` (historique complet du bloc Temperature de la vue client, D-041) ; la page de comparaison l'importe de là.
|
||||
- **Dessous** : `sensor_GPU_deg_c`, trous de mesure grisés.
|
||||
|
||||
## Résultats sur WEISSHORN et NORDEND (jeux de travail)
|
||||
|
||||
- **WEISSHORN** (66 jours, du 09/08 au 13/10) : 56 jours verts, 10 gris (du 09/08 au 18/08, avant la première mesure du 19/08). Maximum 50,9 °C le 15/09 à 14 h, à 46,6 °C de la limite.
|
||||
- **NORDEND** (110 jours, du 26/06 au 13/10) : 107 jours verts, 3 gris (du 26 au 28/06, avant la première mesure). Maximum 57,2 °C le 13/08 à 13 h, à 40,3 °C de la limite.
|
||||
- **VERMONT** : pas de `sensor_GPU_deg_c` (ancienne version du collecteur), station ignorée.
|
||||
- **Fenêtre de 24 h** : contrôlée en abaissant la limite à 50 °C sur WEISSHORN. Le 15/09 est rouge ; une série coupée au 16/09 à 10 h donne aussi un 16/09 rouge (maximum du 15/09 à 14 h) ; coupée au 16/09 à 15 h, le 16/09 est vert.
|
||||
- Aucun cas de l'expert : aucune station n'a jamais été rouge, le prototype n'est pas éprouvé sur un vrai incident.
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| Comparer la station à son propre passé | Signalerait les jours d'été chauds, pas un défaut (D-036). |
|
||||
| Verdict sur le seul jour UTC | Un dépassement en fin de jour ne serait plus visible le lendemain ; la fenêtre de 24 h ne change rien pour un jour fini. |
|
||||
| Orange sous la limite (marge de ± 3 °C de précision du capteur, § 4.3) | Garder une seule limite sourcée tant qu'aucun épisode de chaleur n'est connu (simple d'abord). |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. **Moyennes horaires** : un pic de quelques minutes au-dessus de 97,5 °C peut laisser la moyenne de l'heure en dessous et passer inaperçu. Une moyenne ≥ 97,5 °C prouve en revanche que la limite a été atteinte dans l'heure.
|
||||
2. **Précision du capteur : ± 3 °C** (§ 4.3) : 97,5 °C lus correspondent à une jonction entre 94,5 et 100,5 °C.
|
||||
3. **GPU seul** : le CPU lit de 0 à 2,5 °C de plus que le GPU (`point-de-depart.md`) et sa limite est plus basse (T.cpu = 97 °C) : il atteindrait sa limite un peu avant.
|
||||
4. **Extinction thermique non vue** : plus haut, le module s'arrête (seuil non lu à la source). Le trou qui suit est gris, ou vert si la moyenne de la dernière heure est restée sous la limite.
|
||||
5. **Carte supposée** : Jetson Nano non confirmé. Une autre carte aurait une autre limite.
|
||||
6. **Un vert n'est pas un « jamais chaud »** : vert dès qu'une heure est mesurée, même si les autres manquent.
|
||||
|
||||
## Pistes
|
||||
|
||||
- Lire les seuils réels sur une station (`/sys/devices/virtual/thermal/thermal_zone*/type` et `trip_point_*_temp`) pour confirmer la carte et la limite.
|
||||
- Ajouter le CPU (97 °C) si un premier épisode montre qu'il atteint sa limite avant le GPU.
|
||||
- Croiser avec Energy pour reconnaître une extinction thermique (trou + température haute juste avant).
|
||||
|
||||
## Historique
|
||||
|
||||
- **2026-10-13** : création, sur demande de l'utilisateur (D-040, remplace D-036).
|
||||
- **2026-10-13** : panneau partagé avec la figure du site `src/temperature/final.py` ; livraison du domaine (vue client, notifications, guide `docs/temperature/guide/`, D-041).
|
||||
+9
-6
@@ -1,14 +1,17 @@
|
||||
# Températures de la station
|
||||
# Températures de la station : point de départ du domaine `temperature`
|
||||
|
||||
Exploration du 2026-10-13 sur VERMONT, WEISSHORN et NORDEND. Pas de domaine pour l'instant (D-036) : aucun épisode de chaleur à détecter, aucun seuil sourcé.
|
||||
**Question du domaine** : la carte de calcul a-t-elle atteint la température maximale donnée par le constructeur dans les 24 dernières heures (D-040) ? Une analyse : `DAILY_GPU_TEMPERATURE_LIMIT` (`docs/temperature/analyses/`).
|
||||
|
||||
Exploration du 2026-10-13 sur VERMONT, WEISSHORN et NORDEND. Jeux de travail : WEISSHORN et NORDEND, les seuls avec `sensor_GPU_deg_c`.
|
||||
|
||||
## Ce que mesure le collecteur
|
||||
|
||||
- `get_thermal_info()` (`docs/aimsight/collecteur_system_info.py`) lit `/sys/devices/virtual/thermal/thermal_zone<N>/temp` en millidegrés : A0 = zone 0, CPU = 1, GPU = 2, PLL = 3, thermal = 5. La zone 4 n'est pas lue. Export : `sensor_<zone>_deg_c` (`SYNC_SPEC`, groupe `temperature`), en moyennes horaires.
|
||||
- Ce sont les températures de la **carte de calcul**, pas celles de la batterie ni de l'air extérieur.
|
||||
- Les noms des zones ressemblent à ceux d'un Jetson Nano : hypothèse, non confirmée.
|
||||
- **Carte supposée : NVIDIA Jetson Nano (Tegra X1)**, hypothèse non confirmée. Ses zones sont, dans l'ordre, AO-therm, CPU-therm, GPU-therm, PLL-therm, PMIC-Die et thermal-fan-est : c'est le schéma du collecteur, qui saute la zone 4 (PMIC-Die n'est pas une mesure : elle reste figée à 100 °C, d'après [le forum NVIDIA](https://forums.developer.nvidia.com/t/the-temperature-of-thermal-zone4-is-100000-for-jetson-nano/163763)).
|
||||
- Champs selon la version du collecteur : VERMONT n'a ni A0 ni GPU, et son CPU ne commence que le 20/08 ; WEISSHORN et NORDEND ont les cinq. `sensor_thermal_deg_c` est la seule commune aux trois.
|
||||
- La documentation AIMsight (FAQ, manuel de la station) ne donne aucune plage de fonctionnement.
|
||||
- **Limites du constructeur** (*Jetson Nano Thermal Design Guide*, table 2-1 et § 4.3, lues dans [un fil du forum NVIDIA](https://forums.developer.nvidia.com/t/operating-temperature-range-on-jetson-nano/73555), le guide demandant une connexion) : T.cpu = 97 °C, T.gpu = 97,5 °C. Ce sont des températures de jonction, au-delà desquelles le module réduit ses performances ; elles ne sont pas réglables. Le capteur est précis à ± 3 °C.
|
||||
|
||||
## Ce que montrent les données
|
||||
|
||||
@@ -19,16 +22,16 @@ Exploration du 2026-10-13 sur VERMONT, WEISSHORN et NORDEND. Pas de domaine pour
|
||||
- **La consommation pèse peu** : corrélation horaire avec `Power` de 0,01 (NORDEND) à 0,27 (VERMONT). Un gros pic de consommation chauffe pourtant la station : +9,7 °C en une heure le 21/08 sur WEISSHORN (`Power` de 5,3 à 10,9 W), +8,6 °C le 10/07 sur NORDEND (de 13,6 à 25,6 W).
|
||||
- **Données propres** : aucune valeur figée (au plus 3 h identiques de suite, 8 h une fois sur le GPU de NORDEND), aucune valeur aberrante.
|
||||
|
||||
## Pistes, non retenues pour l'instant
|
||||
## Pistes
|
||||
|
||||
1. **Témoin d'extinction, pour Energy** (`pieges-des-donnees.md`, signature d'une coupure). Au retour des coupures de nuit de VERMONT, `thermal` est de 3,6 à 10,9 °C sous la médiane de la même heure des 7 jours précédents (−10,9 °C le 05/10). Seule, elle ne tranche pas : le 19/08, VERMONT et NORDEND ont un trou commun (cause hors station) et reviennent tous deux ~7 °C sous leur habitude ; les coupures du 07/10 et du 09/10, revenues après le lever du soleil, ne montrent pas d'écart (+0,6 et +2,0 °C). À combiner avec la tension, jamais seule. Pas codée.
|
||||
2. **Surchauffe** : aucun épisode, aucun seuil. Comparer la station à son propre passé ne signalerait que les jours d'été chauds. À reprendre avec les seuils du matériel ou un premier incident.
|
||||
2. **Surchauffe** : retenue (D-040), avec la limite du GPU, dans `DAILY_GPU_TEMPERATURE_LIMIT`. Comparer la station à son propre passé reste écarté : cela ne signalerait que les jours d'été chauds.
|
||||
3. **Froid** : pas encore de données d'hiver. À reprendre cet hiver, après la question 3 ci-dessous.
|
||||
4. **Indice d'ensoleillement** (l'apport n'est pas mesuré) : la corrélation entre l'amplitude du jour et la tension maximale du jour vaut 0,20 sur VERMONT, 0,32 sur WEISSHORN et −0,03 sur NORDEND. Trop faible, écartée.
|
||||
5. **Capteur défaillant** (écart entre deux zones hors de sa plage) : jamais observé, pas prioritaire.
|
||||
|
||||
## Questions pour le spécialiste
|
||||
|
||||
1. Quelle carte de calcul équipe la station, et à quelles températures ralentit-elle puis s'arrête-t-elle ? Les seuils se lisent sur une station : `cat /sys/devices/virtual/thermal/thermal_zone*/trip_point_*_temp`.
|
||||
1. La carte de calcul est-elle bien un Jetson Nano (limite du GPU retenue : 97,5 °C, D-040), et à quelles températures ralentit-elle puis s'arrête-t-elle ? Les noms et les seuils se lisent sur une station : `cat /sys/devices/virtual/thermal/thermal_zone*/type` et `cat /sys/devices/virtual/thermal/thermal_zone*/trip_point_*_temp`.
|
||||
2. Une station a-t-elle déjà eu un problème de chaleur ? Si oui, quand (futur cas annoté) ?
|
||||
3. La charge de la batterie LiFePO4 est-elle bloquée par le froid (BMS ou chargeur), et à quelle température ? La température de la batterie est-elle mesurée quelque part ?
|
||||
@@ -0,0 +1,78 @@
|
||||
# Guide : lire le diagnostic de température d'une station AIMsight
|
||||
|
||||
- **Statut** : brouillon, 2026-10-13. La couleur du jour est calculée par `src/temperature/day_color.py` (D-040), sans matrice : une seule analyse, une seule limite. Prototype : carte supposée, aucun cas de l'expert, rouge jamais observé.
|
||||
- **Lecteurs** : la partie 1 s'adresse au client final (elle est affichée dans le bloc Temperature de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight.
|
||||
|
||||
---
|
||||
|
||||
# Partie 1 : lecture rapide
|
||||
|
||||
## 1. Ce que surveille le diagnostic
|
||||
|
||||
La station contient un petit ordinateur qui traite les images. S'il chauffe trop, il ralentit pour se protéger. Chaque jour, le diagnostic répond à une question : **le processeur graphique de la station a-t-il atteint, dans les 24 dernières heures, la température maximale donnée par le constructeur (97,5 °C) ?**
|
||||
|
||||
La réponse est une **couleur par jour**.
|
||||
|
||||
## 2. Les couleurs, et ce qu'il faut faire
|
||||
|
||||
| Couleur | Ce que ça veut dire | Que faire |
|
||||
|---|---|---|
|
||||
| 🟢 **Vert** | La température est restée sous la limite du constructeur pendant les 24 dernières heures. | Rien. |
|
||||
| 🔴 **Rouge** | La limite a été atteinte dans les 24 dernières heures : l'ordinateur a pu ralentir pour se protéger. | **Contacter le support.** |
|
||||
| ⚪ **Gris** | Inconnu : aucune mesure de température dans les 24 dernières heures. | Regarder les jours voisins, et le bloc Energy : une station éteinte ne mesure rien. |
|
||||
|
||||
- **Pas d'orange** : il n'y a qu'une limite, celle du constructeur.
|
||||
- **Un rouge reste affiché 24 heures** : une surchauffe à 23 h est encore signalée le lendemain jusqu'à 23 h, pour ne pas passer inaperçue.
|
||||
|
||||
## 3. Ce qu'affiche le bloc
|
||||
|
||||
- **Hottest (24 h)** : la plus haute température mesurée dans les 24 dernières heures (moyenne d'une heure), et la limite de 97,5 °C.
|
||||
|
||||
## 4. Deux exemples réels (2026)
|
||||
|
||||
| Station | Période | Couleur | Ce qui se passe |
|
||||
|---|---|---|---|
|
||||
| WEISSHORN | 19/08 – 13/10 | 🟢 tous les jours | Maximum 51 °C le 15/09 à 14 h UTC, à 47 °C de la limite. |
|
||||
| NORDEND | 29/06 – 13/10 | 🟢 tous les jours | Maximum 57 °C le 13/08 à 13 h UTC, à 40 °C de la limite. |
|
||||
|
||||
Aucun jour rouge n'a encore été observé : les deux stations restent loin de la limite, même en plein été.
|
||||
|
||||
---
|
||||
|
||||
# Partie 2 : annexe technique (support)
|
||||
|
||||
La couleur du jour recopie une seule analyse de `sensor_GPU_deg_c` (moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans sa fiche : `docs/temperature/analyses/daily_gpu_temperature_limit.md`. Une couleur conclut au plus `consistent with` : elle signale une journée à regarder.
|
||||
|
||||
## 5. L'analyse (`DAILY_GPU_TEMPERATURE_LIMIT`)
|
||||
|
||||
- **Fenêtre** : pour chaque jour UTC, les 24 heures qui finissent à la dernière heure du jour présente dans la série : la journée entière pour un jour fini, les 24 dernières heures pour le jour en cours.
|
||||
- **Calcul** : la plus haute moyenne horaire de la fenêtre (`max_deg_c`, avec son heure `max_at`) ; `anomaly` = `max_deg_c` ≥ 97,5 °C ; aucune mesure dans la fenêtre : inconnu.
|
||||
- **Source du seuil** : T.gpu = 97,5 °C, *Jetson Nano Thermal Design Guide* (NVIDIA), table 2-1 et § 4.3 : au-delà, le module réduit ses performances. La carte est un Jetson Nano par **hypothèse**, d'après les zones thermiques lues par le collecteur.
|
||||
|
||||
## 6. De l'analyse à la couleur
|
||||
|
||||
| `anomaly` | Couleur |
|
||||
|---|---|
|
||||
| `True` (limite atteinte dans les 24 h) | 🔴 |
|
||||
| `False` | 🟢 |
|
||||
| `None` (aucune mesure dans les 24 h) | ⚪ |
|
||||
|
||||
- **Totaux** : WEISSHORN (09/08 au 13/10/2026), 56 jours 🟢 et 10 ⚪ (avant la première mesure du 19/08) ; NORDEND (26/06 au 13/10/2026), 107 🟢 et 3 ⚪ (26 au 28/06). Aucun 🔴.
|
||||
- **Pourquoi pas d'orange** : une marge sous la limite (± 3 °C de précision du capteur) a été écartée tant qu'aucun épisode de chaleur n'est connu (D-040).
|
||||
|
||||
## 7. Lire la figure
|
||||
|
||||
`python3 src/temperature/final.py` écrit `out/<STATION>_temperature_daily.html` et sa figure en JSON (`.json`, pour `Plotly.newPlot`). C'est l'historique complet du bloc Temperature. La page de comparaison (`python3 src/temperature/all_analyses.py`, `out/<STATION>_temperature.html`) reprend le même panneau, avec `sensor_GPU_deg_c` dessous.
|
||||
|
||||
- **Panneau `DAILY_GPU_TEMPERATURE_LIMIT`** : `max of the last 24 h`, un point par jour à midi UTC ; la limite de 97,5 °C en tirets rouges ; un marqueur par jour à la couleur du jour (● vert, ✕ rouge, ○ gris).
|
||||
- **Survol** : les faits du jour (`max_deg_c`, `max_at`, `hours_measured`).
|
||||
|
||||
## 8. Limites à connaître
|
||||
|
||||
1. **Moyennes horaires** : un pic de quelques minutes au-dessus de 97,5 °C peut rester invisible.
|
||||
2. **Précision du capteur : ± 3 °C** : 97,5 °C lus correspondent à une jonction entre 94,5 et 100,5 °C.
|
||||
3. **GPU seul** : le CPU lit jusqu'à 2,5 °C de plus et sa limite est plus basse (97 °C) ; il atteindrait sa limite un peu avant.
|
||||
4. **Extinction thermique non vue** : plus haut, le module s'arrête ; le trou qui suit est gris, ou vert si la dernière heure mesurée est restée sous la limite.
|
||||
5. **Carte supposée** : une autre carte aurait une autre limite. À confirmer sur une station (`docs/temperature/domaine/point-de-depart.md`).
|
||||
6. **Un vert n'est pas un « jamais chaud »** : il suffit d'une heure mesurée dans les 24 h.
|
||||
7. **Versions plus anciennes du collecteur** (VERMONT) : pas de `sensor_GPU_deg_c`, donc pas de bloc Temperature.
|
||||
+34
-18
@@ -1,9 +1,11 @@
|
||||
"""Maquette côté support « Home » : page d'accueil du site de monitoring (toutes les stations), avec en haut une section
|
||||
Status. Elle porte une notification par station dont le dernier jour de la fenêtre est Orange ou Red (src/energy/day_color.py, D-020).
|
||||
Status. Elle porte une notification par station et par domaine dont le dernier jour de la fenêtre est Orange ou Red
|
||||
(src/<domaine>/day_color.py : Energy, Storage, Cellular, Temperature ; D-025, D-030). Energy y ajoute son statut
|
||||
d'alimentation, sur secteur ou non (DAILY_POWER_SOURCE, D-043).
|
||||
|
||||
La notification, comme la vignette de la station, mène à la vue client de la station (son menu principal) :
|
||||
out/maquette_user_energy.html, écrite par maquettes/user/energy.py (à lancer avec les mêmes dates).
|
||||
Données réelles : VERMONT seule (data/VERMONT/). Les autres stations, noms repris du site, n'ont pas de données dans la maquette.
|
||||
out/maquette_user_<STATION>.html, écrite par maquettes/user/summary.py (à lancer avec les mêmes dates).
|
||||
Données réelles : les stations de data/ (VERMONT, WEISSHORN, NORDEND). Les autres, noms repris du site, n'ont pas de données.
|
||||
Écrit out/maquette_support_home.html et l'ouvre dans le navigateur.
|
||||
Usage : python3 maquettes/support/home.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28)
|
||||
"""
|
||||
@@ -16,7 +18,10 @@ ROOT = HERE.parent.parent
|
||||
sys.path.insert(0, str(ROOT / "src"))
|
||||
from common.page import open_html # noqa: E402
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from energy import day_color as dc # noqa: E402
|
||||
from cellular import day_color as cellular # noqa: E402
|
||||
from energy import day_color as energy # noqa: E402
|
||||
from storage import day_color as storage # noqa: E402
|
||||
from temperature import day_color as temperature # noqa: E402
|
||||
|
||||
START = date.fromisoformat(sys.argv[1]) if len(sys.argv) > 1 else date(2026, 9, 18)
|
||||
END = date.fromisoformat(sys.argv[2]) if len(sys.argv) > 2 else date(2026, 9, 28)
|
||||
@@ -27,12 +32,11 @@ STATIONS = ["ALLALINHORN", "BREITHORN", "CASTOR", "CLARIDEN", "DOM", "FINSTERAAR
|
||||
"PIZBERNINA", "PIZBUIN", "POLLUX", "RINGELSPITZ", "VERMONT", "WEISSHORN", "ADULA", "ALASKA", "DAMMASTOCK",
|
||||
"FAULHORN", "GRANDCOMBIN", "MARYLAND", "MONTANA", "NADELHORN", "PONT_TREMBLEX-01", "SNCF01", "WILDSTRUBEL",
|
||||
"WYOMING"]
|
||||
USER_VIEW = {"VERMONT": "maquette_user_energy.html"} # vue client de la station (maquettes/user/)
|
||||
DOMAINS = {"Energy": energy, "Storage": storage, "Cellular": cellular, "Temperature": temperature} # contrat de notification (D-030)
|
||||
NAME = {"RED": "Red", "ORANGE": "Orange"} # couleurs notifiées, la plus grave d'abord ; Green ne notifie rien
|
||||
HEADLINE = {"RED": "The station is not receiving enough energy.", # mêmes phrases que la vue client
|
||||
"ORANGE": "The station's energy supply is uncertain."}
|
||||
|
||||
series = load_stations([str(ROOT / "data" / "VERMONT")])
|
||||
series = load_stations([str(d) for d in sorted((ROOT / "data").iterdir()) if d.is_dir()])
|
||||
user_view = lambda name: f"maquette_user_{name}.html" if name in series else "#" # noqa: E731 (maquettes/user/)
|
||||
|
||||
|
||||
def spark(v):
|
||||
@@ -55,18 +59,30 @@ for name in STATIONS:
|
||||
f'</div><svg></svg></div>')
|
||||
continue
|
||||
svg, last = spark(series[name]["BusVoltage"])
|
||||
tiles.append(f'<a class="tile" href="{USER_VIEW.get(name, "#")}"><div class="tile-head">{name}<span>{last:.2f}[V]</span>'
|
||||
tiles.append(f'<a class="tile" href="{user_view(name)}"><div class="tile-head">{name}<span>{last:.2f}[V]</span>'
|
||||
f'</div>{svg}</a>')
|
||||
|
||||
def facts_of(dc, station):
|
||||
"""Faits du dernier jour de la fenêtre pour un domaine, couleur comprise ; {} si la station n'a pas ses mesures."""
|
||||
try:
|
||||
points = dc.run(series[station])["points"]
|
||||
except KeyError: # série du domaine absente (VERMONT n'a ni disque ni modem)
|
||||
return {}
|
||||
return {p["t"].date(): p["facts"] for p in points}.get(END, {})
|
||||
|
||||
|
||||
notes = []
|
||||
for name in series:
|
||||
color = {p["t"].date(): p["facts"]["color"] for p in dc.run(series[name])["points"]}.get(END)
|
||||
if color in NAME:
|
||||
notes.append((list(NAME).index(color), name,
|
||||
f'<li><span class="status {color}">{NAME[color]}</span><b>{name}</b><span>Energy</span>'
|
||||
f'<span class="meta">{END.strftime("%a %d %b %Y")}</span><span>{HEADLINE[color]}</span>'
|
||||
f'<a href="{USER_VIEW.get(name, "#")}">Open {name} →</a></li>'))
|
||||
status = "".join(n[2] for n in sorted(notes)) or '<li class="empty">No problem or point of attention.</li>'
|
||||
for domain, dc in DOMAINS.items():
|
||||
facts = facts_of(dc, name)
|
||||
color = facts.get("color")
|
||||
power = f'<span class="power">{dc.POWER_LABEL[facts["power"]]}</span>' if "power" in facts else ""
|
||||
if color in NAME:
|
||||
notes.append((list(NAME).index(color), name, domain,
|
||||
f'<li><span class="status {color}">{NAME[color]}</span><b>{name}</b><span>{domain}</span>{power}'
|
||||
f'<span class="meta">{END.strftime("%a %d %b %Y")}</span><span>{dc.HEADLINE[color]}</span>'
|
||||
f'<a href="{user_view(name)}">Open {name} →</a></li>'))
|
||||
status = "".join(n[-1] for n in sorted(notes)) or '<li class="empty">No problem or point of attention.</li>'
|
||||
|
||||
html = (HERE / "home_template.html").read_text()
|
||||
for key, value in (("<!--COUNT-->", f"{len(notes)} notification{'s' * (len(notes) != 1)}"),
|
||||
@@ -76,6 +92,6 @@ out = ROOT / "out" / "maquette_support_home.html"
|
||||
out.parent.mkdir(exist_ok=True)
|
||||
out.write_text(html)
|
||||
print(out)
|
||||
if not (out.parent / USER_VIEW["VERMONT"]).exists():
|
||||
print("Vue client absente : lancer python3 maquettes/user/energy.py avec les mêmes dates.")
|
||||
if not all((out.parent / user_view(name)).exists() for name in series):
|
||||
print("Vue client absente : lancer python3 maquettes/user/summary.py avec les mêmes dates.")
|
||||
open_html(out)
|
||||
@@ -52,6 +52,7 @@
|
||||
.status { padding: 2px 12px; border-radius: 999px; font-size: 13px; font-weight: bold; color: #fff; }
|
||||
.status.ORANGE { background: var(--orange); color: #1a1a1a; } .status.RED { background: var(--red); }
|
||||
.meta { color: var(--muted); font-size: 13px; }
|
||||
.power { padding: 1px 10px; border: 1px solid var(--line); border-radius: 999px; font-size: 13px; } /* Energy : secteur ou non (D-043) */
|
||||
|
||||
/* Vignettes des stations, comme sur le site : nom, dernière tension, courbe de la fenêtre. */
|
||||
.grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 16px 0; margin-bottom: 20px; }
|
||||
|
||||
@@ -1,62 +0,0 @@
|
||||
"""Maquette côté client « Energy » : page System Summary du site de monitoring, avec une section Diagnostic (D-020 à D-023).
|
||||
|
||||
Données réelles VERMONT. Bloc Energy : couleur du dernier jour de la fenêtre, échelle de batterie et tendance face à la veille
|
||||
(src/energy/day_color.py), puis historique complet (energy.final.daily_figure, D-021) et guide (partie 1 du manuel), repliés.
|
||||
Écrit out/maquette_user_energy.html et l'ouvre dans le navigateur.
|
||||
Usage : python3 maquettes/user/energy.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28)
|
||||
"""
|
||||
import json
|
||||
import re
|
||||
import sys
|
||||
from datetime import date, datetime, time, timedelta, timezone
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
ROOT = HERE.parent.parent
|
||||
sys.path.insert(0, str(ROOT / "src"))
|
||||
from common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402
|
||||
from energy.final import daily_figure # noqa: E402
|
||||
|
||||
START = date.fromisoformat(sys.argv[1]) if len(sys.argv) > 1 else date(2026, 9, 18)
|
||||
END = date.fromisoformat(sys.argv[2]) if len(sys.argv) > 2 else date(2026, 9, 28)
|
||||
|
||||
series = load_stations([str(ROOT / "data" / "VERMONT")])["VERMONT"]
|
||||
v = series["BusVoltage"]
|
||||
in_window = lambda t: START <= t.date() <= END # noqa: E731
|
||||
|
||||
hours = [[t.isoformat(), v[t]] for t in sorted(v) if in_window(t)]
|
||||
daily = {}
|
||||
for t, x in hours:
|
||||
if x is not None:
|
||||
d = daily.setdefault(t[:10], {"lo": [t, x], "hi": [t, x]})
|
||||
d["lo"] = min(d["lo"], [t, x], key=lambda p: p[1])
|
||||
d["hi"] = max(d["hi"], [t, x], key=lambda p: p[1])
|
||||
|
||||
end = datetime.combine(END, time(23), timezone.utc)
|
||||
table = []
|
||||
for metric in sorted(series):
|
||||
last = [x for t, x in series[metric].items() if t <= end and x is not None]
|
||||
table.append([metric, f"{last[-1]:.2f} [unknown]" if last else "—"])
|
||||
|
||||
facts = {p["t"].date(): p["facts"] for p in dc.run(series)["points"]}
|
||||
# Guide : partie 1 du manuel (lecture rapide, pour le client), relue à chaque génération ; titres décalés de deux niveaux.
|
||||
manual = (ROOT / "docs" / "energy" / "guide" / "diagnostic-energetique.md").read_text()
|
||||
part1 = manual[manual.index("# Partie 1"):manual.index("# Partie 2")].split("\n", 1)[1] # sans son titre
|
||||
guide = re.sub(r"^#", "###", part1.rstrip().removesuffix("---"), flags=re.M)
|
||||
data = {"hours": hours, "daily": list(daily.values()), "table": table, "guide": guide,
|
||||
"range": [START.isoformat(), (END + timedelta(days=1)).isoformat()],
|
||||
"energy": {"cur": facts.get(END), "label": END.strftime("%a %d %b %Y")},
|
||||
"rule": {"full_charge_v": bs.FULL_CHARGE_V, "plateau_floor_v": bs.PLATEAU_FLOOR_V, "min_rise_v": bs.MIN_RISE_V,
|
||||
"deadband_v": bt.NIGHT_END_DEADBAND_V}}
|
||||
html = (HERE / "energy_template.html").read_text()
|
||||
for key, value in (("/*DATA*/null", json.dumps(data)),
|
||||
("/*DAILY*/null", daily_figure("VERMONT", series).to_json()),
|
||||
("/*AUTOSCALE*/", AUTOSCALE_Y_JS.replace("{plot_id}", "daily"))):
|
||||
html = html.replace(key, value)
|
||||
out = ROOT / "out" / "maquette_user_energy.html"
|
||||
out.parent.mkdir(exist_ok=True)
|
||||
out.write_text(html)
|
||||
print(out)
|
||||
open_html(out)
|
||||
@@ -0,0 +1,96 @@
|
||||
"""Maquette côté client « System Summary » : page d'une station sur le site de monitoring, avec une section Diagnostic
|
||||
(D-020 à D-023, D-039, D-041). Un bloc par domaine dont la station a les mesures : Energy, Storage, Cellular, Temperature.
|
||||
|
||||
Chaque bloc : couleur du dernier jour de la fenêtre et sa phrase (src/<domaine>/day_color.py), deux lignes en mots simples
|
||||
(Energy : échelle de batterie et tendance ; Storage : échelle de l'espace libre et date de saturation ; Cellular : envois
|
||||
du jour et échelle du signal ; Temperature : maximum des 24 h et limite), puis historique complet (src/<domaine>/final.py, D-021) et guide (partie 1), repliés.
|
||||
Energy affiche aussi, dans son en-tête, si la station est sur secteur ou non (DAILY_POWER_SOURCE, D-043).
|
||||
Données réelles : une page par station de data/. Écrit out/maquette_user_<STATION>.html et les ouvre dans le navigateur.
|
||||
Usage : python3 maquettes/user/summary.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28)
|
||||
"""
|
||||
import json
|
||||
import re
|
||||
import sys
|
||||
from datetime import date, datetime, time, timedelta, timezone
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
ROOT = HERE.parent.parent
|
||||
sys.path.insert(0, str(ROOT / "src"))
|
||||
from common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from cellular import day_color as cellular, link_state as ls, signal_state as sgs # noqa: E402
|
||||
from cellular.final import daily_figure as cellular_figure # noqa: E402
|
||||
from energy import battery_state as bs, day_color as energy # noqa: E402
|
||||
from energy.final import daily_figure as energy_figure # noqa: E402
|
||||
from storage import day_color as storage, storage_state as sts # noqa: E402
|
||||
from storage.final import daily_figure as storage_figure # noqa: E402
|
||||
from temperature import day_color as temperature, gpu_temperature_limit as gl # noqa: E402
|
||||
from temperature.final import daily_figure as temperature_figure # noqa: E402
|
||||
|
||||
START = date.fromisoformat(sys.argv[1]) if len(sys.argv) > 1 else date(2026, 9, 18)
|
||||
END = date.fromisoformat(sys.argv[2]) if len(sys.argv) > 2 else date(2026, 9, 28)
|
||||
|
||||
# Un bloc par domaine, dans cet ordre : couleur du jour, figure du site, guide (partie 1 relue à chaque génération).
|
||||
DOMAINS = {"energy": (energy, energy_figure, "docs/energy/guide/diagnostic-energetique.md"),
|
||||
"storage": (storage, storage_figure, "docs/storage/guide/diagnostic-stockage.md"),
|
||||
"cellular": (cellular, cellular_figure, "docs/cellular/guide/diagnostic-cellulaire.md"),
|
||||
"temperature": (temperature, temperature_figure, "docs/temperature/guide/diagnostic-temperature.md")}
|
||||
IDENTIFIERS = ("SIM_CCID", "ip") # préfixes des identifiants de la station : jamais affichés (CLAUDE.md, data/)
|
||||
RULE = {"full_charge_v": bs.FULL_CHARGE_V, "min_rise_v": bs.MIN_RISE_V, "storage_floors": sts.FREE_PERCENT_FLOORS,
|
||||
"expected_sends": ls.SAMPLES_PER_HOUR * ls.HOURS_PER_DAY, "signal_classes": sgs.CLASSES,
|
||||
"gpu_limit_deg_c": gl.GPU_LIMIT_DEG_C, "power_label": energy.POWER_LABEL}
|
||||
|
||||
|
||||
def guide(path):
|
||||
"""Partie 1 d'un guide (lecture rapide, pour le client), sans son titre ; titres décalés de deux niveaux."""
|
||||
manual = (ROOT / path).read_text()
|
||||
part1 = manual[manual.index("# Partie 1"):manual.index("# Partie 2")].split("\n", 1)[1]
|
||||
return re.sub(r"^#", "###", part1.rstrip().removesuffix("---"), flags=re.M)
|
||||
|
||||
|
||||
def page(station, series):
|
||||
"""Page System Summary d'une station -> chemin écrit."""
|
||||
v = series["BusVoltage"]
|
||||
hours = [[t.isoformat(), v[t]] for t in sorted(v) if START <= t.date() <= END]
|
||||
daily = {}
|
||||
for t, x in hours:
|
||||
if x is not None:
|
||||
d = daily.setdefault(t[:10], {"lo": [t, x], "hi": [t, x]})
|
||||
d["lo"] = min(d["lo"], [t, x], key=lambda p: p[1])
|
||||
d["hi"] = max(d["hi"], [t, x], key=lambda p: p[1])
|
||||
|
||||
end = datetime.combine(END, time(23), timezone.utc)
|
||||
table = []
|
||||
for metric in sorted(series):
|
||||
last = [x for t, x in series[metric].items() if t <= end and x is not None]
|
||||
if metric.startswith(IDENTIFIERS) or any(isinstance(x, list) for x in last): # identifiants, métriques texte
|
||||
continue
|
||||
table.append([metric, f"{last[-1]:.2f} [unknown]" if last else "—"])
|
||||
|
||||
domains = {}
|
||||
for key, (dc, figure, doc) in DOMAINS.items():
|
||||
try:
|
||||
facts = {p["t"].date(): p["facts"] for p in dc.run(series)["points"]}
|
||||
except KeyError: # la station n'a pas les mesures du domaine (VERMONT : ni disque ni modem) : pas de bloc
|
||||
continue
|
||||
domains[key] = {"cur": facts.get(END), "headline": dc.HEADLINE, "guide": guide(doc),
|
||||
"figure": json.loads(figure(station, series).to_json())}
|
||||
|
||||
data = {"station": station, "hours": hours, "daily": list(daily.values()), "table": table, "domains": domains,
|
||||
"label": END.strftime("%a %d %b %Y"), "range": [START.isoformat(), (END + timedelta(days=1)).isoformat()],
|
||||
"rule": RULE}
|
||||
html = (HERE / "summary_template.html").read_text()
|
||||
for key, value in (("<!--STATION-->", station), ("/*DATA*/null", json.dumps(data)),
|
||||
("/*AUTOSCALE*/", AUTOSCALE_Y_JS.replace("'{plot_id}'", "plotId"))):
|
||||
html = html.replace(key, value)
|
||||
out = ROOT / "out" / f"maquette_user_{station}.html"
|
||||
out.parent.mkdir(exist_ok=True)
|
||||
out.write_text(html)
|
||||
return out
|
||||
|
||||
|
||||
for station, series in sorted(load_stations([str(d) for d in sorted((ROOT / "data").iterdir()) if d.is_dir()]).items()):
|
||||
out = page(station, series)
|
||||
print(out)
|
||||
open_html(out)
|
||||
@@ -3,11 +3,11 @@
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>AIMsight Energy</title>
|
||||
<title>AIMsight System Summary</title>
|
||||
<script src="https://cdn.plot.ly/plotly-4.1.1.min.js"></script>
|
||||
<script src="https://cdn.jsdelivr.net/npm/marked@12.0.2/marked.min.js"></script>
|
||||
<style>
|
||||
/* Maquette côté client : page System Summary + section Diagnostic (D-020 à D-023). Données injectées par energy.py. */
|
||||
/* Maquette côté client : page System Summary + section Diagnostic (D-020 à D-023, D-039, D-041). Données injectées par summary.py. */
|
||||
:root {
|
||||
--sidebar: #2a3f54; --topbar: #ededed; --page: #f7f7f7; --panel-border: #e6e9ed;
|
||||
--muted: #73879c; --text: #333; --line: #dee2e6;
|
||||
@@ -43,10 +43,11 @@
|
||||
.panel-title h2 small { font-size: 14px; margin-left: 10px; }
|
||||
.panel-title .tools { margin-left: auto; color: #c5c7cb; }
|
||||
|
||||
/* Ajout : section Diagnostic, une ligne repliable par diagnostic (ici : énergie). */
|
||||
/* Ajout : section Diagnostic, une ligne repliable par domaine (Energy, Storage, Cellular, Temperature). */
|
||||
.diag { margin: 22px 22px 0; }
|
||||
.diag > h3 { margin: 0 0 8px; font-size: 12px; font-weight: bold; letter-spacing: .4px; text-transform: uppercase; }
|
||||
.diag-item { border: 1px solid var(--line); border-radius: 4px; }
|
||||
.diag-item + .diag-item { margin-top: 8px; }
|
||||
.diag-item > summary { list-style: none; cursor: pointer; display: flex; align-items: center; gap: 14px;
|
||||
padding: 10px 14px; color: var(--text); font-size: 15px; }
|
||||
.diag-item > summary::-webkit-details-marker { display: none; }
|
||||
@@ -54,6 +55,7 @@
|
||||
.status.GREEN { background: var(--green); } .status.ORANGE { background: var(--orange); color: #1a1a1a; }
|
||||
.status.RED { background: var(--red); } .status.UNKNOWN { background: var(--unknown); }
|
||||
.meta { color: var(--muted); font-size: 13px; }
|
||||
.power { padding: 1px 10px; border: 1px solid var(--line); border-radius: 999px; font-size: 13px; color: var(--text); }
|
||||
.diag-item > summary .chev { margin-left: auto; width: 13px; height: 13px; transition: transform .15s; }
|
||||
.diag-item[open] > summary .chev { transform: rotate(180deg); }
|
||||
.diag-body { border-top: 1px solid var(--line); padding: 14px; }
|
||||
@@ -61,11 +63,9 @@
|
||||
.days { border-collapse: collapse; color: var(--text); }
|
||||
.days th, .days td { padding: 5px 28px 5px 0; text-align: left; font-weight: normal; vertical-align: top; }
|
||||
.days th { color: var(--muted); }
|
||||
/* Échelle de batterie : Off < 10 %, Low < 30 %, OK < 90 %, Full ; le trait marque le niveau de ce matin. */
|
||||
/* Échelle (batterie, espace libre, signal) : zones teintées, le trait marque la valeur du jour. */
|
||||
.gauge { position: relative; display: flex; width: 320px; font-size: 10px; color: var(--muted); }
|
||||
.gauge span { border-top: 10px solid; padding-top: 2px; text-align: center; }
|
||||
.gauge span:nth-child(1) { border-color: #f1c0c0; } .gauge span:nth-child(2) { border-color: #f8dca8; }
|
||||
.gauge span:nth-child(3) { border-color: #e4ebdc; } .gauge span:nth-child(4) { border-color: #bfe0bf; }
|
||||
.gauge span { border-top: 10px solid; padding-top: 2px; text-align: center; white-space: nowrap; }
|
||||
.gauge i { position: absolute; top: -3px; height: 16px; width: 3px; margin-left: -1.5px; background: var(--text); border-radius: 2px; }
|
||||
.gauge-text { margin-top: 6px; }
|
||||
/* Guide : partie 1 du manuel, rendue depuis le Markdown. */
|
||||
@@ -82,7 +82,7 @@
|
||||
.action button { background: #2a78d6; color: #fff; border: 0; border-radius: 4px; padding: 7px 12px;
|
||||
font: inherit; font-size: 14px; cursor: pointer; }
|
||||
.sub > summary { cursor: pointer; color: var(--muted); }
|
||||
#daily { margin-top: 10px; }
|
||||
.plot { margin-top: 10px; }
|
||||
|
||||
.collapse { margin: 22px 22px 0; border-top: 1px solid var(--line); border-bottom: 1px solid var(--line);
|
||||
padding: 9px 0; display: flex; justify-content: space-between; color: var(--text); font-size: 15px; }
|
||||
@@ -125,37 +125,40 @@
|
||||
<main>
|
||||
<section class="panel">
|
||||
<div class="panel-title">
|
||||
<h2>VERMONT<small>System Summary</small></h2>
|
||||
<h2><!--STATION--><small>System Summary</small></h2>
|
||||
<span class="tools"><svg class="i"><use href="#wrench"/></svg> ▾</span>
|
||||
</div>
|
||||
|
||||
<section class="diag">
|
||||
<section class="diag" id="diag">
|
||||
<h3>Diagnostic</h3>
|
||||
<details class="diag-item" id="energy">
|
||||
</section>
|
||||
<!-- Un bloc par domaine, rempli par le script ci-dessous ; le bouton d'action ne sert qu'à Energy. -->
|
||||
<template id="diag-item">
|
||||
<details class="diag-item">
|
||||
<summary>
|
||||
<b>Energy</b>
|
||||
<span class="status" id="status"></span>
|
||||
<span class="meta" id="meta"></span>
|
||||
<b class="name"></b>
|
||||
<span class="status"></span>
|
||||
<span class="meta"></span>
|
||||
<svg class="i chev"><use href="#chev"/></svg>
|
||||
</summary>
|
||||
<div class="diag-body">
|
||||
<p class="headline" id="headline"></p>
|
||||
<table class="days" id="today"></table>
|
||||
<div class="action" id="action" hidden>
|
||||
<button type="button" id="save-mode">Activate energy save mode</button>
|
||||
<span class="meta" id="save-note">The station sleeps between measurements to use less energy.</span>
|
||||
<p class="headline"></p>
|
||||
<table class="days"></table>
|
||||
<div class="action" hidden>
|
||||
<button type="button">Activate energy save mode</button>
|
||||
<span class="note meta">The station sleeps between measurements to use less energy.</span>
|
||||
</div>
|
||||
<details class="sub" id="history">
|
||||
<details class="sub history">
|
||||
<summary>Full history</summary>
|
||||
<div id="daily"></div>
|
||||
<div class="plot"></div>
|
||||
</details>
|
||||
<details class="sub" id="guide">
|
||||
<details class="sub">
|
||||
<summary>Guide</summary>
|
||||
<div class="guide" id="guide-body"></div>
|
||||
<div class="guide"></div>
|
||||
</details>
|
||||
</div>
|
||||
</details>
|
||||
</section>
|
||||
</template>
|
||||
|
||||
<div class="collapse">BusVoltage <svg><use href="#chev"/></svg></div>
|
||||
<div id="chart"></div>
|
||||
@@ -167,20 +170,25 @@
|
||||
|
||||
<script>
|
||||
const DATA = /*DATA*/null;
|
||||
const DAILY = /*DAILY*/null; // figure de DAILY_BATTERY_STATE et DAILY_BATTERY_TREND (D-021), telle que le site la reçoit
|
||||
const R = DATA.rule, E = DATA.energy, cur = E.cur || {};
|
||||
const R = DATA.rule;
|
||||
const NAME = { GREEN: "Green", ORANGE: "Orange", RED: "Red" };
|
||||
const ACTION = { GREEN: "Nothing to do", ORANGE: "Watch", RED: "Contact support" };
|
||||
// Une phrase de très haut niveau, sans détail (manuel, partie 1, § 2).
|
||||
const HEADLINE = {
|
||||
GREEN: "The station is receiving enough energy.",
|
||||
ORANGE: "The station's energy supply is uncertain.",
|
||||
RED: "The station is not receiving enough energy.",
|
||||
};
|
||||
// Nom du bloc, et ce qu'il évalue (phrase d'un jour inconnu). Les phrases des couleurs viennent de src/<domaine>/day_color.py.
|
||||
const DOMAIN = { energy: ["Energy", "energy"], storage: ["Storage", "storage space"], cellular: ["Cellular", "4G connection"],
|
||||
temperature: ["Temperature", "temperature"] };
|
||||
const TREND = { BETTER: "↗ Better than the day before", STABLE: "→ Same as the day before", WORSE: "↘ Worse than the day before" };
|
||||
|
||||
// Échelle de batterie : niveau de fin de nuit (le meilleur repère du niveau, docs/energy/domaine/comment-se-comporte-la-batterie.md),
|
||||
// placé en % par la table OCV LiFePO4 du collecteur (docs/aimsight/collecteur_system_info.py, LIFEPO4_OCV_SOC).
|
||||
// Échelle : zones [borne haute en %, nom, teinte, ...], trait à pct %, texte dessous ; le survol donne la valeur mesurée.
|
||||
const TINT = { bad: "#f1c0c0", low: "#f8dca8", ok: "#e4ebdc", good: "#bfe0bf" };
|
||||
const scale = (zones, pct, text, title = "") =>
|
||||
`<div class="gauge" role="img" aria-label="${text}" title="${title}">` +
|
||||
zones.map(([hi, name, tint], i) =>
|
||||
`<span style="width:${hi - (i ? zones[i - 1][0] : 0)}%;border-color:${TINT[tint]}">${name}</span>`).join("") +
|
||||
`<i style="left:${pct}%"></i></div><div class="gauge-text">${text}</div>`;
|
||||
|
||||
// Energy. Échelle de batterie : niveau de fin de nuit (le meilleur repère du niveau,
|
||||
// docs/energy/domaine/comment-se-comporte-la-batterie.md), placé en % par la table OCV LiFePO4 du collecteur
|
||||
// (docs/aimsight/collecteur_system_info.py, LIFEPO4_OCV_SOC).
|
||||
// ponytail: sans compensation IR (la nuit, ~0,14 V sous la tension à vide) : repère un peu bas ; compenser avec BusCurrent si besoin.
|
||||
const OCV = [[10.0, 0], [12.0, 10], [12.5, 20], [12.8, 30], [12.9, 40], [13.0, 50], [13.1, 60], [13.2, 70], [13.3, 80],
|
||||
[13.4, 90], [13.6, 100]];
|
||||
@@ -193,42 +201,97 @@ const soc = x => {
|
||||
};
|
||||
// Zones, aux points de la table : 10 % = 12,0 V (la station s'éteint dessous), 30 % = coude 12,8 V, 90 % = 13,4 V.
|
||||
// Pas de % affiché : sur le plateau (30-90 %), 0,1 V vaut ~10 % de charge, la tension n'en dit pas plus.
|
||||
const ZONES = [[10, "Off", "nearly empty, the station may shut down"], [30, "Low", "low (under 30 %)"],
|
||||
[90, "OK", "between 30 and 90 %"], [100, "Full", "full"]];
|
||||
const ZONES = [[10, "Off", "bad", "nearly empty, the station may shut down"], [30, "Low", "low", "low (under 30 %)"],
|
||||
[90, "OK", "ok", "between 30 and 90 %"], [100, "Full", "good", "full"]];
|
||||
const recharge = d => d.max_v == null ? "" : d.max_v >= R.full_charge_v ? "fully recharged today"
|
||||
: d.rise_v >= R.min_rise_v ? "partially recharged today" : "not recharged today";
|
||||
function gauge(d) {
|
||||
function battery(d) {
|
||||
if (d.night_end_v == null) return "Unknown";
|
||||
const pct = soc(d.night_end_v), zone = ZONES.find(z => pct < z[0]) || ZONES[ZONES.length - 1];
|
||||
const text = `This morning: ${zone[2]} · ${recharge(d)}`;
|
||||
return `<div class="gauge" role="img" aria-label="${text}" title="night end ${d.night_end_v.toFixed(3)} V">` +
|
||||
ZONES.map(([hi, name], i) => `<span style="width:${hi - (i ? ZONES[i - 1][0] : 0)}%">${name}</span>`).join("") +
|
||||
`<i style="left:${pct}%"></i></div><div class="gauge-text">${text}</div>`;
|
||||
return scale(ZONES, pct, `This morning: ${zone[3]} · ${recharge(d)}`, `night end ${d.night_end_v.toFixed(3)} V`);
|
||||
}
|
||||
|
||||
// Storage. Échelle de l'espace libre en fin de jour, sur les planchers de DAILY_STORAGE_STATE (arbitraires, D-034).
|
||||
function freeSpace(d) {
|
||||
if (d.free_percent == null) return "Unknown";
|
||||
const [ok, low] = R.storage_floors;
|
||||
return scale([[low, "Critical", "bad"], [ok, "Low", "low"], [100, "OK", "good"]], d.free_percent,
|
||||
`${Math.round(d.free_percent)} % free`, `${d.free_gb} GiB free of ${d.usable_gb} GiB usable`);
|
||||
}
|
||||
// Date de saturation au rythme des 7 derniers jours (DAYS_UNTIL_STORAGE_FULL) ; en mois au-delà de 60 jours (affichage).
|
||||
const day = s => new Date(s).toLocaleDateString("en-GB", { day: "2-digit", month: "short", year: "numeric", timeZone: "UTC" });
|
||||
function full(d) {
|
||||
if (d.filling == null) return "Unknown (not enough days measured yet)";
|
||||
if (!d.filling) return "Not expected: the storage is not filling up";
|
||||
const n = d.days_until_full;
|
||||
return `Around ${day(d.full_date)} (about ${n < 60 ? `${Math.round(n)} days` : `${Math.round(n / 30)} months`})`;
|
||||
}
|
||||
|
||||
// Cellular. Envois du jour (DAILY_LINK_STATE), en mots, sur les envois attendus (un toutes les 15 min).
|
||||
function sends(d) {
|
||||
if (d.state == null) return "Unknown (incomplete day)";
|
||||
const missing = d.n_missing ? `${d.n_missing} of ${R.expected_sends} sends missing` : "";
|
||||
if (d.state === "DOWN") return ["4G link reported down", missing].filter(Boolean).join(" · ");
|
||||
if (d.state === "MISSING") return missing || "Some data missing";
|
||||
return "All data received";
|
||||
}
|
||||
// Échelle du signal (DAILY_SIGNAL_STATE, grille publiée) : quatre classes de même largeur, trait au milieu de la classe du jour,
|
||||
// sans dBm. La classe ne change pas la couleur du jour tant que le signal est mesuré (D-037).
|
||||
const SIGNAL = [[25, "Cell edge", "low"], [50, "Mid cell", "ok"], [75, "Good", "ok"], [100, "Excellent", "good"]];
|
||||
function signal(d) {
|
||||
if (d.signal_state == null) return "Unknown (not measured for most of the day)";
|
||||
const i = R.signal_classes.length - 1 - R.signal_classes.indexOf(d.signal_state); // CLASSES va du meilleur au pire
|
||||
return scale(SIGNAL, 25 * i + 12.5, SIGNAL[i][1]);
|
||||
}
|
||||
|
||||
// Temperature. Plus haute moyenne horaire du GPU sur 24 h (DAILY_GPU_TEMPERATURE_LIMIT) et limite du constructeur (D-040) ;
|
||||
// un °C se comprend sans être spécialiste. Pas d'échelle : ses bornes d'affichage n'auraient pas de source.
|
||||
const hottest = d => d.max_deg_c == null ? "Unknown (not measured in the last 24 hours)"
|
||||
: `${Math.round(d.max_deg_c)} °C · limit ${R.gpu_limit_deg_c} °C`;
|
||||
|
||||
// Deux lignes par bloc (une pour Temperature), en mots simples (côté client : pas de tension brute, pas de mécanisme d'analyse).
|
||||
const ROWS = {
|
||||
energy: d => [["Battery", battery(d)], ["Trend", TREND[d.trend] || "Unknown"]],
|
||||
storage: d => [["Free space", freeSpace(d)], ["Full", full(d)]],
|
||||
cellular: d => [["Data sent", sends(d)], ["Signal", signal(d)]],
|
||||
temperature: d => [["Hottest (24 h)", hottest(d)]],
|
||||
};
|
||||
const chip = c => `<span class="status ${c || "UNKNOWN"}">${NAME[c] || "Unknown"}</span>`;
|
||||
function autoscale(plotId) {
|
||||
/*AUTOSCALE*/
|
||||
}
|
||||
|
||||
// Bloc Energy : la couleur du jour, l'échelle de batterie et la tendance face à la veille.
|
||||
document.getElementById("status").outerHTML = chip(cur.color);
|
||||
document.getElementById("meta").textContent = `${E.label} · ${ACTION[cur.color] || "Check data"}`;
|
||||
document.getElementById("headline").textContent = HEADLINE[cur.color] || "Not enough data to assess the station's energy.";
|
||||
document.getElementById("today").innerHTML = [["Battery", gauge(cur)], ["Trend", TREND[cur.trend] || "Unknown"]]
|
||||
.map(([k, x]) => `<tr><th>${k}</th><td>${x}</td></tr>`).join("");
|
||||
document.getElementById("guide-body").innerHTML = marked.parse(DATA.guide); // texte du projet, pas une saisie
|
||||
// Remède proposé au client quand l'énergie manque : veille profonde entre les mesures
|
||||
// (docs/energy/domaine/comment-se-comporte-la-batterie.md). Action de la plateforme, pas du diagnostic (lecture seule).
|
||||
// Maquette : le bouton n'envoie rien.
|
||||
document.getElementById("action").hidden = !["ORANGE", "RED"].includes(cur.color);
|
||||
document.getElementById("save-mode").onclick = () =>
|
||||
document.getElementById("save-note").textContent = "Mockup: no command is sent to the station.";
|
||||
|
||||
// L'historique complet n'est tracé qu'à la première ouverture (un graphique caché n'a pas de largeur).
|
||||
document.getElementById("history").addEventListener("toggle", e => {
|
||||
if (!e.target.open || e.target.dataset.drawn) return;
|
||||
e.target.dataset.drawn = "1";
|
||||
Plotly.newPlot("daily", DAILY.data, DAILY.layout, { responsive: true, scrollZoom: true }).then(() => {
|
||||
/*AUTOSCALE*/
|
||||
for (const [key, dom] of Object.entries(DATA.domains)) {
|
||||
const cur = dom.cur || {}, c = cur.color, [name, what] = DOMAIN[key];
|
||||
const el = document.getElementById("diag-item").content.firstElementChild.cloneNode(true);
|
||||
el.id = key;
|
||||
el.querySelector(".name").textContent = name;
|
||||
el.querySelector(".status").outerHTML = chip(c);
|
||||
// Energy : sur secteur ou non, visible sans ouvrir le bloc (DAILY_POWER_SOURCE, D-043) ; null = statut inconnu.
|
||||
if (key === "energy") el.querySelector(".status").insertAdjacentHTML("afterend",
|
||||
`<span class="power">${R.power_label[cur.power ?? null]}</span>`);
|
||||
el.querySelector(".meta").textContent = `${DATA.label} · ${ACTION[c] || "Check data"}`;
|
||||
el.querySelector(".headline").textContent = dom.headline[c] || `Not enough data to assess the station's ${what}.`;
|
||||
el.querySelector(".days").innerHTML = ROWS[key](cur).map(([k, x]) => `<tr><th>${k}</th><td>${x}</td></tr>`).join("");
|
||||
el.querySelector(".guide").innerHTML = marked.parse(dom.guide); // texte du projet, pas une saisie
|
||||
// Energy, jours Orange et Red : remède proposé au client, veille profonde entre les mesures
|
||||
// (docs/energy/domaine/comment-se-comporte-la-batterie.md). Action de la plateforme, pas du diagnostic (lecture seule).
|
||||
// Maquette : le bouton n'envoie rien. Storage, Cellular et Temperature n'ont pas de remède connu : pas de bouton.
|
||||
const action = el.querySelector(".action");
|
||||
action.hidden = key !== "energy" || !["ORANGE", "RED"].includes(c);
|
||||
action.querySelector("button").onclick = () =>
|
||||
action.querySelector(".note").textContent = "Mockup: no command is sent to the station.";
|
||||
// L'historique complet n'est tracé qu'à la première ouverture (un graphique caché n'a pas de largeur).
|
||||
const plot = el.querySelector(".plot");
|
||||
plot.id = `plot-${key}`;
|
||||
el.querySelector(".history").addEventListener("toggle", e => {
|
||||
if (!e.target.open || e.target.dataset.drawn) return;
|
||||
e.target.dataset.drawn = "1";
|
||||
Plotly.newPlot(plot, dom.figure.data, dom.figure.layout, { responsive: true, scrollZoom: true })
|
||||
.then(() => autoscale(plot.id));
|
||||
});
|
||||
});
|
||||
document.getElementById("diag").append(el);
|
||||
}
|
||||
|
||||
document.getElementById("table").innerHTML =
|
||||
DATA.table.map(([k, x]) => `<tr><td>${k}</td><td>${x}</td></tr>`).join("");
|
||||
@@ -11,60 +11,18 @@ from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular import link_state as ls, signal_state as ss # noqa: E402
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from cellular.final import TITLES, analysis_panels # noqa: E402 (panneaux partagés avec la figure du site)
|
||||
|
||||
# Couleurs validées par le skill dataviz (toutes paires, fond blanc ; vert/rouge refusé : deutéranopie).
|
||||
# Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol.
|
||||
GRAY = ("#8c8c8c", "circle-open")
|
||||
LINK_STYLE = {"UP": ("#008300", "circle"), "MISSING": ("#eda100", "diamond"), "DOWN": ("#4a3aa7", "x"), None: GRAY}
|
||||
CLASS_STYLE = {"EXCELLENT": ("#008300", "circle"), "GOOD": ("#2a78d6", "square"),
|
||||
"MID_CELL": ("#eda100", "diamond"), "CELL_EDGE": ("#4a3aa7", "x"), None: GRAY}
|
||||
METRICS = ["rsrp_dBm", "rsrq_dB", "rssi_dbm", "ber_percent"] # liste explicite : jamais SIM_CCID ni ip
|
||||
|
||||
|
||||
def hover(p):
|
||||
return f"{p['t']:%Y-%m-%d}<br>" + "<br>".join(f"{k}={v}" for k, v in p["facts"].items())
|
||||
|
||||
|
||||
def state_markers(fig, pts, y_key, state_key, styles, row, group):
|
||||
"""Un marqueur par jour à midi, une trace par état (légende et symbole propres)."""
|
||||
for state, (color, symbol) in styles.items():
|
||||
sel = [p for p in pts if p["facts"].get(state_key) == state and p["facts"].get(y_key) is not None]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"][y_key] for p in sel],
|
||||
name=f"{state or 'inconnu'}", mode="markers", text=[hover(p) for p in sel],
|
||||
hovertemplate="%{text}<extra></extra>",
|
||||
marker=dict(color=color, symbol=symbol, size=9, line=dict(color="white", width=1)),
|
||||
row=row, col=1, **group)
|
||||
|
||||
|
||||
def floors_panel(fig, result, row, y_key, class_key, floors, unit):
|
||||
"""Panneau DAILY_SIGNAL_STATE pour une mesure : médiane du jour, planchers de la grille, classe en marqueurs."""
|
||||
group = dict(legendgroup=f"{result['analysis']} {unit}", legendgrouptitle_text=f"{result['analysis']} ({unit})")
|
||||
pts = result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["facts"].get(y_key) for p in pts], name="médiane du jour", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, c in zip(floors, ss.CLASSES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"plancher {c} {f} {unit}", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=CLASS_STYLE[c][0], dash="dash", width=1), row=row, col=1, **group)
|
||||
state_markers(fig, pts, y_key, class_key, CLASS_STYLE, row, group)
|
||||
fig.update_yaxes(title_text=f"médiane du jour [{unit}]", row=row, col=1)
|
||||
|
||||
|
||||
def figure(station, series, link, signal):
|
||||
titles = [f"Analyse {ls.RULE['id']}", f"Analyse {ss.RULE['id']} : RSRP", f"Analyse {ss.RULE['id']} : RSRQ"]
|
||||
fig = make_subplots(rows=len(titles) + len(METRICS) + 1, cols=1, shared_xaxes=True, vertical_spacing=0.03,
|
||||
subplot_titles=titles + METRICS + ["envois reçus par heure (last_sync, sinon link)"])
|
||||
group = dict(legendgroup=ls.RULE["id"], legendgrouptitle_text=f"Analyse {ls.RULE['id']}")
|
||||
state_markers(fig, link["points"], "received_percent", "state", LINK_STYLE, 1, group)
|
||||
fig.update_yaxes(title_text="envois reçus [%]", row=1, col=1)
|
||||
floors_panel(fig, signal, 2, "rsrp_median_dbm", "rsrp_class", ss.RSRP_FLOORS_DBM, "dBm")
|
||||
floors_panel(fig, signal, 3, "rsrq_median_db", "rsrq_class", ss.RSRQ_FLOORS_DB, "dB")
|
||||
def figure(station, series):
|
||||
fig = make_subplots(rows=len(TITLES) + len(METRICS) + 1, cols=1, shared_xaxes=True, vertical_spacing=0.03,
|
||||
subplot_titles=TITLES + METRICS + ["envois reçus par heure (last_sync, sinon link)"])
|
||||
analysis_panels(fig, series)
|
||||
|
||||
mesures = dict(legendgroup="mesures", legendgrouptitle_text="Mesures")
|
||||
row = len(titles)
|
||||
row = len(TITLES)
|
||||
for row, m in enumerate(METRICS, start=row + 1):
|
||||
s = series.get(m, {})
|
||||
fig.add_scatter(x=sorted(s), y=[s[t] for t in sorted(s)], name=m, line=dict(width=1), row=row, col=1,
|
||||
@@ -90,7 +48,7 @@ def main(paths):
|
||||
print(f"{station} : ignorée, pas de mesures du modem (rsrp_dBm, et link ou last_sync)")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_cellular.html"
|
||||
figure(station, series, ls.run(series), ss.run(series)).write_html(
|
||||
figure(station, series).write_html(
|
||||
path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
print(path)
|
||||
written.append(path)
|
||||
|
||||
@@ -15,9 +15,10 @@ MATRIX = {
|
||||
"DOWN": {**dict.fromkeys(KNOWN, "ORANGE"), None: "RED"},
|
||||
}
|
||||
|
||||
# Une phrase par couleur notifiée, en anglais (D-023) ; Green ne notifie rien (D-025).
|
||||
HEADLINE = {"RED": "The station stopped sending data for a large part of the day.",
|
||||
"ORANGE": "The station's 4G connection showed interruptions."}
|
||||
# Une phrase par couleur, en anglais (D-023) ; Green ne notifie rien (D-025), sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station sent all its data over 4G.",
|
||||
"ORANGE": "The station's 4G connection showed interruptions.",
|
||||
"RED": "The station stopped sending data for a large part of the day."}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
|
||||
@@ -0,0 +1,103 @@
|
||||
"""Analyses de la couleur du jour Cellular (D-037) : DAILY_LINK_STATE et DAILY_SIGNAL_STATE, en une figure pour le site (D-021).
|
||||
|
||||
Usage : python3 src/cellular/final.py [CSV ou dossiers...] (défaut : data/WEISSHORN/ et data/NORDEND/)
|
||||
Écrit out/<STATION>_cellular_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
|
||||
Documentation : docs/cellular/analyses/daily_link_state.md et daily_signal_state.md ; guide docs/cellular/guide/
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common, energy et cellular
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular import link_state as ls, signal_state as ss # noqa: E402
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
|
||||
# Couleurs validées par le skill dataviz (toutes paires, fond blanc ; vert/rouge refusé : deutéranopie).
|
||||
# Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol.
|
||||
GRAY = ("#8c8c8c", "circle-open")
|
||||
LINK_STYLE = {"UP": ("#008300", "circle"), "MISSING": ("#eda100", "diamond"), "DOWN": ("#4a3aa7", "x"), None: GRAY}
|
||||
CLASS_STYLE = {"EXCELLENT": ("#008300", "circle"), "GOOD": ("#2a78d6", "square"),
|
||||
"MID_CELL": ("#eda100", "diamond"), "CELL_EDGE": ("#4a3aa7", "x"), None: GRAY}
|
||||
|
||||
|
||||
def hover(p):
|
||||
return f"{p['t']:%Y-%m-%d}<br>" + "<br>".join(f"{k}={v}" for k, v in p["facts"].items())
|
||||
|
||||
|
||||
def state_markers(fig, pts, y_key, state_key, styles, row, group):
|
||||
"""Un marqueur par jour à midi, une trace par état (légende et symbole propres)."""
|
||||
for state, (color, symbol) in styles.items():
|
||||
sel = [p for p in pts if p["facts"].get(state_key) == state and p["facts"].get(y_key) is not None]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"][y_key] for p in sel],
|
||||
name=f"{state or 'unknown'}", mode="markers", text=[hover(p) for p in sel],
|
||||
hovertemplate="%{text}<extra></extra>",
|
||||
marker=dict(color=color, symbol=symbol, size=9, line=dict(color="white", width=1)),
|
||||
row=row, col=1, **group)
|
||||
|
||||
|
||||
def link_panel(fig, result, row):
|
||||
"""Panneau DAILY_LINK_STATE : part des envois reçus par jour, état en marqueurs (fiche daily_link_state)."""
|
||||
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}")
|
||||
state_markers(fig, result["points"], "received_percent", "state", LINK_STYLE, row, group)
|
||||
fig.update_yaxes(title_text="sends received [%]", row=row, col=1)
|
||||
|
||||
|
||||
def floors_panel(fig, result, row, y_key, class_key, floors, unit):
|
||||
"""Panneau DAILY_SIGNAL_STATE pour une mesure : médiane du jour, planchers de la grille, classe en marqueurs."""
|
||||
group = dict(legendgroup=f"{result['analysis']} {unit}", legendgrouptitle_text=f"{result['analysis']} ({unit})")
|
||||
pts = result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["facts"].get(y_key) for p in pts], name="daily median", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, c in zip(floors, ss.CLASSES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"{c} floor {f} {unit}", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=CLASS_STYLE[c][0], dash="dash", width=1), row=row, col=1, **group)
|
||||
state_markers(fig, pts, y_key, class_key, CLASS_STYLE, row, group)
|
||||
fig.update_yaxes(title_text=f"daily median [{unit}]", row=row, col=1)
|
||||
|
||||
|
||||
TITLES = [f"Analysis {ls.RULE['id']}", f"Analysis {ss.RULE['id']}: RSRP", f"Analysis {ss.RULE['id']}: RSRQ"]
|
||||
|
||||
|
||||
def analysis_panels(fig, series):
|
||||
"""Les trois panneaux des analyses, rangées 1 à 3 : partagés par la figure du site et la page de comparaison."""
|
||||
link_panel(fig, ls.run(series), 1)
|
||||
signal = ss.run(series)
|
||||
floors_panel(fig, signal, 2, "rsrp_median_dbm", "rsrp_class", ss.RSRP_FLOORS_DBM, "dBm")
|
||||
floors_panel(fig, signal, 3, "rsrq_median_db", "rsrq_class", ss.RSRQ_FLOORS_DB, "dB")
|
||||
|
||||
|
||||
def daily_figure(station, series):
|
||||
"""Graphique pour le site de monitoring : DAILY_LINK_STATE en haut, DAILY_SIGNAL_STATE (RSRP, RSRQ) dessous."""
|
||||
fig = make_subplots(rows=3, cols=1, shared_xaxes=True, vertical_spacing=0.08, subplot_titles=TITLES)
|
||||
analysis_panels(fig, series)
|
||||
fig.update_xaxes(showticklabels=True)
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station}: data sent and 4G signal", height=900, legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
def main(paths):
|
||||
"""Pour chaque station qui a les mesures du modem : out/<STATION>_cellular_daily.html et .json. -> chemins écrits."""
|
||||
(ROOT / "out").mkdir(exist_ok=True)
|
||||
written = []
|
||||
for station, series in sorted(load_stations(paths).items()):
|
||||
if "rsrp_dBm" not in series or not {"link", "last_sync"} & series.keys():
|
||||
print(f"{station} : ignorée, pas de mesures du modem (rsrp_dBm, et link ou last_sync)")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_cellular_daily.html"
|
||||
fig = daily_figure(station, series)
|
||||
fig.write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
fig.write_json(path.with_suffix(".json"))
|
||||
print(path)
|
||||
written.append(path)
|
||||
return written
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
for p in main(sys.argv[1:] or [str(ROOT / "data" / s) for s in ("WEISSHORN", "NORDEND")]):
|
||||
open_html(p)
|
||||
@@ -1,4 +1,4 @@
|
||||
"""Les quatre analyses Energy ensemble, pour les comparer (D-016) : un panneau chacune, puis un graphique par série.
|
||||
"""Les cinq analyses Energy ensemble, pour les comparer (D-016) : un panneau chacune, puis un graphique par série.
|
||||
|
||||
Usage : python3 src/energy/all_analyses.py [CSV ou dossiers...] (défaut : data/VERMONT/)
|
||||
Écrit out/<STATION>_energy.html et l'ouvre. Documentation : docs/energy/analyses/ (une fiche par analyse)
|
||||
@@ -10,8 +10,8 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, moving_average as ma # noqa: E402
|
||||
from energy.final import daily_state_panel, daily_trend_panel # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, power_source as ps, moving_average as ma # noqa: E402
|
||||
from energy.final import daily_state_panel, daily_trend_panel, power_source_panel # noqa: E402
|
||||
|
||||
# Zones de BusVoltage selon l'état de la batterie (bandes de fond) : docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md.
|
||||
# [V] = VERMONT, 5e-95e centiles horaires ; [M] = manuel ; [E] = experts. Les zones « en charge » et « décharge »
|
||||
@@ -38,6 +38,9 @@ def figure(station, series, results):
|
||||
if result["analysis"] == bt.RULE["id"]:
|
||||
daily_trend_panel(fig, result, row)
|
||||
continue
|
||||
if result["analysis"] == ps.RULE["id"]:
|
||||
power_source_panel(fig, result, row)
|
||||
continue
|
||||
analyse = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}")
|
||||
thr = result["rule"]["threshold_v"]
|
||||
pts = result["points"]
|
||||
@@ -82,7 +85,7 @@ def main(paths):
|
||||
print(f"{station} : ignorée, pas de BusVoltage")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_energy.html"
|
||||
results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series)]
|
||||
results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series), ps.run(series)]
|
||||
figure(station, series, results).write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS,
|
||||
config={"scrollZoom": True})
|
||||
print(path)
|
||||
|
||||
+22
-6
@@ -1,11 +1,12 @@
|
||||
"""Couleur du jour : matrice état (DAILY_BATTERY_STATE) × tendance (DAILY_BATTERY_TREND) -> vert / orange / rouge (D-020).
|
||||
"""Couleur du jour : sur secteur (DAILY_POWER_SOURCE), la perte du secteur décide (D-043) ; sinon, matrice
|
||||
état (DAILY_BATTERY_STATE) × tendance (DAILY_BATTERY_TREND) -> vert / orange / rouge (D-020).
|
||||
|
||||
Documentation : docs/energy/guide/diagnostic-energetique.md (§ 7, la matrice)
|
||||
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
||||
"""
|
||||
from datetime import timedelta
|
||||
|
||||
from energy import battery_state as bs, battery_trend as bt
|
||||
from energy import battery_state as bs, battery_trend as bt, power_source as ps
|
||||
|
||||
# Matrice tenue par l'utilisateur dans docs/energy/matrice-etat-tendance.drawio : MATRIX[état][tendance].
|
||||
MATRIX = {
|
||||
@@ -15,20 +16,35 @@ MATRIX = {
|
||||
"BELOW_PLATEAU": {"BETTER": "RED", "STABLE": "RED", "WORSE": "RED"},
|
||||
}
|
||||
|
||||
# Une phrase par couleur, en anglais (D-023), reprise par la vue client et par les notifications du support.
|
||||
# Green ne notifie rien (D-025) : sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station is receiving enough energy.",
|
||||
"ORANGE": "The station's energy supply is uncertain.",
|
||||
"RED": "The station is not receiving enough energy."}
|
||||
|
||||
# Statut d'alimentation (DAILY_POWER_SOURCE), en anglais (D-023), repris par les notifications du support.
|
||||
POWER_LABEL = {"MAINS": "On mains", "NOT_MAINS": "Not on mains", None: "Mains unknown"}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
"verdict": "aucun : anomaly = None ; la couleur est dans facts.color (None = inconnu, état ou tendance absent)",
|
||||
"mains": "power = MAINS : RED si une heure de J < mains_lost_v (hours_lost > 0), sinon GREEN ; la matrice sinon",
|
||||
"mains_lost_v": ps.MAINS_LOST_V,
|
||||
"matrix": MATRIX,
|
||||
"doc": "docs/energy/guide/diagnostic-energetique.md",
|
||||
}
|
||||
|
||||
|
||||
def run(series):
|
||||
"""Couleur du jour, causale comme DAILY_BATTERY_STATE et DAILY_BATTERY_TREND (J et J−1). Un point par jour UTC."""
|
||||
"""Couleur du jour, causale comme ses trois analyses (J, J−1, et les 3 jours avant J). Un point par jour UTC."""
|
||||
points = []
|
||||
for s, t in zip(bs.run(series)["points"], bt.run(series)["points"]): # mêmes jours, même ordre (bt part de bs)
|
||||
facts = {**s["facts"], **t["facts"]}
|
||||
facts["color"] = MATRIX.get(facts["state"], {}).get(facts["trend"])
|
||||
# Mêmes jours, même ordre : bt part de bs, ps parcourt les mêmes horodatages de BusVoltage.
|
||||
for s, t, m in zip(bs.run(series)["points"], bt.run(series)["points"], ps.run(series)["points"]):
|
||||
facts = {**s["facts"], **t["facts"], **m["facts"]}
|
||||
if facts["power"] == "MAINS": # batterie toujours pleine : une heure sans chargeur suffit, sans attendre J+1
|
||||
facts["color"] = None if facts["hours_lost"] is None else "RED" if facts["hours_lost"] else "GREEN"
|
||||
else: # sur batterie (solaire), ou statut inconnu
|
||||
facts["color"] = MATRIX.get(facts["state"], {}).get(facts["trend"])
|
||||
points.append({"t": s["t"], "value": facts["color"], "anomaly": None, "facts": facts})
|
||||
return {"analysis": RULE["id"], "rule": RULE, "points": points}
|
||||
|
||||
|
||||
+45
-7
@@ -1,8 +1,8 @@
|
||||
"""Analyses livrées (D-020) : DAILY_BATTERY_STATE et DAILY_BATTERY_TREND, en une figure pour le site (D-021).
|
||||
"""Analyses livrées (D-020, D-043) : DAILY_BATTERY_STATE, DAILY_BATTERY_TREND et DAILY_POWER_SOURCE, en une figure pour le site (D-021).
|
||||
|
||||
Usage : python3 src/energy/final.py [CSV ou dossiers...] (défaut : data/VERMONT/)
|
||||
Écrit out/<STATION>_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
|
||||
Documentation : docs/energy/analyses/daily_battery_state.md et daily_battery_trend.md
|
||||
Documentation : docs/energy/analyses/daily_battery_state.md, daily_battery_trend.md et daily_power_source.md
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
@@ -13,7 +13,7 @@ from datetime import datetime, time, timezone # noqa: E402
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, power_source as ps # noqa: E402
|
||||
|
||||
# États de DAILY_BATTERY_STATE : couleurs validées par le skill dataviz (toutes paires, fond blanc).
|
||||
# Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol.
|
||||
@@ -86,15 +86,53 @@ def daily_trend_panel(fig, result, row):
|
||||
fig.update_yaxes(title_text="Δ night end [V]", row=row, col=1)
|
||||
|
||||
|
||||
# Statuts de DAILY_POWER_SOURCE : paire bleu/rouge et gris neutre déjà validés (TREND_STYLE), chacun avec son symbole.
|
||||
POWER_STYLE = {"MAINS": ("on mains", "#2a78d6", "circle"), "NOT_MAINS": ("not on mains", "#8c8c8c", "circle-open")}
|
||||
|
||||
|
||||
def power_source_panel(fig, result, row):
|
||||
"""Panneau DAILY_POWER_SOURCE : moyenne des 3 jours avant J (statut en marqueurs), minimum de J (perte en croix)."""
|
||||
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}")
|
||||
rule, pts = result["rule"], result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["facts"]["mean_3_days_v"] for p in pts], name="3-day mean (days before)", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
fig.add_scatter(x=x, y=[p["facts"]["min_v"] for p in pts], name="daily minimum", mode="lines",
|
||||
line=dict(color="#9a9893", width=1.5), hovertemplate="daily minimum %{y:.2f} V<extra></extra>",
|
||||
row=row, col=1, **group)
|
||||
# Seuils tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for v, name, color in ((rule["mains_mean_v"], "mains", "#2a78d6"), (rule["mains_lost_v"], "mains lost", "#d03b3b")):
|
||||
fig.add_scatter(x=x, y=[v] * len(x), name=f"{name} {v} V", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=color, dash="dash", width=1), row=row, col=1, **group)
|
||||
hover = lambda p, label: (f"{p['t']:%Y-%m-%d}: {label}<br>" # noqa: E731
|
||||
+ "<br>".join(f"{k}={val}" for k, val in p["facts"].items()))
|
||||
for power, (label, color, symbol) in POWER_STYLE.items():
|
||||
sel = [p for p in pts if p["facts"]["power"] == power]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"]["mean_3_days_v"] for p in sel],
|
||||
name=label, mode="markers", marker=dict(color=color, symbol=symbol, size=8),
|
||||
text=[hover(p, label) for p in sel], hovertemplate="%{text}<extra></extra>",
|
||||
row=row, col=1, **group)
|
||||
sel = [p for p in pts if p["facts"]["hours_lost"]]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"]["min_v"] for p in sel],
|
||||
name="mains lost", mode="markers", marker=dict(color="#d03b3b", symbol="x", size=9),
|
||||
text=[hover(p, f"mains lost, {p['facts']['hours_lost']} h") for p in sel],
|
||||
hovertemplate="%{text}<extra></extra>", row=row, col=1, **group)
|
||||
fig.update_yaxes(title_text="BusVoltage [V]", row=row, col=1)
|
||||
|
||||
|
||||
def daily_figure(station, series):
|
||||
"""Graphique pour le site de monitoring (D-021) : DAILY_BATTERY_STATE en haut, DAILY_BATTERY_TREND dessous, même axe du temps."""
|
||||
fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08,
|
||||
subplot_titles=[f"Analysis {bs.RULE['id']}", f"Analysis {bt.RULE['id']}"])
|
||||
"""Graphique pour le site de monitoring (D-021) : DAILY_BATTERY_STATE en haut, DAILY_BATTERY_TREND dessous,
|
||||
puis DAILY_POWER_SOURCE (D-043), même axe du temps."""
|
||||
fig = make_subplots(rows=3, cols=1, shared_xaxes=True, vertical_spacing=0.06,
|
||||
subplot_titles=[f"Analysis {r['id']}" for r in (bs.RULE, bt.RULE, ps.RULE)])
|
||||
daily_state_panel(fig, bs.run(series), 1)
|
||||
daily_trend_panel(fig, bt.run(series), 2)
|
||||
power_source_panel(fig, ps.run(series), 3)
|
||||
fig.update_xaxes(showticklabels=True)
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station}: battery state and trend", height=700, barmode="overlay",
|
||||
fig.update_layout(title=f"{station}: battery state and trend, mains power", height=1000, barmode="overlay",
|
||||
legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
@@ -12,10 +12,10 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c
|
||||
from common.page import ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
import plotly.graph_objects as go # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, day_color as dc, power_source as ps # noqa: E402
|
||||
from energy.final import STATE_STYLE, TREND_STYLE, noon # noqa: E402
|
||||
|
||||
# Statuts : noms et couleurs de la maquette System Summary (maquettes/user/energy_template.html).
|
||||
# Statuts : noms et couleurs de la maquette System Summary (maquettes/user/summary_template.html).
|
||||
COLOR = {"GREEN": ("Green", "#008300"), "ORANGE": ("Orange", "#eda100"), "RED": ("Red", "#d03b3b"),
|
||||
None: ("Unknown", "#8c8c8c")}
|
||||
# Condition qui a donné l'état (fiche daily_battery_state, « Principe », dans l'ordre d'évaluation).
|
||||
@@ -37,8 +37,13 @@ def parse_day(arg, series):
|
||||
def summary(station, f):
|
||||
"""Résumé texte traçable : couleur, règle, faits de J−1 et de J, tendance et ce qui l'a décidée."""
|
||||
d, prev, cur = f["day"], f["prev"], f["cur"]
|
||||
lines = [f"{station}, {d:%d/%m/%Y}: {COLOR[f['color']][0]}",
|
||||
f" rule: matrix state × trend (user manual § 7): {cur['state']} × {cur['trend']} → {f['color'] or 'unknown'}"]
|
||||
lines = [f"{station}, {d:%d/%m/%Y}: {COLOR[f['color']][0]}"]
|
||||
if cur["power"] == "MAINS": # sur secteur, la perte du secteur décide (fiche daily_power_source)
|
||||
lines.append(f" rule: on mains (3-day mean {cur['mean_3_days_v']} V ≥ {ps.MAINS_MEAN_V} V):"
|
||||
f" {cur['hours_lost']} h < {ps.MAINS_LOST_V} V → {f['color'] or 'unknown'}")
|
||||
else:
|
||||
lines.append(f" rule: {dc.POWER_LABEL[cur['power']].lower()}, matrix state × trend (user manual § 7):"
|
||||
f" {cur['state']} × {cur['trend']} → {f['color'] or 'unknown'}")
|
||||
for tag, x, facts in (("D-1", d - timedelta(days=1), prev), ("D ", d, cur)):
|
||||
if not facts or facts.get("max_v") is None:
|
||||
lines.append(f" {tag} {x:%d/%m}: no measurement")
|
||||
@@ -113,7 +118,8 @@ def figure(station, f):
|
||||
ys = [v for v in h.values() if v is not None] + [bs.FULL_CHARGE_V, bs.PLATEAU_FLOOR_V] # seuils toujours visibles
|
||||
fig.update_yaxes(title_text="BusVoltage [V]", range=[min(ys) - 0.15, max(ys) + 0.15])
|
||||
fig.update_layout(title=f"{station}, {d:%d %b %Y}: <span style='color:{color}'>■ {name}</span>"
|
||||
f" · {f['cur']['state']} × {trend or 'unknown trend'}"
|
||||
+ (" · on mains, lost" if f["cur"]["hours_lost"] else " · on mains" if f["cur"]["power"] == "MAINS"
|
||||
else f" · {f['cur']['state']} × {trend or 'unknown trend'}")
|
||||
+ (" · provisional (day not over)" if provisional(f) else "")
|
||||
+ "<br><sup>gray band: no measurement · dashed: thresholds of the daily state"
|
||||
" · arrow: night end D-1 → D (trend)</sup>",
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
"""DAILY_POWER_SOURCE : la station est-elle sur secteur ? Sur secteur, a-t-elle perdu le secteur ce jour-là ?
|
||||
|
||||
Documentation : docs/energy/analyses/daily_power_source.md
|
||||
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
||||
"""
|
||||
import math
|
||||
from collections import defaultdict
|
||||
from datetime import timedelta
|
||||
|
||||
from energy import battery_state as bs
|
||||
|
||||
# Constantes (fiche daily_power_source, « Constantes et sources »).
|
||||
WINDOW_DAYS = 3 # demande de l'utilisateur : moyenne glissante sur les 3 jours qui précèdent J
|
||||
MAINS_MEAN_V = bs.FULL_CHARGE_V # 14,0 V : moyenne sur 3 jours, solaire <= 13,50 V (VERMONT), secteur >= 14,08 V (4 stations)
|
||||
MAINS_LOST_V = 13.4 # haut du plateau (table OCV) : secteur présent >= 13,65 V à l'heure, heure pleine sans secteur 13,11-13,30 V (MISSISSIPPI)
|
||||
MIN_COVERAGE = bs.MIN_COVERAGE # 0,8 : 58 h mesurées sur 72
|
||||
|
||||
RULE = {
|
||||
"id": "DAILY_POWER_SOURCE",
|
||||
"verdict": "aucun : anomaly = None ; le statut est dans facts.power, la perte du secteur dans facts.hours_lost",
|
||||
"window_days": WINDOW_DAYS,
|
||||
"mains_mean_v": MAINS_MEAN_V,
|
||||
"mains_lost_v": MAINS_LOST_V,
|
||||
"min_coverage": MIN_COVERAGE,
|
||||
"doc": "docs/energy/analyses/daily_power_source.md",
|
||||
}
|
||||
|
||||
|
||||
def run(series):
|
||||
"""Analyse DAILY_POWER_SOURCE, causale : le statut de J vient des 3 jours avant J, la perte des heures de J.
|
||||
Un point par jour UTC, les mêmes jours que DAILY_BATTERY_STATE."""
|
||||
v = series["BusVoltage"]
|
||||
days, last = defaultdict(list), {}
|
||||
for t in sorted(v):
|
||||
last[t.date()] = t
|
||||
if v[t] is not None and math.isfinite(v[t]): # NaN/inf = pas de mesure, comme DAILY_BATTERY_STATE
|
||||
days[t.date()].append(v[t])
|
||||
points = []
|
||||
for d in sorted(last):
|
||||
window = [x for k in range(1, WINDOW_DAYS + 1) for x in days.get(d - timedelta(days=k), [])]
|
||||
coverage = len(window) / (24 * WINDOW_DAYS)
|
||||
mean_v = round(sum(window) / len(window), 3) if window else None
|
||||
if coverage < MIN_COVERAGE:
|
||||
power = None # UNKNOWN : trop de trous pour conclure
|
||||
else:
|
||||
power = "MAINS" if mean_v >= MAINS_MEAN_V else "NOT_MAINS"
|
||||
today = days.get(d, [])
|
||||
# Sur secteur seulement : heures de J sous le plateau haut, donc sans chargeur (None : pas sur secteur, ou J sans mesure).
|
||||
hours_lost = sum(x < MAINS_LOST_V for x in today) if power == "MAINS" and today else None
|
||||
facts = {"power": power, "mean_3_days_v": mean_v, "coverage_3_days": round(coverage, 3),
|
||||
"min_v": round(min(today), 3) if today else None, "hours_lost": hours_lost}
|
||||
points.append({"t": last[d], "value": mean_v, "anomaly": None, "facts": facts})
|
||||
return {"analysis": RULE["id"], "rule": RULE, "points": points}
|
||||
@@ -10,40 +10,19 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular.all_analyses import GRAY, hover, state_markers # noqa: E402 (mêmes marqueurs que Cellular)
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from storage import days_until_full as du, storage_state as ss # noqa: E402
|
||||
from storage.final import TITLES, analysis_panels # noqa: E402 (panneaux partagés avec la figure du site)
|
||||
|
||||
# Couleurs de la page Cellular, validées par le skill dataviz.
|
||||
STATE_STYLE = {"OK": ("#008300", "circle"), "LOW": ("#eda100", "diamond"), "CRITICAL": ("#4a3aa7", "x"), None: GRAY}
|
||||
METRICS = ["data_storage_free_gb", "data_storage_used_gb", "data_storage_total_gb"]
|
||||
|
||||
|
||||
def figure(station, series, state, days):
|
||||
titles = [f"Analyse {ss.RULE['id']}", f"Analyse {du.RULE['id']}"]
|
||||
fig = make_subplots(rows=len(titles) + len(METRICS), cols=1, shared_xaxes=True, vertical_spacing=0.04,
|
||||
subplot_titles=titles + METRICS)
|
||||
group = dict(legendgroup=ss.RULE["id"], legendgrouptitle_text=f"Analyse {ss.RULE['id']}")
|
||||
pts = state["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["value"] for p in pts], name="espace libre du jour", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=1, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, s in zip(ss.FREE_PERCENT_FLOORS, ss.STATES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"plancher {s} {f} %", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=STATE_STYLE[s][0], dash="dash", width=1), row=1, col=1, **group)
|
||||
state_markers(fig, pts, "free_percent", "state", STATE_STYLE, 1, group)
|
||||
fig.update_yaxes(title_text="libre / utilisable [%]", row=1, col=1)
|
||||
|
||||
pts = [p for p in days["points"] if p["value"] is not None]
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in pts], y=[p["value"] for p in pts], name="jours avant saturation",
|
||||
mode="lines+markers", text=[hover(p) for p in pts], hovertemplate="%{text}<extra></extra>",
|
||||
line=dict(color="#2a78d6", width=1.5), legendgroup=du.RULE["id"],
|
||||
legendgrouptitle_text=f"Analyse {du.RULE['id']}", row=2, col=1)
|
||||
fig.update_yaxes(title_text="jours restants", row=2, col=1)
|
||||
def figure(station, series):
|
||||
fig = make_subplots(rows=len(TITLES) + len(METRICS), cols=1, shared_xaxes=True, vertical_spacing=0.04,
|
||||
subplot_titles=TITLES + METRICS)
|
||||
analysis_panels(fig, series)
|
||||
|
||||
mesures = dict(legendgroup="mesures", legendgrouptitle_text="Mesures")
|
||||
for row, m in enumerate(METRICS, start=len(titles) + 1):
|
||||
for row, m in enumerate(METRICS, start=len(TITLES) + 1):
|
||||
s = series[m]
|
||||
fig.add_scatter(x=sorted(s), y=[s[t] for t in sorted(s)], name=m, line=dict(width=1), row=row, col=1,
|
||||
**mesures)
|
||||
@@ -66,7 +45,7 @@ def main(paths):
|
||||
print(f"{station} : ignorée, pas de mesures du disque ({', '.join(METRICS)})")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_storage.html"
|
||||
figure(station, series, ss.run(series), du.run(series)).write_html(
|
||||
figure(station, series).write_html(
|
||||
path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
print(path)
|
||||
written.append(path)
|
||||
|
||||
@@ -17,9 +17,10 @@ MATRIX = {
|
||||
"CRITICAL": {"BEYOND_60_DAYS": "RED", "WITHIN_60_DAYS": "RED", "WITHIN_14_DAYS": "RED", None: "RED"},
|
||||
}
|
||||
|
||||
# Une phrase par couleur notifiée, en anglais (D-023) ; Green ne notifie rien (D-025).
|
||||
HEADLINE = {"RED": "The station is about to run out of storage space.",
|
||||
"ORANGE": "The station's storage space is running low."}
|
||||
# Une phrase par couleur, en anglais (D-023) ; Green ne notifie rien (D-025), sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station has enough storage space.",
|
||||
"ORANGE": "The station's storage space is running low.",
|
||||
"RED": "The station is about to run out of storage space."}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
"""Analyses de la couleur du jour Storage (D-035) : DAILY_STORAGE_STATE et DAYS_UNTIL_STORAGE_FULL, en une figure pour le site (D-021).
|
||||
|
||||
Usage : python3 src/storage/final.py [CSV ou dossiers...] (défaut : data/WEISSHORN/)
|
||||
Écrit out/<STATION>_storage_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
|
||||
Documentation : docs/storage/analyses/daily_storage_state.md et days_until_storage_full.md ; guide docs/storage/guide/
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common, energy, cellular et storage
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular.final import GRAY, hover, state_markers # noqa: E402 (mêmes marqueurs que Cellular)
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from storage import days_until_full as du, storage_state as ss # noqa: E402
|
||||
|
||||
# Couleurs de la page Cellular, validées par le skill dataviz.
|
||||
STATE_STYLE = {"OK": ("#008300", "circle"), "LOW": ("#eda100", "diamond"), "CRITICAL": ("#4a3aa7", "x"), None: GRAY}
|
||||
TITLES = [f"Analysis {ss.RULE['id']}", f"Analysis {du.RULE['id']}"]
|
||||
|
||||
|
||||
def state_panel(fig, result, row):
|
||||
"""Panneau DAILY_STORAGE_STATE : espace libre en fin de jour, planchers, état en marqueurs (fiche daily_storage_state)."""
|
||||
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}")
|
||||
pts = result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["value"] for p in pts], name="free space (end of day)", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, s in zip(ss.FREE_PERCENT_FLOORS, ss.STATES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"{s} floor {f} %", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=STATE_STYLE[s][0], dash="dash", width=1), row=row, col=1, **group)
|
||||
state_markers(fig, pts, "free_percent", "state", STATE_STYLE, row, group)
|
||||
fig.update_yaxes(title_text="free / usable [%]", row=row, col=1)
|
||||
|
||||
|
||||
def days_panel(fig, result, row):
|
||||
"""Panneau DAYS_UNTIL_STORAGE_FULL : jours avant saturation, au rythme médian sur 7 jours (fiche days_until_storage_full)."""
|
||||
pts = [p for p in result["points"] if p["value"] is not None]
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in pts], y=[p["value"] for p in pts], name="days until full",
|
||||
mode="lines+markers", text=[hover(p) for p in pts], hovertemplate="%{text}<extra></extra>",
|
||||
line=dict(color="#2a78d6", width=1.5), legendgroup=result["analysis"],
|
||||
legendgrouptitle_text=f"Analysis {result['analysis']}", row=row, col=1)
|
||||
fig.update_yaxes(title_text="days left", row=row, col=1)
|
||||
|
||||
|
||||
def analysis_panels(fig, series):
|
||||
"""Les deux panneaux des analyses, rangées 1 et 2 : partagés par la figure du site et la page de comparaison."""
|
||||
state_panel(fig, ss.run(series), 1)
|
||||
days_panel(fig, du.run(series), 2)
|
||||
|
||||
|
||||
def daily_figure(station, series):
|
||||
"""Graphique pour le site de monitoring : DAILY_STORAGE_STATE en haut, DAYS_UNTIL_STORAGE_FULL dessous."""
|
||||
fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08, subplot_titles=TITLES)
|
||||
analysis_panels(fig, series)
|
||||
fig.update_xaxes(showticklabels=True)
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station}: storage space", height=700, legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
def main(paths):
|
||||
"""Pour chaque station qui a les mesures de /data : out/<STATION>_storage_daily.html et .json. -> chemins écrits."""
|
||||
(ROOT / "out").mkdir(exist_ok=True)
|
||||
written = []
|
||||
for station, series in sorted(load_stations(paths).items()):
|
||||
if "data_storage_free_gb" not in series:
|
||||
print(f"{station} : ignorée, pas de mesures de /data (data_storage_*)")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_storage_daily.html"
|
||||
fig = daily_figure(station, series)
|
||||
fig.write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
fig.write_json(path.with_suffix(".json"))
|
||||
print(path)
|
||||
written.append(path)
|
||||
return written
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
for p in main(sys.argv[1:] or [str(ROOT / "data" / "WEISSHORN")]):
|
||||
open_html(p)
|
||||
Whitespace-only changes.
@@ -0,0 +1,51 @@
|
||||
"""L'analyse Temperature, pour la vérifier (D-016) : le panneau DAILY_GPU_TEMPERATURE_LIMIT, puis la série du GPU.
|
||||
|
||||
Usage : python3 src/temperature/all_analyses.py [CSV ou dossiers...] (défaut : data/WEISSHORN/ et data/NORDEND/)
|
||||
Écrit out/<STATION>_temperature.html et l'ouvre. Documentation : docs/temperature/analyses/daily_gpu_temperature_limit.md
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common, energy et temperature
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from temperature import gpu_temperature_limit as gl # noqa: E402
|
||||
from temperature.final import METRIC, TITLES, analysis_panels # noqa: E402 (panneau partagé avec la figure du site)
|
||||
|
||||
|
||||
def figure(station, series):
|
||||
fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08, subplot_titles=TITLES + [METRIC])
|
||||
analysis_panels(fig, series)
|
||||
|
||||
s = series[METRIC]
|
||||
fig.add_scatter(x=sorted(s), y=[s[t] for t in sorted(s)], name=METRIC, line=dict(width=1), row=2, col=1,
|
||||
legendgroup="mesures", legendgrouptitle_text="Mesures")
|
||||
for a, b in gaps(s):
|
||||
fig.add_vrect(x0=a, x1=b, fillcolor="gray", opacity=0.3, line_width=0, row=2, col=1)
|
||||
fig.update_yaxes(title_text="°C", row=2, col=1)
|
||||
fig.update_xaxes(showticklabels=True) # dates sous chaque graphique, pas seulement le dernier
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station} : analysis {gl.RULE['id']}", height=700, legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
def main(paths):
|
||||
"""Pour chaque station qui a la température du GPU : out/<STATION>_temperature.html. -> chemins écrits."""
|
||||
(ROOT / "out").mkdir(exist_ok=True)
|
||||
written = []
|
||||
for station, series in sorted(load_stations(paths).items()):
|
||||
if METRIC not in series:
|
||||
print(f"{station} : ignorée, pas de {METRIC}")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_temperature.html"
|
||||
figure(station, series).write_html(
|
||||
path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
print(path)
|
||||
written.append(path)
|
||||
return written
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
for p in main(sys.argv[1:] or [str(ROOT / "data" / d) for d in ("WEISSHORN", "NORDEND")]):
|
||||
open_html(p)
|
||||
@@ -0,0 +1,29 @@
|
||||
"""Couleur du jour Temperature : DAILY_GPU_TEMPERATURE_LIMIT seule -> rouge si le GPU a atteint sa limite dans les 24 h (D-040).
|
||||
|
||||
Documentation : docs/temperature/analyses/daily_gpu_temperature_limit.md, docs/decisions.md (D-040)
|
||||
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
||||
"""
|
||||
from temperature import gpu_temperature_limit as gl
|
||||
|
||||
# Une seule analyse, une seule limite sourcée : pas de matrice ni d'orange (D-040).
|
||||
COLOR = {True: "RED", False: "GREEN", None: None}
|
||||
|
||||
# Une phrase par couleur, en anglais (D-023) ; Green ne notifie rien (D-025), sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station's temperature is within the manufacturer's limit.",
|
||||
"RED": "The station overheated in the last 24 hours."}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
"verdict": "aucun : anomaly = None ; la couleur est dans facts.color (None = inconnu)",
|
||||
"color": COLOR,
|
||||
"doc": "docs/decisions.md (D-040)",
|
||||
}
|
||||
|
||||
|
||||
def run(series):
|
||||
"""Couleur du jour, causale comme l'analyse. Un point par jour UTC."""
|
||||
points = []
|
||||
for p in gl.run(series)["points"]:
|
||||
facts = {**p["facts"], "color": COLOR[p["anomaly"]]}
|
||||
points.append({"t": p["t"], "value": facts["color"], "anomaly": None, "facts": facts})
|
||||
return {"analysis": RULE["id"], "rule": RULE, "points": points}
|
||||
@@ -0,0 +1,73 @@
|
||||
"""Analyse de la couleur du jour Temperature (D-040) : DAILY_GPU_TEMPERATURE_LIMIT, en une figure pour le site (D-021).
|
||||
|
||||
Usage : python3 src/temperature/final.py [CSV ou dossiers...] (défaut : data/WEISSHORN/ et data/NORDEND/)
|
||||
Écrit out/<STATION>_temperature_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
|
||||
Documentation : docs/temperature/analyses/daily_gpu_temperature_limit.md ; guide docs/temperature/guide/
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common, energy et temperature
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from temperature import day_color as dc, gpu_temperature_limit as gl # noqa: E402
|
||||
|
||||
METRIC = "sensor_GPU_deg_c"
|
||||
STYLE = {"GREEN": ("#008300", "circle"), "RED": ("#d03b3b", "x"), None: ("#8c8c8c", "circle-open")} # couleurs d'Energy
|
||||
TITLES = [f"Analysis {gl.RULE['id']}"]
|
||||
|
||||
|
||||
def analysis_panels(fig, series):
|
||||
"""Panneau DAILY_GPU_TEMPERATURE_LIMIT, rangée 1 : maximum des 24 h, limite, couleur du jour en marqueurs.
|
||||
Partagé par la figure du site et la page de comparaison (fiche daily_gpu_temperature_limit)."""
|
||||
group = dict(legendgroup=gl.RULE["id"], legendgrouptitle_text=TITLES[0])
|
||||
pts = dc.run(series)["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["facts"].get("max_deg_c") for p in pts], name="max of the last 24 h", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=1, col=1, **group)
|
||||
# Limite tracée comme une courbe (un point par jour) : AUTOSCALE_Y_JS la garde visible au zoom (D-013).
|
||||
fig.add_scatter(x=x, y=[gl.GPU_LIMIT_DEG_C] * len(x), name=f"limit {gl.GPU_LIMIT_DEG_C} °C", mode="lines",
|
||||
hoverinfo="skip", line=dict(color=STYLE["RED"][0], dash="dash", width=1), row=1, col=1, **group)
|
||||
for color, (c, symbol) in STYLE.items():
|
||||
sel = [p for p in pts if p["facts"]["color"] == color]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"].get("max_deg_c", 0) for p in sel],
|
||||
name=color or "unknown", mode="markers", hovertemplate="%{text}<extra></extra>",
|
||||
text=[f"{p['t']:%Y-%m-%d}<br>" + "<br>".join(f"{k}={v}" for k, v in p["facts"].items())
|
||||
for p in sel],
|
||||
marker=dict(color=c, symbol=symbol, size=9, line=dict(color="white", width=1)),
|
||||
row=1, col=1, **group)
|
||||
fig.update_yaxes(title_text="GPU [°C]", row=1, col=1)
|
||||
|
||||
|
||||
def daily_figure(station, series):
|
||||
"""Graphique pour le site de monitoring : le panneau DAILY_GPU_TEMPERATURE_LIMIT seul."""
|
||||
fig = make_subplots(rows=1, cols=1, subplot_titles=TITLES)
|
||||
analysis_panels(fig, series)
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station}: GPU temperature", height=420, legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
def main(paths):
|
||||
"""Pour chaque station qui a la température du GPU : out/<STATION>_temperature_daily.html et .json. -> chemins écrits."""
|
||||
(ROOT / "out").mkdir(exist_ok=True)
|
||||
written = []
|
||||
for station, series in sorted(load_stations(paths).items()):
|
||||
if METRIC not in series:
|
||||
print(f"{station} : ignorée, pas de {METRIC}")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_temperature_daily.html"
|
||||
fig = daily_figure(station, series)
|
||||
fig.write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
fig.write_json(path.with_suffix(".json"))
|
||||
print(path)
|
||||
written.append(path)
|
||||
return written
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
for p in main(sys.argv[1:] or [str(ROOT / "data" / d) for d in ("WEISSHORN", "NORDEND")]):
|
||||
open_html(p)
|
||||
@@ -0,0 +1,39 @@
|
||||
"""DAILY_GPU_TEMPERATURE_LIMIT : le GPU a-t-il atteint sa température maximale de fonctionnement dans les 24 dernières heures ?
|
||||
|
||||
Documentation : docs/temperature/analyses/daily_gpu_temperature_limit.md
|
||||
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
||||
"""
|
||||
import math
|
||||
from datetime import timedelta
|
||||
|
||||
# Constantes (fiche daily_gpu_temperature_limit, « Constantes et sources »).
|
||||
# T.gpu, limite du constructeur : NVIDIA, Jetson Nano Thermal Design Guide, table 2-1 et § 4.3 (Tegra X1), citée et
|
||||
# confirmée sur le forum NVIDIA. Jetson Nano : hypothèse tirée des zones lues par le collecteur, à confirmer sur une station.
|
||||
GPU_LIMIT_DEG_C = 97.5
|
||||
WINDOW = timedelta(hours=24) # demande de l'utilisateur (2026-10-13) : un dépassement reste visible un jour
|
||||
|
||||
RULE = {
|
||||
"id": "DAILY_GPU_TEMPERATURE_LIMIT",
|
||||
"anomaly": "True : une moyenne horaire du GPU >= la limite dans les 24 h ; None : aucune mesure dans les 24 h",
|
||||
"gpu_limit_deg_c": GPU_LIMIT_DEG_C,
|
||||
"doc": "docs/temperature/analyses/daily_gpu_temperature_limit.md",
|
||||
}
|
||||
|
||||
|
||||
def run(series):
|
||||
"""Analyse causale : un point par jour UTC, sur les 24 h qui finissent à la dernière heure du jour présente dans la série
|
||||
(la journée entière pour un jour fini, les 24 dernières heures pour le jour en cours)."""
|
||||
gpu = series["sensor_GPU_deg_c"]
|
||||
last = {}
|
||||
for t in sorted(gpu):
|
||||
last[t.date()] = t
|
||||
points = []
|
||||
for t in last.values():
|
||||
window = {u: x for u, x in gpu.items() if t - WINDOW < u <= t and x is not None and math.isfinite(x)}
|
||||
if not window: # UNKNOWN : aucune mesure dans les 24 h
|
||||
points.append({"t": t, "value": None, "anomaly": None, "facts": {"hours_measured": 0}})
|
||||
continue
|
||||
hottest = max(window, key=window.get)
|
||||
facts = {"max_deg_c": window[hottest], "max_at": hottest.isoformat(), "hours_measured": len(window)}
|
||||
points.append({"t": t, "value": window[hottest], "anomaly": window[hottest] >= GPU_LIMIT_DEG_C, "facts": facts})
|
||||
return {"analysis": RULE["id"], "rule": RULE, "points": points}
|
||||
Reference in new issue
Block a user