Files
Support-Agent/docs/energy/analyses/daily_battery_trend.md
T
maximeandClaude Opus 5.5 8a32f4d418 Organize the project by domain and name analyses by their rule
Energy code moves to src/energy/ and its docs to docs/energy/; shared code
(CSV loading, venv switch, browser, zoom script) goes to src/common/, and the
AIMsight originals to docs/aimsight/. Analyses are no longer numbered: two
Energy scripts remain, daily.py (delivered state and trend) and
all_analyses.py (comparison of the four). Calculations and pages unchanged (D-026).

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

10 KiB
Raw Blame History

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/energy/daily.py [CSV ou dossiers] (défaut : data/). Il écrit la page livrée, out/<STATION>_daily.html + .json, dont cette analyse est le panneau du bas (D-021), et l'ouvre dans le navigateur. Elle est aussi le quatrième panneau de python3 src/energy/all_analyses.py (comparaison, D-016).
  • Code :
    • src/energy/battery_trend.py : calcul, bibliothèque standard uniquement (run()). Il s'appuie sur battery_state.run() (DAILY_BATTERY_STATE) ;
    • src/energy/daily.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 à DAILY_BATTERY_STATE :
    • DAILY_BATTERY_STATE lit chaque jour isolément. DAILY_BATTERY_TREND 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 (DAILY_BATTERY_STATE) à 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 DAILY_BATTERY_STATE (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 DAILY_BATTERY_STATE 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 daily_battery_state.md) : 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 DAILY_BATTERY_STATE, 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 DAILY_BATTERY_STATE : 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.
  • 2026-10-12 : fiche renommée d'après la règle (ex-analyse_04.md) et déplacée dans docs/energy/analyses/ ; code dans src/energy/ (D-026). Calcul inchangé.