diff --git a/docs/analyses/analyse_03.md b/docs/analyses/analyse_03.md index 9addbe2..de57481 100644 --- a/docs/analyses/analyse_03.md +++ b/docs/analyses/analyse_03.md @@ -60,7 +60,7 @@ Sortie (contrat commun) : un point par jour. ## 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 : +- **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. @@ -88,6 +88,7 @@ Sortie (contrat commun) : un point par jour. | 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 l'analyse 03 comme dans la 04 : l'analyse 03 reste sur les heures du jour lui-même (D-019). | | Nouveau champ du contrat pour « pas de verdict » | Toucherait les analyses 01 et 02 ; `anomaly = None` documenté suffit en phase C. | ## Limites connues @@ -113,3 +114,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`). +- **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. diff --git a/docs/analyses/analyse_04.md b/docs/analyses/analyse_04.md index f5c327d..f247d4f 100644 --- a/docs/analyses/analyse_04.md +++ b/docs/analyses/analyse_04.md @@ -47,7 +47,7 @@ Sortie (contrat commun) : un point par jour. - **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 03, juste au-dessus, sur le même axe du temps. - **Contenu** : - - une barre par jour : `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. ; + - 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. @@ -71,6 +71,7 @@ Sur 184 jours (du 2026-04-09 au 2026-10-09) : | É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 @@ -80,6 +81,7 @@ Sur 184 jours (du 2026-04-09 au 2026-10-09) : 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 l'analyse 03** : 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 @@ -90,3 +92,4 @@ Sur 184 jours (du 2026-04-09 au 2026-10-09) : - **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). diff --git a/docs/decisions.md b/docs/decisions.md index 4ad593b..8730729 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -161,3 +161,14 @@ Règles du journal : - l'hybride (seuils absolus puis passé), trop complexe pour commencer ; - les états du collecteur à 1 Hz, mis de côté : pas de données brutes, et un seuil sur 60 s qui ne voit pas le plateau. - **Conséquence** : le principe « les seuils de tension absolus ne se transposent pas » vise les niveaux propres à une station, comme la position du plateau la nuit. Les seuils du matériel sont admis, à condition de vérifier que le chargeur est le même sur toutes les stations. Première analyse : 03 `DAILY_BATTERY_STATE`. + +## D-019 — 2026-10-12 — Points journaliers à midi ; fin de nuit non décalée +- **Statut** : active. Précise D-011 (graphique) pour les analyses jour par jour (D-018). +- **Décision** : + - sur le graphique, les points journaliers des analyses 03 et 04 sont placés à midi UTC de leur jour, au milieu de la journée, et non à leur `t` (23:00) ; + - le calcul ne change pas : la fin de nuit du jour J reste celle du matin de J, dans l'analyse 03 comme dans la 04. +- **Pourquoi** : choix de l'utilisateur. À 23:00, le point et la barre semblaient appartenir au lendemain : le 12/04 a été lu « 13 avril ». +- **Options écartées** : + - décaler la fin de nuit d'un jour, pour qu'elle porte sur la même journée que l'état (la fin de nuit du matin de J porte le bilan de J−1). Essayé dans la 03, puis dans la 04 seule, et écarté par l'utilisateur les deux fois. Sur VERMONT, il ramenait les barres de la 04 contraires à l'état de 16 à 4 sur 28 changements d'état, au prix d'un jour de retard ; + - garder `t` sur le jour J en prenant la fin de nuit de J+1 : non causal. +- **Conséquence** : l'incohérence entre l'état et la barre reste une limite connue de l'analyse 04 (limite 6 de sa fiche). diff --git a/docs/domaine/pieges-des-donnees.md b/docs/domaine/pieges-des-donnees.md index db0db83..0134d48 100644 --- a/docs/domaine/pieges-des-donnees.md +++ b/docs/domaine/pieges-des-donnees.md @@ -13,5 +13,6 @@ - la température chute pendant le trou, plus qu'aux mêmes heures les nuits sans trou. Sur VERMONT, l'écart va de 2,6 à 15 °C sur 12 trous. - **Les seuils de tension absolus ne se transposent pas d'une station à l'autre.** En bonne santé, les nuits de JUNGFRAU sont à 12,9 V et celles de VERMONT à 13,15 V. Le niveau moyen vaut ~14,25 V sur secteur et ~13,4 V en solaire. Préférer une comparaison de la station à son propre passé. - **Cycle jour/nuit** : une fenêtre glissante doit couvrir un nombre entier de jours. Sur 72 h, la météo domine : 2 jours nuageux font baisser JUNGFRAU (sain) autant qu'un vrai déficit. +- **La fin de nuit porte le bilan de la veille** : le minimum du matin du jour d vient avant la charge de d. Il résulte de la charge de d−1 et de la nuit qui suit. Pour juger la charge d'un jour, il faut lire la fin de nuit du lendemain. Exemple sur VERMONT : le 2026-04-12 est ensoleillé (`FULL_CHARGE`), mais sa fin de nuit du matin, 12,96 V, est en baisse de 0,19 V, car le 11/04 était nuageux. La fin de nuit qui suit le 12/04 remonte à 13,12 V. - **Une valeur `NaN` ou `inf`** dans un export (pandas, par exemple) doit être traitée comme une absence de mesure. - **Pendant une coupure, ce sont justement les valeurs les plus basses qui manquent** : toute moyenne est alors biaisée vers le haut. diff --git a/src/energy_plot.py b/src/energy_plot.py index 268e731..4f9a584 100644 --- a/src/energy_plot.py +++ b/src/energy_plot.py @@ -4,6 +4,7 @@ Documentation : docs/analyses/analyse_01.md à analyse_04.md """ import argparse import os +from datetime import datetime, time, timezone from plotly.subplots import make_subplots @@ -68,11 +69,16 @@ STATE_STYLE = { } +def noon(day): + """Abscisse d'un point journalier (analyses 03 et 04) : midi UTC de son jour, au milieu de la journée.""" + return datetime.combine(day, time(12), timezone.utc) + + def daily_state_panel(fig, result, row): """Panneau DAILY_BATTERY_STATE : maximum et fin de nuit par jour, seuils, état en marqueurs (fiche analyse_03).""" group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") rule, pts = result["rule"], result["points"] - x = [p["t"] for p in pts] + x = [noon(p["t"].date()) for p in pts] fig.add_scatter(x=x, y=[p["facts"].get("max_v") for p in pts], name="maximum du jour", mode="lines", line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group) fig.add_scatter(x=x, y=[p["facts"].get("night_end_v") for p in pts], name="fin de nuit", mode="lines", @@ -89,7 +95,8 @@ def daily_state_panel(fig, result, row): continue hover = [f"{p['t']:%Y-%m-%d} : {label}
" + "
".join(f"{k}={val}" for k, val in p["facts"].items()) for p in sel] - fig.add_scatter(x=[p["t"] for p in sel], y=[p["facts"]["max_v"] for p in sel], name=label, mode="markers", + fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"]["max_v"] for p in sel], name=label, + mode="markers", marker=dict(color=color, symbol=symbol, size=8, line=dict(color="white", width=1)), text=hover, hovertemplate="%{text}", row=row, col=1, **group) fig.update_yaxes(title_text="BusVoltage [V]", row=row, col=1) @@ -104,7 +111,7 @@ def daily_trend_panel(fig, result, row): """Panneau DAILY_BATTERY_TREND : écart de fin de nuit J − J−1 en barres, couleur = tendance (fiche analyse_04).""" group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") pts, db = result["points"], result["rule"]["night_end_deadband_v"] - x = [p["t"] for p in pts] + x = [noon(p["t"].date()) for p in pts] # Zone morte tracée comme une courbe (un point par jour, None entre +db et −db) : visible au zoom (D-013). fig.add_scatter(x=x + [None] + x, y=[db] * len(x) + [None] + [-db] * len(x), name=f"zone morte ±{db} V", mode="lines", hoverinfo="skip", line=dict(color="#52514e", dash="dash", width=1), @@ -116,8 +123,8 @@ def daily_trend_panel(fig, result, row): hover = [f"{p['t']:%Y-%m-%d} : {label} (décidé par {p['facts']['decided_by']})
" f"{p['facts']['state_prev']} → {p['facts']['state']}
" + "
".join(f"{k}={v}" for k, v in p["facts"].items() if k.startswith("delta")) for p in sel] - fig.add_bar(x=[p["t"] for p in sel], y=[p["value"] for p in sel], name=label, marker_color=color, - width=0.8 * 86_400_000, hovertext=hover, hovertemplate="%{hovertext}", + fig.add_bar(x=[noon(p["t"].date()) for p in sel], y=[p["value"] for p in sel], name=label, + marker_color=color, width=0.8 * 86_400_000, hovertext=hover, hovertemplate="%{hovertext}", row=row, col=1, **group) fig.update_yaxes(title_text="Δ fin de nuit [V]", row=row, col=1)