diff --git a/.claude/rules/analyses.md b/.claude/rules/analyses.md index 5348675..96225c6 100644 --- a/.claude/rules/analyses.md +++ b/.claude/rules/analyses.md @@ -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/`. -- **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`. diff --git a/CLAUDE.md b/CLAUDE.md index 53d04e8..11b7409 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -16,9 +16,9 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m - **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`. -- **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`. +- **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`. - **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 ; 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 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 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). ## Analyses (domaine Energy) @@ -60,6 +60,16 @@ Code dans `src/storage/`, fiche dans `docs/storage/analyses/.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). + ## Commandes ```bash @@ -70,6 +80,7 @@ python3 src/cellular/final.py [données] # livré : out/_cellular.html (même défaut) python3 src/storage/final.py [données] # livré : out/_storage_daily.html + .json (défaut data/WEISSHORN/) python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/_storage.html (même défaut) +python3 src/temperature/all_analyses.py [données] # limite du GPU : out/_temperature.html (défaut data/WEISSHORN/ et data/NORDEND/) python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_.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/.pdf" - # lire un PDF AIMsight @@ -92,18 +103,18 @@ 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` (424 l, D-001 à D-039) : 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` (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/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/.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/`, 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/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). @@ -122,6 +133,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). - `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. diff --git a/README.md b/README.md index 40f18ea..109621d 100644 --- a/README.md +++ b/README.md @@ -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//analyses/.md` | -| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs//domaine/` (`energy`, `storage`, `cellular`) | +| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs//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//` | +| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular et Temperature) | `data//` | | 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). diff --git a/docs/decisions.md b/docs/decisions.md index db57fb2..aa5e7fe 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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). @@ -422,3 +422,15 @@ Règles du journal : - 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. diff --git a/docs/domaine/ce-que-mesure-la-station.md b/docs/domaine/ce-que-mesure-la-station.md index 037d782..95a2739 100644 --- a/docs/domaine/ce-que-mesure-la-station.md +++ b/docs/domaine/ce-que-mesure-la-station.md @@ -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. diff --git a/docs/domaine/pieges-des-donnees.md b/docs/domaine/pieges-des-donnees.md index f578f85..aaaed69 100644 --- a/docs/domaine/pieges-des-donnees.md +++ b/docs/domaine/pieges-des-donnees.md @@ -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. diff --git a/docs/temperature/analyses/daily_gpu_temperature_limit.md b/docs/temperature/analyses/daily_gpu_temperature_limit.md new file mode 100644 index 0000000..734606f --- /dev/null +++ b/docs/temperature/analyses/daily_gpu_temperature_limit.md @@ -0,0 +1,71 @@ +# `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/_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`. +- **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). diff --git a/docs/domaine/temperatures-de-la-station.md b/docs/temperature/domaine/point-de-depart.md similarity index 64% rename from docs/domaine/temperatures-de-la-station.md rename to docs/temperature/domaine/point-de-depart.md index 4482d3d..9b80f7b 100644 --- a/docs/domaine/temperatures-de-la-station.md +++ b/docs/temperature/domaine/point-de-depart.md @@ -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/temp` en millidegrés : A0 = zone 0, CPU = 1, GPU = 2, PLL = 3, thermal = 5. La zone 4 n'est pas lue. Export : `sensor__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 ? diff --git a/src/temperature/__init__.py b/src/temperature/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/src/temperature/all_analyses.py b/src/temperature/all_analyses.py new file mode 100644 index 0000000..beb4605 --- /dev/null +++ b/src/temperature/all_analyses.py @@ -0,0 +1,71 @@ +"""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/_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 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 + + +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}", + text=[f"{p['t']:%Y-%m-%d}
" + "
".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) + + 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_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/_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) diff --git a/src/temperature/day_color.py b/src/temperature/day_color.py new file mode 100644 index 0000000..5bf26a9 --- /dev/null +++ b/src/temperature/day_color.py @@ -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} diff --git a/src/temperature/gpu_temperature_limit.py b/src/temperature/gpu_temperature_limit.py new file mode 100644 index 0000000..3e0f6ed --- /dev/null +++ b/src/temperature/gpu_temperature_limit.py @@ -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}