- docs/analyses/analyse_03.md: design of the daily battery state analysis (phase C, state only): FULL_CHARGE / BELOW_PLATEAU / NO_CHARGE / PARTIAL_CHARGE per UTC day, hardware thresholds (14.0 V end of charge, 12.8 V LiFePO4 knee), status "en conception". - D-018: next analyses give a day-by-day state with hardware thresholds, usable from installation day; phase C then phase B. - docs/domaine: voltage report per battery state (charging, full, discharging) with sources; Power dispersion on VERMONT. - CLAUDE.md: analyses table, state and next step, domain map. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.9 KiB
Analyse 03 — DAILY_BATTERY_STATE : état de la batterie jour par jour
- Statut : en conception (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 deanalyse_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. Il réutiliseenergy_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 :
- Heures mesurées : valeurs
BusVoltagenon vides et finies. Une valeur vide,NaNouinfcompte comme « pas de mesure ». Un horodatage hors de la grille horaire lève une erreur, comme dans l'analyse 01. max_v= maximum du jour ;h_max= première heure où il est atteint.night_end_v= minimum des heures ≤h_max(la fin de nuit, avant la charge du jour).rise_v=max_v−night_end_v: la montée du jour.hours_full= nombre d'heures ≥FULL_CHARGE_V.coverage= heures mesurées / 24.- 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 (Nonesans mesure).anomaly=Nonepour tous les jours. En phase C,Noneveut dire « pas de verdict », et non UNKNOWN comme dans le contrat ; l'UNKNOWN de l'état est porté parstate = None. La phase B rempliraanomaly.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_DROPetMOVING_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 attendus sur VERMONT (essai de conception, à confirmer à l'implémentation)
-
Répartition sur 184 jours : 139
FULL_CHARGE, 30PARTIAL_CHARGE, 14BELOW_PLATEAU, 1NO_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_PLATEAUdu 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
- 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.
- 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.
- 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. PARTIAL_CHARGEn'est pas une anomalie : 30 jours sur 184, dont des jours sains nuageux. C'est la répétition qui comptera en phase B.- 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_PLATEAUtous 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. - 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 luNO_CHARGEouBELOW_PLATEAU. Ce n'est pas vérifiable sur le jeu de travail, qui est solaire. - Froid : aucune donnée d'hiver. La charge LiFePO4 est en général bloquée sous 0 °C, d'où des jours
PARTIAL_CHARGEouNO_CHARGEpossibles, même au soleil. - Ambiguïté de
anomaly = Noneen phase C (voir « Principe »).
Pistes
- Phase B, niveaux gradués : à partir des séries d'états. Par exemple, une série de
PARTIAL_CHARGEplus longue que la plus longue série saine (3 jours sur VERMONT), unNO_CHARGE, ou unBELOW_PLATEAU. - Installation : un
NO_CHARGEdès le premier jour ensoleillé, ou aucuneFULL_CHARGEles 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 :
Powerré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).