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>
10 KiB
10 KiB
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/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 depython3 src/energy/all_analyses.py(comparaison, D-016). - Code :
src/energy/battery_trend.py: calcul, bibliothèque standard uniquement (run()). Il s'appuie surbattery_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_STATElit chaque jour isolément.DAILY_BATTERY_TRENDcompare deux jours, et voit une dégradation à l'intérieur d'un même état, comme une suite dePARTIAL_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).
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) :
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 dansDAILY_BATTERY_STATE(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, commeDAILY_BATTERY_STATEen 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 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 panneauDAILY_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.
- 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
DAILY_BATTERY_STATE: 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.
- 2026-10-12 : fiche renommée d'après la règle (ex-
analyse_04.md) et déplacée dansdocs/energy/analyses/; code danssrc/energy/(D-026). Calcul inchangé.