Fix DAILY_BATTERY_STATE night end and rise, document phase C contract
The night end and rise were anchored on the first daily maximum, which can be the 00:00 tail of the previous evening: 2026-05-05 was read NO_CHARGE despite a +0.079 V rise, 2026-09-30 showed a wrong night end, and 2026-09-26 stayed unknown from 04:00 to 11:00 when evaluated mid-day. The rise now starts from an earlier minimum and the knee is tested on the daily minimum (min_v). VERMONT: 139 / 31 / 14 / 0. Docs: sheet 02 page order, battery_state.py in the CLAUDE.md map, phase C exception to "anomaly = None means UNKNOWN". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
eacc0ecd4a
commit
5e039ef3bb
5 files changed
+27
-18
No files matched your search
@@ -14,7 +14,7 @@ paths:
|
||||
- **Contrat commun** :
|
||||
- `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}` ;
|
||||
- calcul **causal** : le point t n'utilise que les données ≤ t ;
|
||||
- `anomaly = None` signifie UNKNOWN ;
|
||||
- `anomaly = None` signifie UNKNOWN (exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`) ;
|
||||
- une analyse seule conclut au plus `consistent with`.
|
||||
- **Code de calcul** : bibliothèque standard uniquement, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`).
|
||||
- **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source.
|
||||
|
||||
@@ -64,7 +64,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
- `AIMsight FAQ.pdf` et `AIMsight Test Manual.pdf` (ce dernier est en réalité le manuel de la station) : définitions des signaux et des colonnes CSV, alimentation, schedules. Pour les lire : `pdftotext -layout "doc/<fichier>.pdf" -`.
|
||||
- `data/` : **jeu de travail = VERMONT seule**, le seul dataset complet (les 7 métriques système, telles qu'extraites de la plateforme) + diagnostics experts (`metadata.md`, `d.md`). Les analyses tournent uniquement sur ce jeu.
|
||||
- `data/archive/` : `BusVoltage` seule des autres stations (incomplètes), mises de côté le 2026-10-09. Non analysées ; ne pas les réintroduire sans demande.
|
||||
- `src/analyse_NN.py` : point d'entrée de chaque analyse. Code partagé : `src/energy_check.py` (bibliothèque standard uniquement, embarquable) et `src/energy_plot.py` (plotly, poste de dev).
|
||||
- `src/analyse_NN.py` : point d'entrée de chaque analyse. Code partagé : `src/energy_check.py` (analyses 01 et 02, bibliothèque standard uniquement, embarquable), `src/battery_state.py` (analyse 03, idem) et `src/energy_plot.py` (plotly, poste de dev).
|
||||
- `src/__main__ (3).py` : copie de référence du collecteur `system_info` embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω). Source des unités. Ne pas modifier.
|
||||
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
||||
|
||||
@@ -75,7 +75,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana
|
||||
- **Pas de LLM, pas de données synthétiques** (ni CSV simulés, ni générateur de scénarios : refus explicite de l'utilisateur). Le code d'analyse est **embarquable** : bibliothèque standard, calcul léger.
|
||||
- **Anomalie énergétique = régime non soutenable** (l'apport ne couvre pas la consommation), pas une batterie basse. Une station débranchée avec une batterie pleine est déjà en anomalie.
|
||||
- **Analyses combinées** : chaque analyse est une preuve imparfaite, juste « dans la majorité des cas » ; la combinaison fait le diagnostic. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
|
||||
- Contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Calcul causal (le point t n'utilise que les données ≤ t). `anomaly = None` signifie UNKNOWN.
|
||||
- Contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Calcul causal (le point t n'utilise que les données ≤ t). `anomaly = None` signifie UNKNOWN (exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`).
|
||||
- Une analyse seule conclut au plus `consistent with`.
|
||||
- **Livrable** : un graphique HTML par station. En haut, les analyses, un panneau chacune (courbes superposées, D-016) ; dessous, un graphique par série temporelle. Zoom dans le temps seulement, avec l'ordonnée recalée sur la plage visible (D-011, D-013).
|
||||
- **Ouvert** : architecture (à définir plus tard, ne pas la figer ici), destinataire du diagnostic (client final ou ingénieur support).
|
||||
|
||||
@@ -36,7 +36,7 @@ Le calcul est **causal** : le point d n'utilise que les mesures de minuit ≤ d.
|
||||
|
||||
## Graphique
|
||||
|
||||
- **Page commune** (D-016) : le panneau `MOVING_AVERAGE_7_DAYS_DROP` en haut, ce panneau juste dessous, puis un graphique par série temporelle.
|
||||
- **Page commune** (D-016) : le panneau `MOVING_AVERAGE_7_DAYS_DROP` en haut, ce panneau juste dessous, puis le panneau de l'analyse 03 (`DAILY_BATTERY_STATE`), puis un graphique par série temporelle.
|
||||
- Mêmes conventions que l'analyse 01 :
|
||||
- moyenne sur 7 jours (bleu) et seuil = référence − 0,2 V (rouge), sur un seul axe en volts (D-015) ;
|
||||
- fond rouge sur les périodes d'anomalie ;
|
||||
|
||||
@@ -22,9 +22,9 @@ On lit chaque journée UTC avec des seuils physiques du matériel : la fin de ch
|
||||
|
||||
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.
|
||||
2. `max_v` et `min_v` = maximum et minimum du jour.
|
||||
3. `rise_v` = la plus grande montée du jour depuis un minimum antérieur : max sur h de (tension à h − minimum des heures ≤ h).
|
||||
4. `night_end_v` = le minimum dont part cette montée (la fin de nuit, avant la charge du jour) ; sans montée, `min_v`. Le maximum du jour ne sert pas de repère : il peut être la queue de la soirée précédente, à 00:00.
|
||||
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) :
|
||||
@@ -32,7 +32,7 @@ Calcul exact, pour chaque jour UTC d (de 00:00 à 23:00) ayant au moins une lign
|
||||
| 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 |
|
||||
| 2 | `min_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 |
|
||||
@@ -44,7 +44,7 @@ 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}`.
|
||||
- `facts` = `{state, max_v, min_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.
|
||||
|
||||
@@ -54,7 +54,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
|---|---|---|
|
||||
| `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_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,079 V le 2026-05-05, jour nuageux ; ensuite +0,18 V le 2026-04-11). |
|
||||
| `MIN_COVERAGE` | 0,8 | Repris de l'analyse 01 : 20 heures mesurées sur 24. |
|
||||
|
||||
## Graphique
|
||||
@@ -68,7 +68,8 @@ Sortie (contrat commun) : un point par 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.
|
||||
- **Répartition sur 184 jours** : 139 `FULL_CHARGE`, 31 `PARTIAL_CHARGE`, 14 `BELOW_PLATEAU`, 0 `NO_CHARGE`, 0 UNKNOWN. L'essai de conception lisait le 2026-05-05 `NO_CHARGE` ; avec la montée corrigée (voir « Historique »), il est `PARTIAL_CHARGE` (+0,079 V de 06:00 à 10:00).
|
||||
- **Rejeu causal** (chaque jour évalué à chaque heure) : dès qu'une mesure du jour passe sous 12,8 V, le jour est lu `BELOW_PLATEAU`. Le 2026-09-26, c'est le cas dès 04:00 UTC.
|
||||
- **`PARTIAL_CHARGE`** :
|
||||
- jours isolés en août (03/08, 15/08, 18/08) ;
|
||||
- puis du 29/08 au 01/09 ;
|
||||
@@ -94,7 +95,7 @@ Sortie (contrat commun) : un point par jour.
|
||||
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.
|
||||
4. **`PARTIAL_CHARGE` n'est pas une anomalie** : 31 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.
|
||||
@@ -111,3 +112,4 @@ Sortie (contrat commun) : un point par jour.
|
||||
|
||||
- **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.
|
||||
- **2026-10-12** : corrigée après la relecture finale. La fin de nuit et la montée étaient calées sur le premier maximum du jour, qui peut être la tension de 00:00 (queue de la soirée précédente). Conséquences : le 2026-05-05 était lu `NO_CHARGE` malgré une montée de +0,079 V, la fin de nuit affichée du 2026-09-30 était fausse (12,68 V au lieu de 12,19 V), et le 2026-09-26, évalué en cours de journée, restait UNKNOWN de 04:00 à 11:00 malgré des mesures sous 12,8 V. Désormais, la montée part d'un minimum antérieur, et le coude se teste sur le minimum du jour (`min_v`).
|
||||
+13
-6
@@ -29,16 +29,23 @@ def day_facts(day):
|
||||
"""{heure UTC: tension mesurée} d'un jour -> faits et état (fiche analyse_03, « Principe »)."""
|
||||
if not day:
|
||||
return {"state": None, "coverage": 0.0}
|
||||
h_max = max(sorted(day), key=day.get) # première heure où le maximum est atteint
|
||||
max_v = day[h_max]
|
||||
night_end_v = min(v for h, v in day.items() if h <= h_max)
|
||||
rise_v = max_v - night_end_v
|
||||
max_v, min_v = max(day.values()), min(day.values())
|
||||
# Montée du jour : la plus grande hausse depuis un minimum antérieur ; la fin de nuit est ce minimum.
|
||||
# (Le maximum du jour peut être la queue de la soirée précédente, à 00:00 : il ne sert pas de repère.)
|
||||
low = night_end_h = min(day)
|
||||
rise_v = 0.0
|
||||
for h in sorted(day):
|
||||
if day[h] < day[low]:
|
||||
low = h
|
||||
if day[h] - day[low] > rise_v:
|
||||
rise_v, night_end_h = day[h] - day[low], low
|
||||
night_end_v = day[night_end_h] if rise_v else min_v # sans montée : le point le plus bas du jour
|
||||
hours_full = sum(v >= FULL_CHARGE_V for v in day.values())
|
||||
coverage = len(day) / 24
|
||||
# Les états 1 et 2 reposent sur une valeur mesurée : ils passent avant la couverture minimale.
|
||||
if hours_full:
|
||||
state = "FULL_CHARGE"
|
||||
elif night_end_v < PLATEAU_FLOOR_V:
|
||||
elif min_v < PLATEAU_FLOOR_V:
|
||||
state = "BELOW_PLATEAU"
|
||||
elif coverage < MIN_COVERAGE:
|
||||
state = None # UNKNOWN : trop de trous pour conclure à une absence
|
||||
@@ -46,7 +53,7 @@ def day_facts(day):
|
||||
state = "NO_CHARGE"
|
||||
else:
|
||||
state = "PARTIAL_CHARGE"
|
||||
return {"state": state, "max_v": round(max_v, 3), "night_end_v": round(night_end_v, 3),
|
||||
return {"state": state, "max_v": round(max_v, 3), "min_v": round(min_v, 3), "night_end_v": round(night_end_v, 3),
|
||||
"rise_v": round(rise_v, 3), "hours_full": hours_full, "coverage": round(coverage, 3)}
|
||||
|
||||
|
||||
|
||||
Reference in new issue
Block a user