Files
Support-Agent/docs/analyses/analyse_03.md
T
maximeandClaude Opus 5.5 eacc0ecd4a Add analysis 03 entry point and documentation
src/analyse_03.py launches the common page; sheet 03 moves to
"prototype en place" with VERMONT results; CLAUDE.md, README and
sheet 01 list the third panel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 10:53:15 +02:00

114 lines
10 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 03 — `DAILY_BATTERY_STATE` : état de la batterie jour par jour
- **Statut** : prototype en place (2026-10-12). Phase C : l'état seul, sans verdict. La phase B (niveaux gradués) viendra ensuite (D-018).
- **Script** : `python3 src/analyse_03.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 troisième panneau d'analyse (D-016).
- **Code** :
- `src/battery_state.py` : calcul, bibliothèque standard uniquement (`run()`, `day_facts()`). Il reçoit les séries chargées par `energy_check.load_stations` ;
- `src/energy_plot.py` : graphique plotly.
## Question posée
Dans quel état la batterie a-t-elle passé chaque journée : remplie, chargée sans se remplir, ou en décharge visible ?
- **Lien avec D-004** : une journée où l'apport remplit la batterie est soutenable ce jour-là. Une décharge visible signale un apport qui ne couvre pas la consommation.
- **Ce que l'analyse ajoute aux analyses 01 et 02** :
- pas d'inertie : l'état d'un jour ne dépend que de ce jour ;
- aucun historique nécessaire, donc utilisable **dès le premier jour d'installation**, pour repérer une alimentation absente ou un apport insuffisant.
- **Elle signale les journées incertaines** : sur le plateau LiFePO4, une charge partielle ne dit pas si la batterie a gagné ou perdu. C'est le moment d'indiquer au client que la situation énergétique est incertaine.
## Principe
On lit chaque journée UTC avec des seuils physiques du matériel : la fin de charge du chargeur et le coude LiFePO4. Ces seuils valent dès le premier jour, sans comparaison au passé (D-018). Les tensions de référence sont dans `docs/domaine/tensions-selon-l-etat-de-la-batterie.md`.
Calcul exact, pour chaque jour UTC d (de 00:00 à 23:00) ayant au moins une ligne `BusVoltage` :
1. Heures mesurées : valeurs `BusVoltage` non vides et finies. Une valeur vide, `NaN` ou `inf` compte comme « pas de mesure ». Un horodatage hors de la grille horaire lève une erreur, comme dans l'analyse 01.
2. `max_v` = maximum du jour ; `h_max` = première heure où il est atteint.
3. `night_end_v` = minimum des heures ≤ `h_max` (la fin de nuit, avant la charge du jour).
4. `rise_v` = `max_v` − `night_end_v` : la montée du jour.
5. `hours_full` = nombre d'heures ≥ `FULL_CHARGE_V`.
6. `coverage` = heures mesurées / 24.
7. L'état se lit dans cet ordre (la première condition vraie l'emporte) :
| Ordre | Condition | `state` | Lecture |
|---|---|---|---|
| 1 | `hours_full` ≥ 1 | `FULL_CHARGE` | l'apport a rempli la batterie |
| 2 | `night_end_v` < `PLATEAU_FLOOR_V` | `BELOW_PLATEAU` | décharge visible : la batterie a quitté le plateau |
| 3 | `coverage` < `MIN_COVERAGE` | `None` (UNKNOWN) | trop de trous pour conclure à une absence |
| 4 | `rise_v` < `MIN_RISE_V` | `NO_CHARGE` | décharge visible : aucun apport visible de la journée |
| 5 | sinon | `PARTIAL_CHARGE` | **incertain** : charge sans pleine charge, bilan du jour illisible sur le plateau |
- **Pourquoi les états 1 et 2 passent avant la couverture** : ils reposent sur une valeur mesurée, alors que les états 4 et 5 reposent sur l'absence de quelque chose. Un jour de coupure à moitié troué reste ainsi lisible s'il est passé sous le coude.
- **Jour sans aucune heure mesurée** : `state` = `None`.
Sortie (contrat commun) : un point par jour.
- `t` = dernière heure du jour présente dans la série.
- `value` = `max_v`, en V (`None` sans mesure).
- `anomaly` = `None` pour tous les jours. **En phase C, `None` veut dire « pas de verdict »**, et non UNKNOWN comme dans le contrat ; l'UNKNOWN de l'état est porté par `state = None`. La phase B remplira `anomaly`.
- `facts` = `{state, max_v, night_end_v, rise_v, hours_full, coverage}`.
**Causalité** : le jour d n'utilise que les heures de d. Pour le dernier jour d'un export, s'il est incomplet, l'état est provisoire : une heure ≥ 14,0 V ou un passage sous le coude peut encore survenir.
## Constantes et sources
| Constante | Valeur | Source |
|---|---|---|
| `FULL_CHARGE_V` | 14,0 V | VERMONT, du 2026-04-09 au 2026-10-09 : sur 173 jours d'au moins 20 h mesurées, le maximum du jour est sous 13,55 V pour 35 jours et entre 14,02 et 14,33 V pour 135 jours. Seuls 3 jours tombent entre les deux (13,59, 13,68 et 13,96 V). Note de domaine : ≥ 14,0 V signale une charge complète (absorption ~14,2 V). |
| `PLATEAU_FLOOR_V` | 12,8 V | Coude de la table OCV du collecteur (12,8 V = 30 %, `src/__main__ (3).py`). VERMONT : la pente de la baisse nocturne double sous 12,8 V (15 mV/h à 12,9 V, 29 mV/h à 12,8 V). |
| `MIN_RISE_V` | 0,05 V | Au-dessus des variations d'une heure à l'autre sur le plateau (≤ 15 mV/h la nuit), et sous la plus faible vraie montée observée sur VERMONT (+0,18 V le 2026-04-11). |
| `MIN_COVERAGE` | 0,8 | Repris de l'analyse 01 : 20 heures mesurées sur 24. |
## Graphique
- **Place** : troisième panneau d'analyse de la page commune, sous `MOVING_AVERAGE_7_DAYS_DROP` et `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` (D-016).
- **Contenu**, sur un seul axe en volts, avec un point par jour :
- le maximum du jour et la fin de nuit, en deux courbes ;
- les seuils de 14,0 V et 12,8 V en tirets. Ils sont tracés comme des courbes avec un point par jour, pour que le recalage au zoom (D-013) les garde visibles ;
- l'état du jour, en marqueurs colorés sur la courbe du maximum, une couleur et une entrée de légende par état.
- **Survol** : l'état et les faits du jour.
## Résultats sur VERMONT (jeu de travail)
- **Répartition sur 184 jours** (identique à l'essai de conception) : 139 `FULL_CHARGE`, 30 `PARTIAL_CHARGE`, 14 `BELOW_PLATEAU`, 1 `NO_CHARGE` (le 2026-05-05, au milieu de 3 jours nuageux), 0 UNKNOWN.
- **`PARTIAL_CHARGE`** :
- jours isolés en août (03/08, 15/08, 18/08) ;
- puis du 29/08 au 01/09 ;
- puis presque sans interruption à partir du 08/09 (seuls les 11, 18 et 19/09 sont `FULL_CHARGE`).
C'est cohérent avec l'expert : charges complètes déjà rares depuis fin août, puis déficit vers le 20/09.
- **`BELOW_PLATEAU`** du 2026-09-26 (fin de nuit à 12,71 V), un jour avant la première coupure (2026-09-27 01:00), jusqu'au 2026-10-09. Il couvre aussi les jours de coupure à moitié troués.
- **Séries saines de jours consécutifs sans pleine charge** : 3 jours au plus (du 04 au 06/05). Ensuite, 4 jours (29/08–01/09), 6 jours (12–17/09) et 20 jours (20/09–09/10).
## Options écartées
| Option | Pourquoi écartée |
|---|---|
| Comparer le jour au propre passé de la station (ex. maximum du jour face aux 30 derniers jours) | Aveugle à l'installation, faute d'historique, et sujette à l'accoutumance de l'analyse 01. |
| Hybride : seuils absolus les N premiers jours, puis comparaison au passé | Deux règles à calibrer et un changement de comportement au jour N, trop pour une première version. |
| Un état par heure, ou un état horaire résumé par jour | La frontière entre charge et décharge sur le plateau est fragile à l'heure près. L'utilisateur a choisi un état par jour. |
| États du collecteur (`BatteryState`, pente sur 60 s, ±2,5 mV/min) | Mis de côté par l'utilisateur. Ils demandent les données brutes à 1 Hz, et leur seuil (±150 mV/h) classe « stable » la charge et la décharge sur le plateau. |
| Verdict gradué dès cette version (phase B) | Reporté : d'abord l'état seul (phase C), choix de l'utilisateur. |
| Nouveau champ du contrat pour « pas de verdict » | Toucherait les analyses 01 et 02 ; `anomaly = None` documenté suffit en phase C. |
## Limites connues
1. **Jour UTC** : pour une station éloignée en longitude, la nuit serait coupée en deux par minuit UTC, et la « fin de nuit » serait faussée. Sur VERMONT, la fin de nuit tombe vers 04–06 h et le maximum entre 08 et 16 h UTC.
2. **Seuil de 14,0 V** : il suppose le même chargeur sur toutes les stations. Ce n'est pas confirmé, car ni le modèle ni les réglages du chargeur ne figurent dans la doc.
3. **Résolution horaire** : une absorption de moins d'une heure peut donner une moyenne sous 14,0 V, et le jour est alors lu `PARTIAL_CHARGE`. Exemple : le 2026-09-08, maximum 13,96 V.
4. **`PARTIAL_CHARGE` n'est pas une anomalie** : 30 jours sur 184, dont des jours sains nuageux. C'est la répétition qui comptera en phase B.
5. **Batterie de 7 Ah** : avec ~22 % de charge au matin (note de domaine), une station saine de 7 Ah à 5 W pourrait passer sous 12,8 V chaque nuit, et être lue `BELOW_PLATEAU` tous les jours. Ce n'est pas faux (la batterie quitte bien le plateau), mais c'est à vérifier sur une telle station. JUNGFRAU, station saine, a des nuits à 12,9 V : marge de 0,1 V.
6. **Secteur** : la tension reste vers 14,2–14,4 V, donc chaque jour est lu `FULL_CHARGE`. Après une perte secteur, le jour suivant devrait être lu `NO_CHARGE` ou `BELOW_PLATEAU`. Ce n'est pas vérifiable sur le jeu de travail, qui est solaire.
7. **Froid** : aucune donnée d'hiver. La charge LiFePO4 est en général bloquée sous 0 °C, d'où des jours `PARTIAL_CHARGE` ou `NO_CHARGE` possibles, même au soleil.
8. **Ambiguïté de `anomaly = None`** en phase C (voir « Principe »).
## Pistes
- **Phase B, niveaux gradués** : à partir des séries d'états. Par exemple, une série de `PARTIAL_CHARGE` plus longue que la plus longue série saine (3 jours sur VERMONT), un `NO_CHARGE`, ou un `BELOW_PLATEAU`.
- **Installation** : un `NO_CHARGE` dès le premier jour ensoleillé, ou aucune `FULL_CHARGE` les premiers jours, pour une alimentation absente ou un apport insuffisant.
- **Jour solaire propre à la station** : couper les journées sur le cycle observé plutôt qu'à minuit UTC (limite 1).
- **Consommation à l'installation** : `Power` révèle une veille profonde désactivée dès la première heure. C'est hors tension batterie, et laissé de côté pour l'instant.
## Historique
- **2026-10-12** : conçue en brainstorming. L'utilisateur a choisi l'approche 1 (seuils physiques, jour UTC) et la phase C (état seul) avant la phase B. Elle ouvre le changement d'échelle de D-018. Spec écrite dans cette fiche (D-010).
- **2026-10-12** : implémentée (`src/battery_state.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_03.py`). Résultats conformes à l'essai de conception.