Files
Support-Agent/docs/analyses/analyse_04.md
T

7.3 KiB
Raw Blame History

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

  • Statut : en conception (2026-10-12).
  • 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 : delta_night_end_v, en V, colorée selon la tendance (vert : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre) ;
    • 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)

Essai de conception (à confirmer à l'implémentation), sur 183 paires de jours :

  • Répartition : 137 STABLE, 26 WORSE, 20 BETTER, 0 UNKNOWN.
  • Jours sains : 120 paires FULL_CHARGE sur 125 sont STABLE.
  • 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.

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.

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.

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