Organize the project by domain and name analyses by their rule
Energy code moves to src/energy/ and its docs to docs/energy/; shared code (CSV loading, venv switch, browser, zoom script) goes to src/common/, and the AIMsight originals to docs/aimsight/. Analyses are no longer numbered: two Energy scripts remain, daily.py (delivered state and trend) and all_analyses.py (comparison of the four). Calculations and pages unchanged (D-026). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
77c8f24d2f
commit
8a32f4d418
44 files changed
+1757
-771
No files matched your search
@@ -0,0 +1,120 @@
|
||||
# `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/energy/daily.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/<STATION>_daily.html` + `.json`, dont cette analyse est le panneau du haut (D-021), et l'ouvre dans le navigateur. Elle est aussi le troisième panneau de `python3 src/energy/all_analyses.py` (comparaison, D-016).
|
||||
- **Code** :
|
||||
- `src/energy/battery_state.py` : calcul, bibliothèque standard uniquement (`run()`, `day_facts()`). Il reçoit les séries chargées par `common.stations.load_stations`, mais n'importe rien d'autre du projet : avec `src/energy/battery_trend.py`, il se livre seul à la plateforme (D-021) ;
|
||||
- `src/energy/daily.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 deux `MOVING_AVERAGE_*`** :
|
||||
- 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/energy/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 `MOVING_AVERAGE_7_DAYS_DROP`.
|
||||
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) :
|
||||
|
||||
| Ordre | Condition | `state` | Lecture |
|
||||
|---|---|---|---|
|
||||
| 1 | `hours_full` ≥ 1 | `FULL_CHARGE` | l'apport a rempli la batterie |
|
||||
| 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 |
|
||||
|
||||
- **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, min_v, night_end_v, night_end_h, rise_v, hours_full, coverage}`. `night_end_h` est l'heure UTC (0 à 23) de la fin de nuit.
|
||||
|
||||
**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 %, `docs/aimsight/collecteur_system_info.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,079 V le 2026-05-05, jour nuageux ; ensuite +0,18 V le 2026-04-11). |
|
||||
| `MIN_COVERAGE` | 0,8 | Repris de `MOVING_AVERAGE_7_DAYS_DROP` : 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, placé à midi UTC de ce jour (au milieu de la journée, et non à son `t`, D-019) :
|
||||
- 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** : 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 ;
|
||||
- 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 `MOVING_AVERAGE_7_DAYS_DROP`. |
|
||||
| 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. |
|
||||
| Fin de nuit de la nuit qui suit le jour (matin de d+1) | Essayée le 2026-10-12, puis écartée par l'utilisateur, dans `DAILY_BATTERY_STATE` comme dans `DAILY_BATTERY_TREND` : `DAILY_BATTERY_STATE` reste sur les heures du jour lui-même (D-019). |
|
||||
| Nouveau champ du contrat pour « pas de verdict » | Toucherait les deux `MOVING_AVERAGE_*` ; `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** : 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.
|
||||
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.
|
||||
- **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`).
|
||||
- **2026-10-12** : sur le graphique, chaque point est placé à midi UTC de son jour, et non plus à 23:00, comme les barres de l'analyse 04 (D-019). Le calcul ne change pas.
|
||||
- **2026-10-12** : titres, légendes et survols du graphique en anglais, pour le site de monitoring (D-023). Le calcul ne change pas.
|
||||
- **2026-10-12** : nouveau fait `night_end_h` (heure de la fin de nuit), pour placer la fin de nuit sur le graphique focus J−1 / J (D-024). Les autres faits ne changent pas (vérifié sur les 184 jours de VERMONT).
|
||||
- **2026-10-12** : fiche renommée d'après la règle (ex-`analyse_03.md`) et déplacée dans `docs/energy/analyses/` ; code dans `src/energy/` (D-026). Calcul inchangé.
|
||||
@@ -0,0 +1,97 @@
|
||||
# `DAILY_BATTERY_TREND` : tendance de la batterie d'un jour à l'autre
|
||||
|
||||
- **Statut** : prototype en place (2026-10-12). Pas de verdict : `anomaly = None`, la tendance est dans `facts.trend`.
|
||||
- **Script** : `python3 src/energy/daily.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/<STATION>_daily.html` + `.json`, dont cette analyse est le panneau du bas (D-021), et l'ouvre dans le navigateur. Elle est aussi le quatrième panneau de `python3 src/energy/all_analyses.py` (comparaison, D-016).
|
||||
- **Code** :
|
||||
- `src/energy/battery_trend.py` : calcul, bibliothèque standard uniquement (`run()`). Il s'appuie sur `battery_state.run()` (`DAILY_BATTERY_STATE`) ;
|
||||
- `src/energy/daily.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 à `DAILY_BATTERY_STATE`** :
|
||||
- `DAILY_BATTERY_STATE` lit chaque jour isolément. `DAILY_BATTERY_TREND` 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 (`DAILY_BATTERY_STATE`) à 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 `DAILY_BATTERY_STATE` (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 `DAILY_BATTERY_STATE` 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 `daily_battery_state.md`) : 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 `DAILY_BATTERY_STATE`, juste au-dessus, sur le même axe du temps.
|
||||
- **Contenu** :
|
||||
- une barre par jour, centrée sur midi UTC de ce jour (D-019) : `delta_night_end_v`, en V, colorée selon la tendance (bleu : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre). Ce sont la paire divergente et le gris neutre du skill dataviz. ;
|
||||
- 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)
|
||||
|
||||
Sur 184 jours (du 2026-04-09 au 2026-10-09) :
|
||||
- **Répartition** : 137 `STABLE`, 26 `WORSE`, 20 `BETTER`, 1 UNKNOWN (le 2026-04-09, premier jour de l'export, sans veille).
|
||||
- **Jours sains** : sur 125 paires `FULL_CHARGE` enchaînées, 120 sont `STABLE`, 4 `BETTER` et 1 `WORSE`.
|
||||
- **`WORSE` isolés en août** (08-03, 08-15, 08-18) : des jours nuageux, chacun suivi d'un `BETTER`.
|
||||
- **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.
|
||||
- **L'état décide contre la fin de nuit** : le 2026-08-29 (`FULL_CHARGE` → `PARTIAL_CHARGE`) est `WORSE`, alors que la fin de nuit monte de +0,041 V.
|
||||
- **Sous le plateau** (du 26/09 au 09/10) : des `BETTER` les 01/10, 03/10 et 08/10, faux (limite 1).
|
||||
|
||||
## 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. |
|
||||
| Décaler l'écart de fin de nuit d'un jour (matin de J+1 − matin de J), pour qu'il porte sur la même journée que l'état | Essayé le 2026-10-12, puis écarté par l'utilisateur. Sur VERMONT, il ramenait les barres contraires à l'état de 16 à 4, toutes dans la zone morte, au prix d'un jour de retard (D-019). |
|
||||
| Vert pour « mieux » (design validé en brainstorming) | Refusé par le validateur du skill dataviz : vert `#008300` et rouge `#d03b3b` ne se distinguent pas en deutéranopie (ΔE 5,9, sous le plancher de 6). Remplacé par le bleu de la paire divergente. |
|
||||
|
||||
## 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 `DAILY_BATTERY_STATE`** : jour UTC, seuil de 14,0 V, résolution horaire.
|
||||
6. **La fin de nuit de J porte le bilan de J−1** : c'est celle du matin de J, avant sa charge. L'écart de fin de nuit de J résume donc la charge de J−1, alors que l'état est celui de J. Quand l'état change, la barre peut le contredire. Sur VERMONT, c'est le cas de 16 changements d'état sur 28, dont 3 au-delà de la zone morte : le 2026-04-12 passe de `PARTIAL_CHARGE` à `FULL_CHARGE`, avec −0,187 V après le 11/04 nuageux. Un décalage d'un jour a été écarté (voir « Options écartées »).
|
||||
|
||||
## 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).
|
||||
- **2026-10-12** : implémentée (`src/battery_trend.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_04.py`). Résultats conformes à l'essai de conception, à un UNKNOWN près (le premier jour, sans veille). Couleur de « mieux » : bleu au lieu de vert (skill dataviz).
|
||||
- **2026-10-12** : sur le graphique, chaque barre est centrée sur midi UTC de son jour, et non plus sur 23:00 : à 23:00, elle débordait sur le lendemain (le 12/04 a été lu « 13 avril »). Le calcul ne change pas : le décalage d'un jour de la fin de nuit a été essayé, puis écarté (D-019, limite 6).
|
||||
- **2026-10-12** : titres, légendes et survols du graphique en anglais, pour le site de monitoring (D-023). Le calcul ne change pas.
|
||||
- **2026-10-12** : fiche renommée d'après la règle (ex-`analyse_04.md`) et déplacée dans `docs/energy/analyses/` ; code dans `src/energy/` (D-026). Calcul inchangé.
|
||||
@@ -0,0 +1,110 @@
|
||||
# `MOVING_AVERAGE_7_DAYS_DROP` : tendance de la tension batterie
|
||||
|
||||
- **Statut** : prototype, en place (2026-10-09).
|
||||
- **Script** : `python3 src/energy/all_analyses.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_energy.html` et l'ouvre dans le navigateur. Cette analyse est le premier panneau, et `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` est juste dessous (D-016). Elle sert à la comparaison seulement : elle n'est pas livrée (D-020).
|
||||
- **Code** :
|
||||
- `src/energy/moving_average.py` : calcul, bibliothèque standard uniquement. `run()` appelle `_ma_drop()`, commun avec `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`. Les séries sont chargées par `common.stations.load_stations` ;
|
||||
- `src/energy/all_analyses.py` : graphique plotly.
|
||||
|
||||
## Question posée
|
||||
|
||||
Le régime énergétique de la station se dégrade-t-il, et depuis quand ? Voir D-004 : anomalie = régime non soutenable.
|
||||
|
||||
## Principe
|
||||
|
||||
La moyenne de `BusVoltage` sur 7 jours est comparée à son propre maximum des 30 jours précédents. Si elle est descendue de plus de 0,2 V, le point est en anomalie. Comparer la station à son propre passé évite d'avoir un seuil de tension absolu, qui ne se transpose pas d'une station à l'autre (secteur ~14,25 V, solaire ~13,4 V).
|
||||
|
||||
Calcul exact, sur la grille horaire et pour chaque horodatage t :
|
||||
1. `ma(t)` = moyenne des valeurs non vides sur les 168 créneaux t−167 h … t. Elle n'est définie que si au moins 80 % des créneaux sont remplis.
|
||||
2. `ref(t)` = maximum de `ma` sur les 720 créneaux t−720 h … t−1 h. Elle n'est définie que si au moins 24 de ces `ma` existent.
|
||||
3. `value(t)` = `ma(t)` − `ref(t)`, en V.
|
||||
4. `anomaly(t)` = `value < −0,2` ; vaut `None` (UNKNOWN) si `ma` ou `ref` n'est pas défini.
|
||||
|
||||
Le calcul est **causal** : le point t n'utilise que les données ≤ t, donc il équivaut au temps réel embarqué. Une valeur vide, un créneau absent, `NaN` ou `inf` comptent comme « pas de mesure ». Un horodatage hors de la grille horaire lève une erreur.
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| `WINDOW_H` | 168 | Multiple de 24 h, pour annuler le cycle jour/nuit. Avec 72 h, la météo dominait : 2 jours nuageux faisaient baisser JUNGFRAU (sain) d'environ −100 mV/j, autant qu'un vrai déficit. |
|
||||
| `REF_H` | 720 | 30 jours, pour contenir le dernier régime sain avant un déficit. Choix de conception. |
|
||||
| `MIN_COVERAGE` | 0,8 | À 50 %, la fenêtre réellement remplie est trop courte en début d'historique : JUNGFRAU tombait à −0,19 V. À 80 %, il reste à −0,13 V. |
|
||||
| `MIN_REF_POINTS` | 24 | Au moins un jour de référence. Choix de conception. |
|
||||
| `THRESHOLD_V` | −0,2 | Calé sur 5 stations (voir « Calibration »). Pire cas sain : −0,16 V (VERMONT, mai, 3 jours nuageux). |
|
||||
|
||||
## Graphique
|
||||
|
||||
Disposition (D-011) :
|
||||
- **En haut, l'analyse**, sur un seul axe en volts (D-015) :
|
||||
- la moyenne sur 7 jours (bleu) ;
|
||||
- le seuil = référence − 0,2 V (rouge) : l'anomalie commence là où la bleue passe sous la rouge ;
|
||||
- un fond rouge sur les périodes d'anomalie.
|
||||
- **Juste dessous, le panneau `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`**, mêmes conventions, pour comparer les deux méthodes (D-016).
|
||||
- **Puis le panneau `DAILY_BATTERY_STATE`** : état de la batterie jour par jour (fiche `daily_battery_state.md`).
|
||||
- **Puis le panneau `DAILY_BATTERY_TREND`** : tendance de la batterie d'un jour à l'autre (fiche `daily_battery_trend.md`).
|
||||
- **Dessous, un graphique par série temporelle**, chacun avec sa propre échelle : `BusVoltage` d'abord (bandes grises sur ses trous, et en fond les 3 zones d'état de la batterie : décharge 12,0–13,2 V, en charge 13,1–13,8 V, pleine charge 14,0–14,4 V, d'après `docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md` ; `ZONES` dans `src/energy/all_analyses.py`), puis les autres champs par ordre alphabétique.
|
||||
- **Abscisse** : les dates sont affichées sous chaque graphique, pas seulement sous le dernier.
|
||||
- **Zoom** : il est horizontal seulement, dans le temps, et commun à tous les graphiques. On zoome en tirant un rectangle ou à la molette (`scrollZoom`). Après chaque zoom ou déplacement, l'ordonnée de chaque graphique est recalée sur les points visibles, avec 5 % de marge (`AUTOSCALE_Y_JS` dans `src/common/page.py`). La ligne de seuil reste toujours visible. Un double-clic revient à la vue complète.
|
||||
- Le script utilise l'API interne de plotly.js (`_fullLayout`, `d2l`, `r2l`). La version de plotly.js chargée depuis le CDN est celle du paquet Python, donc figée, mais une mise à jour majeure de plotly pourrait casser ce script.
|
||||
- **Survol** (sur la moyenne) : il affiche l'écart, le verdict et les faits du point (`ma_v`, `ref_v`, `ref_t`, couverture).
|
||||
|
||||
Le résumé texte et `out/<STATION>_energy.json` ont été supprimés (D-026) ; les périodes d'anomalie restent visibles, en rouge, sur la page.
|
||||
|
||||
## Résultats sur VERMONT (jeu de travail)
|
||||
|
||||
- Anomalie **à partir du 2026-09-24 07:00**, jusqu'à la fin de l'export. La première coupure nocturne est le 2026-09-27 01:00, donc ~2,8 jours d'avance.
|
||||
- Pire écart le 2026-10-09 01:00 : moyenne sur 7 jours 12,78 V, soit 0,55 V sous son maximum du 2026-09-09 06:00 (13,33 V).
|
||||
- 198 h sans verdict sur 4393, surtout la montée en charge des fenêtres au début de l'historique.
|
||||
- Le diagnostic expert situe le début du déficit vers le 20/09.
|
||||
|
||||
## Calibration (historique : stations désormais dans `data/archive/`)
|
||||
|
||||
| Station | Diagnostic expert | Résultat |
|
||||
|---|---|---|
|
||||
| FLORIDA | secteur, sain | aucune anomalie, pire écart −0,04 V |
|
||||
| JUNGFRAU | solaire, sain | aucune anomalie, pire écart −0,13 V |
|
||||
| WILDSTRUBEL | décharge profonde | anomalie dès le 2026-09-06 14:00, coupure le 2026-09-09 22:00 (~3,3 j d'avance) |
|
||||
| MISSISSIPPI | coupures secteur | anomalie dès le 2025-12-09 12:00, 1re coupure énergétique le 2025-12-25 14:00. Résumé : 5 mois sans verdict, du 2025-12-26 23:00 au 2026-06-07 16:00 |
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| Score d'anomalie continu entre 0 et 1 | C'est une pseudo-probabilité, interdite. On garde un écart en volts, qui est une grandeur physique. |
|
||||
| Échelle à 4 niveaux avec des règles séparées solaire/secteur | L'utilisateur préférait une seule analyse simple. La combinaison viendra de plusieurs analyses (D-005). |
|
||||
| Seuil absolu sur le minimum nocturne (ex. 13,0 V) | Il ne se transpose pas d'une station à l'autre : JUNGFRAU, station saine, a des nuits à 12,9 V. |
|
||||
| Seuil absolu au coude LiFePO4 (12,8 V) | Il se déclenche trop tard (0 à 1 jour avant la coupure) et décrit le niveau de charge, pas la soutenabilité (D-004). |
|
||||
| Fenêtre de 72 h | La météo domine : 2 jours nuageux font baisser une station saine autant qu'un vrai déficit. |
|
||||
| Couverture minimale de 50 % | En début d'historique, la fenêtre réellement remplie devient trop courte : JUNGFRAU tombait à −0,19 V. |
|
||||
| Taux de jours à charge complète comme règle principale | Plus précoce (~10 jours pour VERMONT), mais la moyenne glissante a été retenue comme première analyse simple. Il reste une piste. |
|
||||
| Autonomie sans apport, ou bilan net par cycle | La capacité de la batterie (7 ou 21 Ah) est inconnue, et le plateau LiFePO4 rend la charge illisible. Reporté. |
|
||||
| Traiter les `NaN` à la lecture du CSV (`load_csv`) | Ils sont traités dans `run()`, qui est le point de passage commun à toutes les sources de données futures. |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. **Marge mince** : le pire cas sain est à −0,16 V pour un seuil à −0,2 V. Depuis D-009, plus aucune station saine n'est dans le jeu de travail pour revérifier ce point.
|
||||
2. **Retard sur une perte secteur** : elle n'est détectée que 25 à 31 h après le début (MISSISSIPPI). Une station débranchée avec une petite batterie (7 Ah, ~15 h d'autonomie à 5 W) coupe avant l'alerte.
|
||||
3. **Biais pendant les coupures** : ce sont les valeurs les plus basses de la nuit qui manquent, donc `ma` est biaisé vers le haut. Sous 80 % de couverture, le point passe en UNKNOWN.
|
||||
4. **Accoutumance** : après ~30 jours de déficit continu, la référence s'aligne sur le déficit et l'anomalie peut disparaître alors que la station coupe encore chaque nuit. C'est une propriété de la règle relative. **Point ouvert**.
|
||||
5. **Retard en fin de période** : MISSISSIPPI retrouve le secteur le 2025-12-12 12:00 mais reste signalée jusqu'au 2025-12-18 06:00 (~6 jours).
|
||||
6. **Graphique dépendant d'internet** : la page charge plotly.js depuis le CDN et ne s'affiche pas hors ligne.
|
||||
|
||||
## Pistes (analyses suivantes, même contrat)
|
||||
|
||||
- **Classement des trous** : coupure d'alimentation, cause externe, début d'historique, retard de synchronisation. Il s'appuie sur la tension avant et après le trou, comparée au coude LiFePO4 (~12,8 V).
|
||||
- **Signature « station éteinte »** : chute de `sensor_thermal` pendant un trou (l'auto-échauffement de ~5 W s'arrête).
|
||||
- **Taux de jours à charge complète** (≥ 14,0 V) sur 7 jours : alerte plus précoce en solaire (~10 j pour VERMONT). Couvrirait la limite 4.
|
||||
- **Indicateur rapide de perte secteur** : sortie de la tension de maintien. Couvrirait la limite 2.
|
||||
- **Autonomie sans apport** : énergie restante ÷ `Power`. Demande la capacité de la batterie (7 ou 21 Ah ; les nuits de VERMONT sont cohérentes avec 21 Ah).
|
||||
|
||||
## Historique
|
||||
|
||||
- **2026-10-09** : conçue en brainstorming, avec une spec et un plan superpowers (`docs/superpowers/`, documents de travail non maintenus). Ensuite, dans la même journée :
|
||||
- durcissement des entrées (`NaN`, CSV illisibles) ;
|
||||
- ligne « sans verdict » dans le résumé ;
|
||||
- graphique réorganisé (D-007), puis remis en graphiques séparés sous l'analyse (D-011), avec une ordonnée recalée à chaque zoom ;
|
||||
- point d'entrée `analyse_01.py` ;
|
||||
- tests supprimés (D-008) ;
|
||||
- jeu réduit à VERMONT (D-009).
|
||||
- **2026-10-12** : panneau d'analyse réduit à 2 courbes sur un seul axe (D-015) ; l'écart et la référence passent au survol. Le calcul passe dans `_ma_drop()`, partagé avec l'analyse 02 (résultats inchangés, vérifié sur VERMONT), et la page reçoit le panneau de l'analyse 02 (D-016). Renommée de `MA7D_DROP` en `MOVING_AVERAGE_7_DAYS_DROP` (D-017). Zones d'état de la batterie ajoutées en fond du graphique `BusVoltage` (affichage seulement, aucun effet sur le calcul).
|
||||
- **2026-10-12** : fiche renommée d'après la règle (ex-`analyse_01.md`) et déplacée dans `docs/energy/analyses/` ; code dans `src/energy/` (D-026). Calcul inchangé.
|
||||
@@ -0,0 +1,81 @@
|
||||
# `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` : tendance de la tension batterie à minuit
|
||||
|
||||
- **Statut** : prototype, en place (2026-10-12).
|
||||
- **Script** : `python3 src/energy/all_analyses.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_energy.html`, où cette analyse est le panneau placé sous `MOVING_AVERAGE_7_DAYS_DROP` (D-016). Elle sert à la comparaison seulement : elle n'est pas livrée (D-020).
|
||||
- **Code** :
|
||||
- `src/energy/moving_average.py` : `run_midnight()` et `RULE_MIDNIGHT`, bibliothèque standard uniquement. Le calcul est celui de `MOVING_AVERAGE_7_DAYS_DROP` (`_ma_drop()`, commun aux deux analyses) ;
|
||||
- `src/energy/all_analyses.py` : graphique plotly.
|
||||
|
||||
## Question posée
|
||||
|
||||
La tension batterie relevée chaque jour à 00:00 UTC décroche-t-elle de son propre passé récent ? C'est la méthode de `MOVING_AVERAGE_7_DAYS_DROP` appliquée à une seule mesure par jour. Suggestion d'un collègue (2026-10-12), pour comparer les deux méthodes. Le lien avec D-004 (régime non soutenable) est le même que pour `MOVING_AVERAGE_7_DAYS_DROP`, avec une réserve (voir « Limites connues », point 1).
|
||||
|
||||
## Principe
|
||||
|
||||
On ne garde que la mesure de 00:00 UTC de chaque jour d, puis on applique le calcul de `MOVING_AVERAGE_7_DAYS_DROP` avec des fenêtres converties en jours. Sur VERMONT, 00:00 UTC tombe la nuit : la batterie n'est pas en charge (voir « Constantes et sources »).
|
||||
|
||||
Calcul exact, pour chaque jour d (un point par jour, horodaté à 00:00 UTC) :
|
||||
1. `x(d)` = `BusVoltage` à d 00:00 UTC. Une valeur vide, `NaN` ou `inf` compte comme « pas de mesure ».
|
||||
2. `ma(d)` = moyenne des `x` non vides sur les 7 jours d−6 … d. Elle n'est définie que si au moins 80 % des jours sont remplis, soit 6 sur 7.
|
||||
3. `ref(d)` = maximum de `ma` sur les 30 jours d−30 … d−1. Elle n'est définie que si au moins 1 de ces `ma` existe.
|
||||
4. `value(d)` = `ma(d)` − `ref(d)`, en V.
|
||||
5. `anomaly(d)` = `value < −0,2` ; vaut `None` (UNKNOWN) si `ma` ou `ref` n'est pas défini.
|
||||
|
||||
Le calcul est **causal** : le point d n'utilise que les mesures de minuit ≤ d. `facts` contient `coverage` (part des 7 jours remplis), `ma_v`, `ref_v` et `ref_t`.
|
||||
|
||||
## Constantes et sources
|
||||
|
||||
| Constante | Valeur | Source |
|
||||
|---|---|---|
|
||||
| Heure d'échantillonnage | 00:00 UTC | Suggestion du collègue. Sur VERMONT, c'est la nuit : profil horaire moyen de `BusVoltage` (avril–octobre 2026) avec un maximum à 13:00 UTC (13,93 V) et un plateau nocturne de 13,11 à 13,13 V de 23:00 à 05:00 UTC. |
|
||||
| `window_d` | 7 | `WINDOW_H` / 24 (`MOVING_AVERAGE_7_DAYS_DROP`). |
|
||||
| `ref_d` | 30 | `REF_H` / 24 (`MOVING_AVERAGE_7_DAYS_DROP`). |
|
||||
| `min_coverage` | 0,8 | Repris de `MOVING_AVERAGE_7_DAYS_DROP` : 6 jours remplis sur 7. |
|
||||
| `min_ref_points` | 1 | `MIN_REF_POINTS` / 24 : au moins un jour de référence, comme dans `MOVING_AVERAGE_7_DAYS_DROP`. |
|
||||
| `threshold_v` | −0,2 | Repris de `MOVING_AVERAGE_7_DAYS_DROP` pour comparer les méthodes à seuil égal. **Non recalibré** : voir « Pistes ». |
|
||||
|
||||
## Graphique
|
||||
|
||||
- **Page commune** (D-016) : le panneau `MOVING_AVERAGE_7_DAYS_DROP` en haut, ce panneau juste dessous, puis les panneaux `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, puis un graphique par série temporelle.
|
||||
- Mêmes conventions que `MOVING_AVERAGE_7_DAYS_DROP` :
|
||||
- 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 ;
|
||||
- survol : écart, verdict et faits du point.
|
||||
- Un point par jour, à 00:00 UTC. Un jour sans verdict coupe la courbe.
|
||||
|
||||
## Résultats sur VERMONT (jeu de travail)
|
||||
|
||||
- Anomalie **à partir du 2026-09-27 00:00**, jusqu'à la fin de l'export. La première coupure nocturne est le 2026-09-27 01:00 : **1 h d'avance seulement**. `MOVING_AVERAGE_7_DAYS_DROP` se déclenche le 2026-09-24 07:00, ~2,7 jours plus tôt.
|
||||
- Pire écart le 2026-10-09 00:00 : moyenne sur 7 jours 12,56 V, soit 0,61 V sous son maximum du 2026-09-15 (13,17 V).
|
||||
- **Bruit bien plus faible** : avant le 20/09 (début du déficit selon l'expert), le pire écart est −0,04 V (2026-05-11). C'est le même épisode nuageux de mai qui donne le pire cas sain de `MOVING_AVERAGE_7_DAYS_DROP`, à −0,16 V.
|
||||
- L'écart reste dans le bruit sain (≥ −0,05 V) jusqu'au 2026-09-23. Il vaut ensuite −0,06 V le 24/09, −0,09 V le 25/09 et −0,13 V le 26/09, sans atteindre le seuil de −0,2 V.
|
||||
- **Pourquoi ~2,7 jours d'écart avec `MOVING_AVERAGE_7_DAYS_DROP`** (valeurs de septembre 2026) :
|
||||
- la journée se dégrade d'abord : après le 08/09, seuls les 11, 18 et 19/09 atteignent 14 V, et la moyenne de 9 à 16 h UTC passe de 13,6–13,9 V à ~13,3 V. La nuit reste sur le plateau, entre 13,05 et 13,18 V, jusqu'au 22/09. `MOVING_AVERAGE_7_DAYS_DROP` voit l'apport baisser, cette analyse ne voit rien ;
|
||||
- la nuit chute ensuite vite : la mesure de minuit est déjà à −0,19 V de la référence le 24/09 et à −0,23 V le 25/09. La moyenne sur 7 jours dilue cette chute, et ne passe le seuil que le 27/09.
|
||||
- 6 jours sans verdict sur 183, tous en début d'historique (montée en charge des fenêtres). 3 minuits sans mesure : 2026-07-23, 2026-10-01 et 2026-10-08 (les deux derniers pendant la période des coupures nocturnes).
|
||||
|
||||
## Options écartées
|
||||
|
||||
| Option | Pourquoi écartée |
|
||||
|---|---|
|
||||
| Moyenne glissante horaire (`MOVING_AVERAGE_7_DAYS_DROP`) évaluée seulement à 00:00 | Autre lecture de la suggestion. Elle donne exactement les valeurs de `MOVING_AVERAGE_7_DAYS_DROP` à minuit : rien de nouveau à comparer. |
|
||||
|
||||
## Limites connues
|
||||
|
||||
1. **Plus tardive** : la tension de nuit reste plate sur le plateau LiFePO4 (30–90 % de charge) et ne chute qu'au coude. La mesure de minuit ne bouge donc que lorsque la batterie est déjà basse. Elle décrit plutôt le niveau de charge que la soutenabilité (D-004), un peu comme le seuil absolu au coude écarté dans `MOVING_AVERAGE_7_DAYS_DROP`. Sur VERMONT : 1 h d'avance sur la première coupure.
|
||||
2. **Une mesure par jour** : un minuit manquant fait perdre un jour entier, et deux minuits manquants sur 7 font passer le point en UNKNOWN. Le risque augmente avec le déficit : si les coupures nocturnes commencent avant minuit, l'analyse devient aveugle au moment où la situation s'aggrave. Sur VERMONT, la couverture est déjà à 6/7 depuis le 2026-10-01.
|
||||
3. **Heure en UTC** : 00:00 UTC n'est la nuit que pour une station dont la longitude s'y prête. Ailleurs, on mesurerait en pleine charge. Ce n'est pas une règle transposable telle quelle.
|
||||
4. **Seuil non recalibré** : −0,2 V vient de `MOVING_AVERAGE_7_DAYS_DROP`, dont le pire écart sain est 4 fois plus grand (−0,16 V contre −0,04 V). Aucune station saine n'est dans le jeu de travail pour recalibrer (D-009).
|
||||
5. **Verdict une fois par jour** : jusqu'à 24 h de latence.
|
||||
6. **Accoutumance** : comme pour `MOVING_AVERAGE_7_DAYS_DROP`, la référence de 30 jours finit par s'aligner sur un déficit qui dure.
|
||||
7. **Pas de résumé texte ni de JSON** : supprimés pour les deux moyennes glissantes (D-026).
|
||||
|
||||
## Pistes
|
||||
|
||||
- **Resserrer le seuil** : avec un pire cas sain à −0,04 V, un seuil à −0,1 V se serait déclenché le 2026-09-26 00:00 (~1 jour avant la coupure), et un seuil à −0,05 V le 2026-09-24 00:00, mais avec une marge de 0,01 V seulement. À vérifier sur des stations saines (`data/archive/` contient `BusVoltage` de FLORIDA et JUNGFRAU, à réintroduire seulement sur demande).
|
||||
- **Minimum nocturne relatif** au lieu de la valeur de minuit : il ne dépend plus de l'heure UTC et un seul trou ne fait plus perdre le jour. À distinguer du seuil absolu sur le minimum nocturne, écarté dans `MOVING_AVERAGE_7_DAYS_DROP`.
|
||||
|
||||
## Historique
|
||||
|
||||
- **2026-10-12** : création, sur la suggestion d'un collègue. Calcul commun avec l'analyse 01 (`_ma_drop()`), panneau placé sous `MOVING_AVERAGE_7_DAYS_DROP` dans la page commune (D-016). Le même jour, renommée de `MA7D_MIDNIGHT_DROP` en `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` (D-017).
|
||||
- **2026-10-12** : fiche renommée d'après la règle (ex-`analyse_02.md`) et déplacée dans `docs/energy/analyses/` ; code dans `src/energy/` (D-026). Calcul inchangé.
|
||||
Reference in new issue
Block a user