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>
9.7 KiB
9.7 KiB
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 dansfacts.trend. - 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, 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.
- une barre par jour, centrée sur midi UTC de ce jour (D-019) :
- 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, 26WORSE, 20BETTER, 1 UNKNOWN (le 2026-04-09, premier jour de l'export, sans veille). - Jours sains : sur 125 paires
FULL_CHARGEenchaînées, 120 sontSTABLE, 4BETTERet 1WORSE. WORSEisolés en août (08-03, 08-15, 08-18) : des jours nuageux, chacun suivi d'unBETTER.- 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. - L'état décide contre la fin de nuit : le 2026-08-29 (
FULL_CHARGE→PARTIAL_CHARGE) estWORSE, alors que la fin de nuit monte de +0,041 V. - Sous le plateau (du 26/09 au 09/10) : des
BETTERles 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
- 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.
- 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
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).
- 2026-10-12 : implémentée (
src/battery_trend.py, panneau dansenergy_plot.py, point d'entréeanalyse_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.