Files
Support-Agent/docs/analyses/analyse_04.md
T

88 lines
7.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).