Files
Support-Agent/docs/temperature/guide/diagnostic-temperature.md
T

78 lines
5.3 KiB
Markdown
Raw Normal View History

# 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.