Files
Support-Agent/docs/energy/guide/diagnostic-energetique.md
T
maximeandClaude Opus 5.5 997e842568 Rename DAILY_MAINS_POWER to DAILY_POWER_SOURCE
The user's preferred name. The module becomes src/energy/power_source.py
and the sheet docs/energy/analyses/daily_power_source.md; the
calculation and the results are unchanged (D-043).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 17:23:26 +02:00

17 KiB
Raw Blame History

Manuel : lire le diagnostic énergétique d'une station AIMsight

  • Statut : brouillon, 2026-10-12. La couleur du jour (partie 1) est calculée par src/energy/day_color.py, selon la matrice de docs/energy/matrice-etat-tendance.drawio (D-020), mais aucun graphique ne l'affiche encore (D-021).
  • Lecteurs : la partie 1 s'adresse au client final ; la partie 2 à l'ingénieur support AIMsight.

Partie 1 : lecture rapide

1. Ce que surveille le diagnostic

Une station AIMsight fonctionne sur batterie. La batterie est rechargée par un panneau solaire ou par le secteur.

Chaque jour, pour chaque station, le diagnostic répond à une question : l'énergie reçue ce jour-là couvre-t-elle la consommation de la station ?

La réponse est une couleur par jour, accompagnée d'une flèche qui compare le jour à la veille.

Une station peut avoir une batterie encore bien chargée et déjà être en difficulté : si elle ne reçoit plus d'énergie, elle s'arrêtera tôt ou tard. Le diagnostic regarde donc si l'énergie arrive, pas seulement si la batterie est pleine.

2. Les trois couleurs, et ce qu'il faut faire

Couleur Ce que ça veut dire Que faire
🟢 Vert La station a reçu assez d'énergie ce jour-là. Rien.
🟠 Orange Incertain : la batterie s'est rechargée, mais pas complètement. Le bilan de la journée ne peut pas être établi. Rien si l'orange est isolé : un jour nuageux suffit à le produire. Prévenir le support si l'orange dure plus de 3 jours d'affilée.
🔴 Rouge La station ne reçoit pas assez d'énergie. Des coupures, la nuit surtout, sont possibles ou déjà en cours. Contacter le support.
⚪ Gris Inconnu : pas assez de mesures ce jour-là pour conclure, ou premier jour suivi (pas de veille à comparer). Regarder les jours voisins.
  • Pourquoi 3 jours : sur la station de référence (VERMONT), en période saine, la plus longue série de jours sans recharge complète est de 3 jours (du 04 au 06/05/2026). Ce seuil reste à confirmer sur d'autres stations.
  • La couleur du jour peut encore changer tant que la journée n'est pas terminée (minuit UTC).
  • Station sur secteur : sa batterie reste toujours pleine. Le diagnostic le reconnaît seul, après 3 jours (« On mains » à côté de la couleur), et passe au rouge dans l'heure ou les deux heures qui suivent une perte du secteur.

3. La flèche : comparaison avec la veille

Flèche Ce que ça veut dire
↗ mieux que la veille
→ comme la veille
↘ moins bien que la veille

La flèche nuance la couleur :

  • un orange ↘ inquiète plus qu'un orange → ;
  • un vert ↗ après un orange : la station a récupéré.

Une seule flèche ↘ n'est pas une alerte : un jour nuageux en donne une, suivie d'un ↗ le lendemain. C'est la répétition qui compte.

4. Trois exemples réels (station VERMONT, solaire, 2026)

Une période saine

Du 05 au 14/08 : 🟢 → tous les jours. La batterie se recharge complètement chaque jour et se retrouve au même niveau chaque matin.

Des oranges isolés : rien à faire

Jour 03/08 04/08 … 15/08 16/08 17/08 18/08 19/08
Couleur 🟠 ↘ 🟢 ↗ 🟠 ↘ 🟢 ↗ 🟢 → 🟠 ↘ 🟢 ↗

Chaque orange est un jour nuageux, et la station revient au vert dès le lendemain.

Une station qui s'épuise : prévenir le support, puis contacter le support

Période Couleurs Ce qui se passe
29/08 – 01/09 🟠 🟠 🟠 🟠 4 jours d'orange d'affilée : c'est plus que tout ce qu'on voit en période saine. Le 01/09, il faut prévenir le support, 26 jours avant la première coupure.
02/09 – 25/09 surtout 🟠 ; 🟢 seulement les 02–05, 07, 11, 18 et 19/09 Les recharges complètes deviennent rares. Deux séries de 6 jours d'orange (12–17/09 et 20–25/09).
26/09 🔴 ↘ La batterie est descendue sous ~30 % de charge. Il faut contacter le support.
27/09, 01:00 UTC 🔴 Première coupure de la station, la nuit.
jusqu'au 09/10 🔴 Coupures nocturnes répétées.

Diagnostic de l'expert : interruptions nocturnes dues à un déficit d'énergie. Remède indiqué : réactiver le mode veille profonde entre les mesures, pour réduire la consommation.


Partie 2 : annexe technique (support)

La couleur du jour combine trois analyses de la tension batterie (BusVoltage, moyennes horaires) :

  • l'alimentation : sur secteur ou non (DAILY_POWER_SOURCE, D-043). Sur secteur, elle décide seule (§ 7, fin) ;
  • sinon, l'état du jour (DAILY_BATTERY_STATE) ;
  • et la tendance face à la veille (DAILY_BATTERY_TREND).

Le détail de chaque analyse (calcul exact, sources, résultats, options écartées) est dans sa fiche : docs/energy/analyses/daily_battery_state.md, docs/energy/analyses/daily_battery_trend.md et docs/energy/analyses/daily_power_source.md.

Une couleur reste une preuve imparfaite : elle conclut au plus consistent with. Elle signale une journée à regarder, elle ne remplace pas le diagnostic.

5. L'état du jour (DAILY_BATTERY_STATE)

Chaque journée UTC (00:00 à 23:00) est lue avec deux seuils du matériel, valables dès le premier jour d'installation, sans historique (D-018) :

  • 14,0 V : fin de charge du chargeur. Une heure à 14,0 V ou plus signale une recharge complète.
  • 12,8 V : coude de la batterie LiFePO4 (~30 % de charge). Au-dessus, la tension de nuit reste presque plate (le « plateau ») ; en dessous, elle chute de plus en plus vite.

L'état se lit dans cet ordre ; la première condition vraie l'emporte :

Ordre Condition État Lecture
1 au moins une heure ≥ 14,0 V ● FULL_CHARGE l'apport a rempli la batterie
2 une heure < 12,8 V ▼ BELOW_PLATEAU décharge visible : la batterie a quitté le plateau
3 montée du jour < 0,05 V ✕ NO_CHARGE aucun apport visible de la journée
4 sinon ◆ PARTIAL_CHARGE incertain : charge sans recharge complète ; sur le plateau, on ne sait pas si la batterie a gagné ou perdu
  • Montée du jour : la plus grande hausse de tension depuis un minimum antérieur du même jour.
  • Fin de nuit : le minimum dont part cette montée, juste avant la charge du jour. C'est le meilleur repère du niveau de la batterie.
  • Sources des seuils :
    • 14,0 V : sur VERMONT, le maximum du jour est soit sous 13,55 V, soit entre 14,02 et 14,33 V (170 jours sur 173) ;
    • 12,8 V : table OCV du collecteur ;
    • 0,05 V : au-dessus du bruit d'une heure sur le plateau, sous la plus faible vraie recharge observée (+0,079 V un jour nuageux).

6. La tendance (DAILY_BATTERY_TREND)

On compare le jour J à la veille J−1 :

  1. Si l'état a changé, l'état décide. Rang : FULL_CHARGE > PARTIAL_CHARGE > NO_CHARGE > BELOW_PLATEAU. Un état plus haut donne BETTER (↗), un état plus bas donne WORSE (↘).
  2. Sinon, la fin de nuit décide : écart = fin de nuit de J − fin de nuit de J−1.
    • écart > +0,05 V : BETTER (↗) ;
    • écart < −0,05 V : WORSE (↘) ;
    • sinon : STABLE (→).

Source de la zone morte de ±0,05 V : sur VERMONT, entre deux jours FULL_CHARGE consécutifs, l'écart va de −0,026 à +0,043 V (5e et 95e centiles). Les jours de déficit de septembre baissent de −0,07 à −0,12 V.

À savoir en lisant les barres : la fin de nuit de J est celle du matin de J. Son écart résume donc la recharge de J−1, alors que l'état est celui de J. Quand l'état change, la barre peut le contredire. Exemple : le 12/04, l'état passe de PARTIAL_CHARGE à FULL_CHARGE (↗), avec une barre à −0,187 V, héritée du 11/04 nuageux.

7. La matrice : de l'état et de la tendance à la couleur

Tendance \ État ● FULL_CHARGE ◆ PARTIAL_CHARGE ✕ NO_CHARGE ▼ BELOW_PLATEAU
↗ BETTER 🟢 🟢 🟠 🔴
→ STABLE 🟢 🟠 🔴 🔴
↘ WORSE 🟢 🟠 🔴 🔴

Lecture de chaque case, avec le nombre de jours observés sur VERMONT (184 jours, du 09/04 au 09/10/2026) :

État Tendance Couleur Situation Lecture VERMONT
FULL_CHARGE ↗ 🟢 retour à la recharge complète, ou fin de nuit plus haute récupération après un jour faible 17 j
FULL_CHARGE → 🟢 recharge complète, fin de nuit à ±0,05 V cas sain : consistent with un régime soutenable 120 j
FULL_CHARGE ↘ 🟢 recharge complète, fin de nuit plus basse rare ; à vérifier 1 j (24/07 : artefact de trou, le 23/07 n'a que 16 h mesurées)
PARTIAL_CHARGE ↗ 🟢 reprise depuis NO_CHARGE ou BELOW_PLATEAU, ou fin de nuit plus haute l'apport reprend 0 j
PARTIAL_CHARGE → 🟠 charge partielle, fin de nuit à ±0,05 V incertain ; une dérive lente (< 0,05 V/jour) reste « stable » 10 j, dont 22–24/09 alors que la station s'épuise
PARTIAL_CHARGE ↘ 🟠 après une recharge complète, ou fin de nuit plus basse jour nuageux ou début de déficit : à surveiller s'il se répète 21 j
NO_CHARGE ↗ 🟠 depuis BELOW_PLATEAU, ou fin de nuit plus haute sans apport peu plausible physiquement : vérifier les données (trou, redémarrage) 0 j
NO_CHARGE → 🔴 2e jour sans apport ou plus, batterie restée sur le plateau consistent with une alimentation absente, même batterie pleine (D-004) 0 j
NO_CHARGE ↘ 🔴 perte de l'apport, ou fin de nuit qui baisse sans apport consistent with une perte d'alimentation 0 j
BELOW_PLATEAU ↗ 🔴 fin de nuit plus haute, toujours sous le plateau souvent un faux « mieux » : un jour de coupure, la fin de nuit est la tension de redémarrage 3 j (01/10, 03/10, 08/10), tous faux
BELOW_PLATEAU → 🔴 sous le plateau, fin de nuit à ±0,05 V consistent with un régime non soutenable qui dure 7 j
BELOW_PLATEAU ↘ 🔴 entrée sous le plateau, ou fin de nuit qui baisse encore consistent with un régime non soutenable ; coupures nocturnes possibles 4 j (26/09 entrée, 27/09, 02/10, 09/10)
  • Total VERMONT : 138 jours 🟢, 31 🟠, 14 🔴 et 1 jour gris (09/04, premier jour : sans veille, pas de tendance).
  • Jour gris : l'état ou la tendance est inconnu (moins de 20 h mesurées sans recharge complète ni passage sous le plateau, ou pas de veille). La matrice ne traite pas encore ces cas (D-020, D-021).
  • Pourquoi NO_CHARGE → est rouge et non orange : en orange, une coupure d'alimentation passerait du rouge (1er jour, ↘) à l'orange (2e jour, →) alors qu'elle continue. Une batterie assez grande pour rester sur le plateau ne change rien : sans apport, la station tombera (D-004).

Station sur secteur (DAILY_POWER_SOURCE)

La matrice ne s'applique qu'aux stations qui ne sont pas sur secteur (NOT_MAINS, ou statut inconnu). Sur secteur, la batterie reste pleine : chaque jour serait FULL_CHARGE, et la perte du secteur ne deviendrait rouge que le lendemain (29 à 40 h de retard sur MISSISSIPPI).

  • Statut : MAINS si la moyenne de BusVoltage sur les 3 jours avant J (72 h, au moins 58 h mesurées) est ≥ 14,0 V. Elle ne dépasse jamais 13,50 V en solaire (VERMONT), et reste ≥ 14,08 V sur secteur hors coupure (WEISSHORN, NORDEND, FLORIDA, MISSISSIPPI). J est exclu, pour que la coupure à signaler ne fasse pas changer le statut.
  • Couleur, sur secteur :
Jour J Couleur Lecture
toutes les heures mesurées ≥ 13,4 V 🟢 le chargeur a tenu la batterie toute la journée
au moins une heure < 13,4 V 🔴 consistent with une perte du secteur : la batterie seule alimente la station (UPS)
  • Pourquoi 13,4 V et pas 14,0 V : sur secteur, les moyennes horaires descendent souvent sous 14,0 V sans coupure (jusqu'à 13,65 V sur NORDEND). Sans secteur, une heure pleine est à 13,1–13,3 V. 13,4 V est le haut du plateau de la table OCV.
  • Délai : rouge 1 à 2 h après la perte, l'heure de la perte étant souvent partielle.
  • La notification du support et l'en-tête du bloc Energy de la vue client indiquent le statut : On mains, Not on mains ou Mains unknown.

8. Lire les pages HTML

Commandes : python3 src/energy/final.py écrit la page livrée, python3 src/energy/all_analyses.py la page de comparaison ; chacune est écrite dans out/ et ouverte dans le navigateur.

  • <STATION>_daily.html : le graphique destiné au site de monitoring (D-021), soit les panneaux DAILY_BATTERY_STATE, DAILY_BATTERY_TREND et DAILY_POWER_SOURCE décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (<STATION>_daily.json), pour Plotly.newPlot.
  • <STATION>_energy.html : la page de comparaison des cinq analyses (all_analyses.py), avec ces trois panneaux, et une courbe par mesure dessous.
  • <STATION>_focus_<AAAA-MM-JJ>.html : le focus sur un jour et sa veille (D-024), pour comprendre une couleur. Commande : python3 src/energy/focus_jour.py 27.09. Le terminal affiche les faits qui ont produit la couleur ; le graphique montre les 48 h de BusVoltage, avec les heures sans mesure en gris, les seuils de 14,0 et 12,8 V, le maximum et la fin de nuit de chaque jour, et une flèche de la fin de nuit de la veille à celle du jour (bleue ↗, grise →, rouge ↘).

Attention aux couleurs : celles des panneaux ne sont pas celles de la matrice. Elles distinguent les états et les tendances ; elles ne disent pas le niveau de préoccupation. Par exemple, BELOW_PLATEAU y est en bleu.

  • Langue : les titres, légendes et survols des panneaux DAILY_BATTERY_STATE et DAILY_BATTERY_TREND sont en anglais, comme le site (D-023). Par exemple, le maximum du jour est daily maximum, la fin de nuit night end, et les tendances better, stable et worse.
  • Les panneaux MOVING_AVERAGE_* (moyennes sur 7 jours), en haut de la page de comparaison, ne font pas partie de ce diagnostic : les ignorer.
  • Panneau DAILY_BATTERY_STATE, un point par jour, placé à midi UTC :
    • courbe foncée : le maximum du jour ; courbe claire : la fin de nuit ;
    • tirets : les seuils de 14,0 V (vert) et de 12,8 V (bleu) ;
    • marqueurs sur le maximum, selon l'état : ● vert FULL_CHARGE, ◆ jaune orangé PARTIAL_CHARGE, ▼ bleu BELOW_PLATEAU, ✕ violet NO_CHARGE.
  • Panneau DAILY_BATTERY_TREND, une barre par jour :
    • hauteur : l'écart de fin de nuit face à la veille, en V ;
    • couleur : bleu ↗, gris →, rouge ↘ ;
    • tirets : la zone morte de ±0,05 V ;
    • quand l'état décide, la couleur suit la tendance, même si la barre est petite ou de signe contraire (voir § 6).
  • Panneau DAILY_POWER_SOURCE, un point par jour, placé à midi UTC :
    • courbe foncée : la moyenne des 3 jours avant J ; courbe claire : le minimum du jour ;
    • tirets : les seuils de 14,0 V (bleu, statut) et de 13,4 V (rouge, perte) ;
    • marqueurs sur la moyenne : ● bleu on mains, ○ gris not on mains ; ✕ rouge sur le minimum : mains lost.
  • Survol : chaque point et chaque barre affichent les faits calculés du jour (état, tensions, écarts, ce qui a décidé la tendance).
  • Dessous : une courbe par mesure. Sur BusVoltage, les bandes grises marquent les heures sans mesure, et les bandes colorées les zones de tension (décharge, en charge, pleine charge).
  • Zoom : dans le temps seulement, au rectangle ou à la molette ; double-clic pour revenir à la vue complète.

9. Limites à connaître

  1. Jour UTC : la journée est coupée à minuit UTC. Pour une station éloignée en longitude, la nuit serait coupée en deux, et la fin de nuit faussée.
  2. Seuil de 14,0 V : il suppose le même chargeur sur toutes les stations, ce qui n'est pas confirmé. Une recharge complète de moins d'une heure peut aussi être lue PARTIAL_CHARGE (08/09 : maximum à 13,96 V).
  3. Jours de coupure : faux ↗ sous le plateau (voir § 7). La couleur reste rouge.
  4. Dérive lente : une baisse de moins de 0,05 V par jour est lue → (VERMONT, 22–24/09, alors que la station s'épuise). La série d'oranges, elle, la signale.
  5. Froid : aucune donnée d'hiver. Sous 0 °C, la charge d'une batterie LiFePO4 est en général bloquée : des jours orange ou rouges sont possibles même au soleil.
  6. Après une perte du secteur, 3 jours sans statut MAINS : la coupure est dans la fenêtre, la station repasse sur la matrice. Une deuxième perte dans ces 3 jours n'est vue qu'avec le retard de la matrice (MISSISSIPPI, 11/12/2025).