Deliver Temperature in the mockups, with its site figure and guide

Temperature joins the mockups' list of domains (D-041): a Red
notification on the support Home, and a one-line block on the client
view ("Hottest (24 h) 43 °C · limit 97.5 °C") for the stations that
measure the GPU. src/temperature/final.py writes the site figure; the
comparison page reuses its panel. Short two-layer guide in
docs/temperature/guide/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 16:11:21 +02:00
1 parent 276c34ea38
commit 27c52bac75
9 files changed
+200 -43

No files matched your search

+9 -7
View File
@@ -12,13 +12,13 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
- **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, 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, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, 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` ; 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) ; ni figure du site, ni guide (étape 7 de `nouveau-domaine`). Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.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 la figure du site et le guide (étape 7 de `nouveau-domaine`) ; 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).
- **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)
@@ -69,6 +69,7 @@ Code dans `src/temperature/`, fiche dans `docs/temperature/analyses/<règle en m
| `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
@@ -80,7 +81,8 @@ python3 src/cellular/final.py [données] # livré : out/<STATION
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/all_analyses.py [données] # limite du GPU : out/<STATION>_temperature.html (défaut data/WEISSHORN/ et data/NORDEND/)
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
@@ -103,7 +105,7 @@ 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` (436 l, D-001 à D-040) : 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` (446 l, D-001 à D-041) : 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.
@@ -114,7 +116,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
- `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/`, 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 ni guide. `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/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/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).
@@ -133,7 +135,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
- `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) ; 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` ; page plotly `all_analyses.py` (D-040).
- `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.
+10
View File
@@ -434,3 +434,13 @@ Règles du journal :
- **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.
@@ -33,6 +33,7 @@ La couleur du jour (`day_color.py`) recopie l'analyse : `anomaly` vrai → `RED`
## 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)
@@ -69,3 +70,4 @@ La couleur du jour (`day_color.py`) recopie l'analyse : `anomaly` vrai → `RED`
## 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).
@@ -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.
+3 -2
View File
@@ -1,6 +1,6 @@
"""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 et par domaine dont le dernier jour de la fenêtre est Orange ou Red
(src/<domaine>/day_color.py : Energy, Storage, Cellular ; D-025, D-030).
(src/<domaine>/day_color.py : Energy, Storage, Cellular, Temperature ; D-025, D-030).
La notification, comme la vignette de la station, mène à la vue client de la station (son menu principal) :
out/maquette_user_<STATION>.html, écrite par maquettes/user/summary.py (à lancer avec les mêmes dates).
@@ -20,6 +20,7 @@ from common.stations import load_stations # 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)
@@ -30,7 +31,7 @@ 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"]
DOMAINS = {"Energy": energy, "Storage": storage, "Cellular": cellular} # contrat de notification (D-030)
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
series = load_stations([str(d) for d in sorted((ROOT / "data").iterdir()) if d.is_dir()])
+8 -4
View File
@@ -1,9 +1,9 @@
"""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). Un bloc par domaine dont la station a les mesures : Energy, Storage, Cellular.
(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), puis historique complet (src/<domaine>/final.py, D-021) et guide (partie 1), repliés.
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.
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)
"""
@@ -24,6 +24,8 @@ 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)
@@ -31,10 +33,12 @@ 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")}
"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}
"expected_sends": ls.SAMPLES_PER_HOUR * ls.HOURS_PER_DAY, "signal_classes": sgs.CLASSES,
"gpu_limit_deg_c": gl.GPU_LIMIT_DEG_C}
def guide(path):
+12 -5
View File
@@ -7,7 +7,7 @@
<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, D-039). Données injectées par summary.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,7 +43,7 @@
.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 domaine (Energy, Storage, Cellular). */
/* 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; }
@@ -173,7 +173,8 @@ const R = DATA.rule;
const NAME = { GREEN: "Green", ORANGE: "Orange", RED: "Red" };
const ACTION = { GREEN: "Nothing to do", ORANGE: "Watch", RED: "Contact support" };
// 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"] };
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 : zones [borne haute en %, nom, teinte, ...], trait à pct %, texte dessous ; le survol donne la valeur mesurée.
@@ -242,11 +243,17 @@ function signal(d) {
return scale(SIGNAL, 25 * i + 12.5, SIGNAL[i][1]);
}
// Deux lignes par bloc, en mots simples (côté client : pas de tension brute, pas de mécanisme d'analyse).
// 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) {
@@ -265,7 +272,7 @@ for (const [key, dom] of Object.entries(DATA.domains)) {
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 et Cellular n'ont pas de remède connu : pas de bouton.
// 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 = () =>
+5 -25
View File
@@ -10,40 +10,20 @@ 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.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
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):
title = f"Analysis {gl.RULE['id']}"
fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08, subplot_titles=[title, METRIC])
group = dict(legendgroup=gl.RULE["id"], legendgrouptitle_text=title)
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 = 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")
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"))
+73
View File
@@ -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)