7.3 KiB
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 deanalyse_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 surbattery_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_CHARGEdont 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).
- 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
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) :
prev= le point précédent, s'il est bien la veille calendaire de J ; sinon, pas deprev.trend = None(UNKNOWN) etdecided_by = Nones'il n'y a pas deprev, ou si l'état de J ou celui de J−1 est inconnu (state = None).- 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 donneBETTER, un état plus bas donneWORSE. - 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= letdu jour J dans l'analyse 03 (dernière heure du jour présente dans la série).value=delta_night_end_v, en V (Nonesi l'un des deux jours n'a pas de fin de nuit).anomaly=Nonepour tous les jours : pas de verdict, comme l'analyse 03 en phase C. L'UNKNOWN de la tendance est porté partrend = 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.
- une barre par jour :
- 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, 26WORSE, 20BETTER, 0 UNKNOWN. - Jours sains : 120 paires
FULL_CHARGEsur 125 sontSTABLE. - Fin août à septembre : des
WORSEré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'unBETTERle 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
- Jours de coupure : la fin de nuit est alors la tension de redémarrage, pas l'état de charge. D'où de faux
BETTERsous le plateau (VERMONT : 01/10, 03/10, 08/10). - 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). - Un jour nuageux donne
WORSE, puisBETTERle lendemain. Ce qui comptera, c'est la série des tendances. - Ordre de
NO_CHARGEetBELOW_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. - Limites héritées de l'analyse 03 : jour UTC, seuil de 14,0 V, résolution horaire.
Pistes
- Séries de tendances : plusieurs
WORSEsansBETTER, 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).