- **Script** : `python3 src/energy/final.py [CSV ou dossiers]` (défaut : `data/VERMONT/`). 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).
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 ;
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)`.
-`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 %). |
- **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.
- 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. ;
- **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.
| 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. |
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.
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 »).
- **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** : 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é.