Add the temperature domain on the GPU manufacturer limit

DAILY_GPU_TEMPERATURE_LIMIT: red when an hourly GPU mean reached 97.5 °C
(T.gpu, Jetson Nano Thermal Design Guide) in the last 24 hours, green
otherwise, gray without measurement. Working sets WEISSHORN and NORDEND;
all measured days are green. D-040 replaces D-036; the exploration note
moves to docs/temperature/domaine/point-de-depart.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 16:07:36 +02:00
1 parent f0990c16e6
commit 276c34ea38
12 files changed
+256 -19

No files matched your search

@@ -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/<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`.
- **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).
@@ -0,0 +1,37 @@
# Températures de la station : point de départ du domaine `temperature`
**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.
- **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
- **Les zones sont redondantes** : écart médian à CPU de +3 à +4 °C pour A0, de −2,5 à +0,2 °C pour GPU, de −3 à −4,5 °C pour PLL, de −1,5 à 0 °C pour thermal, stable jour et nuit. Une seule série suffit.
- **Le soleil fait la température** : maximum entre 13 et 16 h UTC, minimum entre 4 et 5 h UTC. Amplitude médiane du jour : ~10 °C sur VERMONT, 12 à 15 °C sur WEISSHORN et NORDEND.
- **Saison** (`thermal`, médiane du maximum du jour) : VERMONT 35 °C en avril, 46 °C en juillet, 37 °C en octobre ; NORDEND 47 °C en juillet, 40 °C en octobre ; WEISSHORN 44 °C en septembre, 39 °C en octobre.
- **Extrêmes, toutes zones** : maximum 62,7 °C (NORDEND, A0, 13/08 à 14 h), 58,5 °C (WEISSHORN, A0, 15/09), 55,1 °C (VERMONT, thermal, 25/06). Minimum 11,5 °C (VERMONT, PLL, 05/10 à 07 h, retour après une coupure de nuit) ; sans coupure, ~20 °C (PLL) début octobre.
- **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
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** : 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. 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 ?