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:
1 parent
276c34ea38
commit
27c52bac75
9 files changed
+200
-43
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user