Files
Support-Agent/docs/analyses/analyse_04.md
T
maximeandClaude Opus 5.5 8452973912 Add the client Energy mockup and switch site texts to English
D-022: page mockups are HTML built from real data, in maquettes/user/
(client) and maquettes/support/; Figma only on request.
maquettes/user/energy.py renders the System Summary page with a
Diagnostic section: an Energy box with the day's color, a one-line
headline, a battery scale (zones from the collector's LiFePO4 OCV
table, no percentage shown), the trend against the day before, an
"Activate energy save mode" button on orange and red days (mockup
only, sends nothing), and two collapsibles: the full history (D-021
figure) and the guide (part 1 of the manual, rendered from Markdown).

D-023: everything meant for the monitoring site is in English,
including the titles, legends, axes and hovers of the 03/04 panels.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 16:23:37 +02:00

9.7 KiB
Raw Blame History

Analyse 04 — DAILY_BATTERY_TREND : tendance de la batterie d'un jour à l'autre

  • Statut : prototype en place (2026-10-12). Pas de verdict : anomaly = None, la tendance est dans facts.trend.
  • Script : python3 src/analyse_04.py [CSV ou dossiers] (défaut : data/). Il lance la page commune de analyse_01.py : out/<STATION>_energy.html, où cette analyse est le quatrième panneau d'analyse (D-016).
  • Code :
    • src/battery_trend.py : calcul, bibliothèque standard uniquement (run()). Il s'appuie sur battery_state.run() (analyse 03) ;
    • src/energy_plot.py : graphique plotly.

Question posée

Chaque jour J, la batterie va-t-elle mieux, pareil ou moins bien que la veille J−1 ?

  • Lien avec D-004 : un régime non soutenable se voit comme une suite de jours qui empirent. Une tendance d'un seul jour n'est pas une anomalie : un jour nuageux sur une station saine donne déjà WORSE.
  • Ce que l'analyse ajoute à l'analyse 03 :
    • la 03 lit chaque jour isolément. La 04 compare deux jours, et voit une dégradation à l'intérieur d'un même état, comme une suite de PARTIAL_CHARGE dont la fin de nuit baisse chaque jour ;
    • le modèle est markovien : seul le jour précédent compte. L'analyse reste donc utilisable dès le deuxième jour d'installation (D-018).

Principe

On compare l'état du jour J (analyse 03) à celui de J−1. S'il a changé, le changement donne la tendance. Sinon, c'est l'écart de fin de nuit qui la donne. La fin de nuit du jour J est le minimum dont part la charge du jour : son écart avec celle de J−1 résume le bilan des 24 h écoulées (charge de J−1, puis la nuit).

Calcul exact, pour chaque point J de DAILY_BATTERY_STATE (un par jour UTC) :

  1. prev = le point précédent, s'il est bien la veille calendaire de J ; sinon, pas de prev.
  2. trend = None (UNKNOWN) et decided_by = None s'il n'y a pas de prev, ou si l'état de J ou celui de J−1 est inconnu (state = None).
  3. Si les deux états diffèrent, l'état décide (decided_by = "state"). Ordre : FULL_CHARGE (3) > PARTIAL_CHARGE (2) > NO_CHARGE (1) > BELOW_PLATEAU (0). Un état plus haut donne BETTER, un état plus bas donne WORSE.
  4. Sinon, la fin de nuit décide (decided_by = "night_end") : delta_night_end_v = night_end_v(J) − night_end_v(J−1).
    • delta_night_end_v > +NIGHT_END_DEADBAND_V : BETTER ;
    • delta_night_end_v < −NIGHT_END_DEADBAND_V : WORSE ;
    • sinon : STABLE.

Sortie (contrat commun) : un point par jour.

  • t = le t du jour J dans l'analyse 03 (dernière heure du jour présente dans la série).
  • value = delta_night_end_v, en V (None si l'un des deux jours n'a pas de fin de nuit).
  • anomaly = None pour tous les jours : pas de verdict, comme l'analyse 03 en phase C. L'UNKNOWN de la tendance est porté par trend = None.
  • facts = {trend, decided_by, state_prev, state, delta_night_end_v, delta_max_v, delta_hours_full}. Les écarts du maximum et des heures pleines sont seulement affichés : ils ne décident pas.

Causalité : le jour J n'utilise que les heures de J et de J−1. Si J est le dernier jour, incomplet, d'un export, sa tendance est provisoire, comme son état.

Constantes et sources

Constante Valeur Source
NIGHT_END_DEADBAND_V 0,05 V VERMONT, du 2026-04-09 au 2026-10-09 : sur 125 paires de jours FULL_CHARGE enchaînés, l'écart de fin de nuit va de −0,026 à +0,043 V (5e et 95e centiles) ; seules 5 paires dépassent ±0,05 V. Les jours de déficit de septembre (PARTIAL_CHARGE enchaînés) baissent de −0,07 à −0,12 V.
STATE_RANK FULL_CHARGE 3, PARTIAL_CHARGE 2, NO_CHARGE 1, BELOW_PLATEAU 0 Choix de conception, tiré de la lecture des états (fiche analyse_03) : la batterie s'est remplie ; elle a chargé sans se remplir ; aucun apport visible, mais elle reste sur le plateau ; elle a quitté le plateau (< ~30 %).

Graphique

  • Place : quatrième panneau d'analyse de la page commune, sous DAILY_BATTERY_STATE (D-016). Les états du jour se lisent dans le panneau 03, juste au-dessus, sur le même axe du temps.
  • Contenu :
    • une barre par jour, centrée sur midi UTC de ce jour (D-019) : delta_night_end_v, en V, colorée selon la tendance (bleu : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre). Ce sont la paire divergente et le gris neutre du skill dataviz. ;
    • la zone morte de ±0,05 V en tirets. Elle est tracée comme une courbe avec un point par jour, pour que le recalage au zoom (D-013) la garde visible.
    • Quand l'état décide, la couleur suit la tendance, même si la barre est petite ou de l'autre signe.
  • Survol : la tendance, ce qui l'a décidée, l'état de J−1 puis celui de J, et les trois écarts.

Résultats sur VERMONT (jeu de travail)

Sur 184 jours (du 2026-04-09 au 2026-10-09) :

  • Répartition : 137 STABLE, 26 WORSE, 20 BETTER, 1 UNKNOWN (le 2026-04-09, premier jour de l'export, sans veille).
  • Jours sains : sur 125 paires FULL_CHARGE enchaînées, 120 sont STABLE, 4 BETTER et 1 WORSE.
  • WORSE isolés en août (08-03, 08-15, 08-18) : des jours nuageux, chacun suivi d'un BETTER.
  • Fin août à septembre : des WORSE répétés (08-29, 08-30, 09-06, 09-08, 09-10, 09-12, 09-16, 09-20, 09-21, puis 09-25 à 09-27, passage sous le plateau). Chacun est suivi d'un BETTER le jour d'une pleine charge. C'est cohérent avec l'expert : charges complètes de plus en plus rares, puis déficit vers le 20/09.
  • L'état décide contre la fin de nuit : le 2026-08-29 (FULL_CHARGE → PARTIAL_CHARGE) est WORSE, alors que la fin de nuit monte de +0,041 V.
  • Sous le plateau (du 26/09 au 09/10) : des BETTER les 01/10, 03/10 et 08/10, faux (limite 1).

Options écartées

Option Pourquoi écartée
Deux réponses seulement (mieux / pire) Sur une station saine, la fin de nuit varie de quelques mV d'un jour à l'autre : la réponse oscillerait au gré du bruit. L'utilisateur a choisi d'ajouter STABLE.
Vote de tous les écarts (état, fin de nuit, maximum, heures pleines) Une zone morte par écart, une règle d'égalité, et deux écarts bruités (maximum ±0,1 V, heures pleines ±2 h sur les jours sains) pèsent autant que les deux bons.
État seul Ne voit ni la dérive sur le plateau (PARTIAL_CHARGE enchaînés, −0,1 V par jour fin septembre), ni l'aggravation sous le plateau.
Bande de marqueurs mieux / stable / pire Lisible d'un coup d'œil, mais cache l'ampleur de l'écart. L'utilisateur a choisi les barres.
Mémoire au-delà de la veille (série de tendances, moyenne) Hors du modèle markovien demandé. Relève de la phase B ou de la combinaison des analyses.
Décaler l'écart de fin de nuit d'un jour (matin de J+1 − matin de J), pour qu'il porte sur la même journée que l'état Essayé le 2026-10-12, puis écarté par l'utilisateur. Sur VERMONT, il ramenait les barres contraires à l'état de 16 à 4, toutes dans la zone morte, au prix d'un jour de retard (D-019).
Vert pour « mieux » (design validé en brainstorming) Refusé par le validateur du skill dataviz : vert #008300 et rouge #d03b3b ne se distinguent pas en deutéranopie (ΔE 5,9, sous le plancher de 6). Remplacé par le bleu de la paire divergente.

Limites connues

  1. Jours de coupure : la fin de nuit est alors la tension de redémarrage, pas l'état de charge. D'où de faux BETTER sous le plateau (VERMONT : 01/10, 03/10, 08/10).
  2. Dérive lente : une baisse de moins de 0,05 V par jour reste STABLE (VERMONT : du 22 au 24/09, de −0,007 à −0,016 V par jour, alors que la station s'épuise).
  3. Un jour nuageux donne WORSE, puis BETTER le lendemain. Ce qui comptera, c'est la série des tendances.
  4. Ordre de NO_CHARGE et BELOW_PLATEAU : choix de conception. Le premier dit qu'il n'y a pas d'apport, le second que la batterie est basse ; les deux ne se comparent pas sur une même échelle.
  5. Limites héritées de l'analyse 03 : jour UTC, seuil de 14,0 V, résolution horaire.
  6. La fin de nuit de J porte le bilan de J−1 : c'est celle du matin de J, avant sa charge. L'écart de fin de nuit de J résume donc la charge de J−1, alors que l'état est celui de J. Quand l'état change, la barre peut le contredire. Sur VERMONT, c'est le cas de 16 changements d'état sur 28, dont 3 au-delà de la zone morte : le 2026-04-12 passe de PARTIAL_CHARGE à FULL_CHARGE, avec −0,187 V après le 11/04 nuageux. Un décalage d'un jour a été écarté (voir « Options écartées »).

Pistes

  • Séries de tendances : plusieurs WORSE sans BETTER, pour la phase B ou la combinaison des analyses.
  • Jours de coupure : ignorer la fin de nuit d'un jour à moitié troué, ou la remplacer par le minimum avant le trou.

Historique

  • 2026-10-12 : conçue en brainstorming. L'utilisateur a choisi trois réponses plus l'inconnu, l'état d'abord puis la fin de nuit, et un panneau en barres. Spec écrite dans cette fiche (D-010).
  • 2026-10-12 : implémentée (src/battery_trend.py, panneau dans energy_plot.py, point d'entrée analyse_04.py). Résultats conformes à l'essai de conception, à un UNKNOWN près (le premier jour, sans veille). Couleur de « mieux » : bleu au lieu de vert (skill dataviz).
  • 2026-10-12 : sur le graphique, chaque barre est centrée sur midi UTC de son jour, et non plus sur 23:00 : à 23:00, elle débordait sur le lendemain (le 12/04 a été lu « 13 avril »). Le calcul ne change pas : le décalage d'un jour de la fin de nuit a été essayé, puis écarté (D-019, limite 6).
  • 2026-10-12 : titres, légendes et survols du graphique en anglais, pour le site de monitoring (D-023). Le calcul ne change pas.