Files
Support-Agent/docs/analyses/analyse_03.md
T
maximeandClaude Opus 5.5 e77d3e4b82 Spec analysis 03 DAILY_BATTERY_STATE, battery voltage report
- 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>
2026-10-12 10:43:36 +02:00

9.9 KiB
Raw Blame History

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 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. Il réutilise 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 attendus sur VERMONT (essai de conception, à confirmer à l'implémentation)

  • Répartition sur 184 jours : 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).