Spec analysis 04 DAILY_BATTERY_TREND (day-over-day battery trend)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
5e039ef3bb
commit
f518881121
1 file changed
+87
@@ -0,0 +1,87 @@
|
||||
# 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).
|
||||
Reference in new issue
Block a user