Add DAILY_MAINS_POWER: on mains, a mains loss turns the day red at once

A station is on mains when its BusVoltage mean over the 3 days before
the day is >= 14.0 V (solar never exceeds 13.50 V on VERMONT; mains
stays >= 14.08 V). On mains, the mains loss decides the day color
instead of the state x trend matrix: red as soon as an hour falls under
13.4 V (top of the OCV plateau; mains-on hours stay >= 13.65 V, mains-off
hours are 13.1-13.3 V). On MISSISSIPPI the day turns red 1-2 h after the
loss instead of 29-40 h with the matrix; WEISSHORN and NORDEND (mains)
raise no false alert, VERMONT (solar) is unchanged (D-043).

The matrix drawio gets the mains case, the site figure a third panel,
and the support notification and the client Energy block header show
"On mains" / "Not on mains" / "Mains unknown".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 17:22:16 +02:00
1 parent 28ed86baba
commit 9177982de1
18 files changed
+359 -43

No files matched your search

+7 -4
View File
@@ -1,4 +1,4 @@
"""Les quatre analyses Energy ensemble, pour les comparer (D-016) : un panneau chacune, puis un graphique par série.
"""Les cinq analyses Energy ensemble, pour les comparer (D-016) : un panneau chacune, puis un graphique par série.
Usage : python3 src/energy/all_analyses.py [CSV ou dossiers...] (défaut : data/VERMONT/)
Écrit out/<STATION>_energy.html et l'ouvre. Documentation : docs/energy/analyses/ (une fiche par analyse)
@@ -10,8 +10,8 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
from common.stations import gaps, load_stations # noqa: E402
from plotly.subplots import make_subplots # noqa: E402
from energy import battery_state as bs, battery_trend as bt, moving_average as ma # noqa: E402
from energy.final import daily_state_panel, daily_trend_panel # noqa: E402
from energy import battery_state as bs, battery_trend as bt, mains_power as mp, moving_average as ma # noqa: E402
from energy.final import daily_state_panel, daily_trend_panel, mains_power_panel # noqa: E402
# Zones de BusVoltage selon l'état de la batterie (bandes de fond) : docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md.
# [V] = VERMONT, 5e-95e centiles horaires ; [M] = manuel ; [E] = experts. Les zones « en charge » et « décharge »
@@ -38,6 +38,9 @@ def figure(station, series, results):
if result["analysis"] == bt.RULE["id"]:
daily_trend_panel(fig, result, row)
continue
if result["analysis"] == mp.RULE["id"]:
mains_power_panel(fig, result, row)
continue
analyse = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}")
thr = result["rule"]["threshold_v"]
pts = result["points"]
@@ -82,7 +85,7 @@ def main(paths):
print(f"{station} : ignorée, pas de BusVoltage")
continue
path = ROOT / "out" / f"{station}_energy.html"
results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series)]
results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series), mp.run(series)]
figure(station, series, results).write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS,
config={"scrollZoom": True})
print(path)
+16 -6
View File
@@ -1,11 +1,12 @@
"""Couleur du jour : matrice état (DAILY_BATTERY_STATE) × tendance (DAILY_BATTERY_TREND) -> vert / orange / rouge (D-020).
"""Couleur du jour : sur secteur (DAILY_MAINS_POWER), la perte du secteur décide (D-043) ; sinon, matrice
état (DAILY_BATTERY_STATE) × tendance (DAILY_BATTERY_TREND) -> vert / orange / rouge (D-020).
Documentation : docs/energy/guide/diagnostic-energetique.md (§ 7, la matrice)
Bibliothèque standard uniquement (cible : système embarqué de la station).
"""
from datetime import timedelta
from energy import battery_state as bs, battery_trend as bt
from energy import battery_state as bs, battery_trend as bt, mains_power as mp
# Matrice tenue par l'utilisateur dans docs/energy/matrice-etat-tendance.drawio : MATRIX[état][tendance].
MATRIX = {
@@ -21,20 +22,29 @@ HEADLINE = {"GREEN": "The station is receiving enough energy.",
"ORANGE": "The station's energy supply is uncertain.",
"RED": "The station is not receiving enough energy."}
# Statut d'alimentation (DAILY_MAINS_POWER), en anglais (D-023), repris par les notifications du support.
POWER_LABEL = {"MAINS": "On mains", "NOT_MAINS": "Not on mains", None: "Mains unknown"}
RULE = {
"id": "DAY_COLOR",
"verdict": "aucun : anomaly = None ; la couleur est dans facts.color (None = inconnu, état ou tendance absent)",
"mains": "power = MAINS : RED si une heure de J < mains_lost_v (hours_lost > 0), sinon GREEN ; la matrice sinon",
"mains_lost_v": mp.MAINS_LOST_V,
"matrix": MATRIX,
"doc": "docs/energy/guide/diagnostic-energetique.md",
}
def run(series):
"""Couleur du jour, causale comme DAILY_BATTERY_STATE et DAILY_BATTERY_TREND (J et J−1). Un point par jour UTC."""
"""Couleur du jour, causale comme ses trois analyses (J, J−1, et les 3 jours avant J). Un point par jour UTC."""
points = []
for s, t in zip(bs.run(series)["points"], bt.run(series)["points"]): # mêmes jours, même ordre (bt part de bs)
facts = {**s["facts"], **t["facts"]}
facts["color"] = MATRIX.get(facts["state"], {}).get(facts["trend"])
# Mêmes jours, même ordre : bt part de bs, mp parcourt les mêmes horodatages de BusVoltage.
for s, t, m in zip(bs.run(series)["points"], bt.run(series)["points"], mp.run(series)["points"]):
facts = {**s["facts"], **t["facts"], **m["facts"]}
if facts["power"] == "MAINS": # batterie toujours pleine : une heure sans chargeur suffit, sans attendre J+1
facts["color"] = None if facts["hours_lost"] is None else "RED" if facts["hours_lost"] else "GREEN"
else: # sur batterie (solaire), ou statut inconnu
facts["color"] = MATRIX.get(facts["state"], {}).get(facts["trend"])
points.append({"t": s["t"], "value": facts["color"], "anomaly": None, "facts": facts})
return {"analysis": RULE["id"], "rule": RULE, "points": points}
+45 -7
View File
@@ -1,8 +1,8 @@
"""Analyses livrées (D-020) : DAILY_BATTERY_STATE et DAILY_BATTERY_TREND, en une figure pour le site (D-021).
"""Analyses livrées (D-020, D-043) : DAILY_BATTERY_STATE, DAILY_BATTERY_TREND et DAILY_MAINS_POWER, en une figure pour le site (D-021).
Usage : python3 src/energy/final.py [CSV ou dossiers...] (défaut : data/VERMONT/)
Écrit out/<STATION>_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
Documentation : docs/energy/analyses/daily_battery_state.md et daily_battery_trend.md
Documentation : docs/energy/analyses/daily_battery_state.md, daily_battery_trend.md et daily_mains_power.md
"""
import sys
from pathlib import Path
@@ -13,7 +13,7 @@ from datetime import datetime, time, timezone # noqa: E402
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
from common.stations import load_stations # noqa: E402
from plotly.subplots import make_subplots # noqa: E402
from energy import battery_state as bs, battery_trend as bt # noqa: E402
from energy import battery_state as bs, battery_trend as bt, mains_power as mp # noqa: E402
# États de DAILY_BATTERY_STATE : couleurs validées par le skill dataviz (toutes paires, fond blanc).
# Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol.
@@ -86,15 +86,53 @@ def daily_trend_panel(fig, result, row):
fig.update_yaxes(title_text="Δ night end [V]", row=row, col=1)
# Statuts de DAILY_MAINS_POWER : paire bleu/rouge et gris neutre déjà validés (TREND_STYLE), chacun avec son symbole.
POWER_STYLE = {"MAINS": ("on mains", "#2a78d6", "circle"), "NOT_MAINS": ("not on mains", "#8c8c8c", "circle-open")}
def mains_power_panel(fig, result, row):
"""Panneau DAILY_MAINS_POWER : moyenne des 3 jours avant J (statut en marqueurs), minimum de J (perte en croix)."""
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}")
rule, pts = result["rule"], result["points"]
x = [noon(p["t"].date()) for p in pts]
fig.add_scatter(x=x, y=[p["facts"]["mean_3_days_v"] for p in pts], name="3-day mean (days before)", mode="lines",
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
fig.add_scatter(x=x, y=[p["facts"]["min_v"] for p in pts], name="daily minimum", mode="lines",
line=dict(color="#9a9893", width=1.5), hovertemplate="daily minimum %{y:.2f} V<extra></extra>",
row=row, col=1, **group)
# Seuils tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
for v, name, color in ((rule["mains_mean_v"], "mains", "#2a78d6"), (rule["mains_lost_v"], "mains lost", "#d03b3b")):
fig.add_scatter(x=x, y=[v] * len(x), name=f"{name} {v} V", mode="lines", hoverinfo="skip",
line=dict(color=color, dash="dash", width=1), row=row, col=1, **group)
hover = lambda p, label: (f"{p['t']:%Y-%m-%d}: {label}<br>" # noqa: E731
+ "<br>".join(f"{k}={val}" for k, val in p["facts"].items()))
for power, (label, color, symbol) in POWER_STYLE.items():
sel = [p for p in pts if p["facts"]["power"] == power]
if sel:
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"]["mean_3_days_v"] for p in sel],
name=label, mode="markers", marker=dict(color=color, symbol=symbol, size=8),
text=[hover(p, label) for p in sel], hovertemplate="%{text}<extra></extra>",
row=row, col=1, **group)
sel = [p for p in pts if p["facts"]["hours_lost"]]
if sel:
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"]["min_v"] for p in sel],
name="mains lost", mode="markers", marker=dict(color="#d03b3b", symbol="x", size=9),
text=[hover(p, f"mains lost, {p['facts']['hours_lost']} h") for p in sel],
hovertemplate="%{text}<extra></extra>", row=row, col=1, **group)
fig.update_yaxes(title_text="BusVoltage [V]", row=row, col=1)
def daily_figure(station, series):
"""Graphique pour le site de monitoring (D-021) : DAILY_BATTERY_STATE en haut, DAILY_BATTERY_TREND dessous, même axe du temps."""
fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08,
subplot_titles=[f"Analysis {bs.RULE['id']}", f"Analysis {bt.RULE['id']}"])
"""Graphique pour le site de monitoring (D-021) : DAILY_BATTERY_STATE en haut, DAILY_BATTERY_TREND dessous,
puis DAILY_MAINS_POWER (D-043), même axe du temps."""
fig = make_subplots(rows=3, cols=1, shared_xaxes=True, vertical_spacing=0.06,
subplot_titles=[f"Analysis {r['id']}" for r in (bs.RULE, bt.RULE, mp.RULE)])
daily_state_panel(fig, bs.run(series), 1)
daily_trend_panel(fig, bt.run(series), 2)
mains_power_panel(fig, mp.run(series), 3)
fig.update_xaxes(showticklabels=True)
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
fig.update_layout(title=f"{station}: battery state and trend", height=700, barmode="overlay",
fig.update_layout(title=f"{station}: battery state and trend, mains power", height=1000, barmode="overlay",
legend=dict(groupclick="toggleitem"))
return fig
+10 -4
View File
@@ -12,7 +12,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c
from common.page import ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
from common.stations import gaps, load_stations # noqa: E402
import plotly.graph_objects as go # noqa: E402
from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402
from energy import battery_state as bs, battery_trend as bt, day_color as dc, mains_power as mp # noqa: E402
from energy.final import STATE_STYLE, TREND_STYLE, noon # noqa: E402
# Statuts : noms et couleurs de la maquette System Summary (maquettes/user/summary_template.html).
@@ -37,8 +37,13 @@ def parse_day(arg, series):
def summary(station, f):
"""Résumé texte traçable : couleur, règle, faits de J−1 et de J, tendance et ce qui l'a décidée."""
d, prev, cur = f["day"], f["prev"], f["cur"]
lines = [f"{station}, {d:%d/%m/%Y}: {COLOR[f['color']][0]}",
f" rule: matrix state × trend (user manual § 7): {cur['state']} × {cur['trend']} → {f['color'] or 'unknown'}"]
lines = [f"{station}, {d:%d/%m/%Y}: {COLOR[f['color']][0]}"]
if cur["power"] == "MAINS": # sur secteur, la perte du secteur décide (fiche daily_mains_power)
lines.append(f" rule: on mains (3-day mean {cur['mean_3_days_v']} V ≥ {mp.MAINS_MEAN_V} V):"
f" {cur['hours_lost']} h < {mp.MAINS_LOST_V} V → {f['color'] or 'unknown'}")
else:
lines.append(f" rule: {dc.POWER_LABEL[cur['power']].lower()}, matrix state × trend (user manual § 7):"
f" {cur['state']} × {cur['trend']} → {f['color'] or 'unknown'}")
for tag, x, facts in (("D-1", d - timedelta(days=1), prev), ("D ", d, cur)):
if not facts or facts.get("max_v") is None:
lines.append(f" {tag} {x:%d/%m}: no measurement")
@@ -113,7 +118,8 @@ def figure(station, f):
ys = [v for v in h.values() if v is not None] + [bs.FULL_CHARGE_V, bs.PLATEAU_FLOOR_V] # seuils toujours visibles
fig.update_yaxes(title_text="BusVoltage [V]", range=[min(ys) - 0.15, max(ys) + 0.15])
fig.update_layout(title=f"{station}, {d:%d %b %Y}: <span style='color:{color}'>■ {name}</span>"
f" · {f['cur']['state']} × {trend or 'unknown trend'}"
+ (" · on mains, lost" if f["cur"]["hours_lost"] else " · on mains" if f["cur"]["power"] == "MAINS"
else f" · {f['cur']['state']} × {trend or 'unknown trend'}")
+ (" · provisional (day not over)" if provisional(f) else "")
+ "<br><sup>gray band: no measurement · dashed: thresholds of the daily state"
" · arrow: night end D-1 → D (trend)</sup>",
+53
View File
@@ -0,0 +1,53 @@
"""DAILY_MAINS_POWER : la station est-elle sur secteur ? Sur secteur, a-t-elle perdu le secteur ce jour-là ?
Documentation : docs/energy/analyses/daily_mains_power.md
Bibliothèque standard uniquement (cible : système embarqué de la station).
"""
import math
from collections import defaultdict
from datetime import timedelta
from energy import battery_state as bs
# Constantes (fiche daily_mains_power, « Constantes et sources »).
WINDOW_DAYS = 3 # demande de l'utilisateur : moyenne glissante sur les 3 jours qui précèdent J
MAINS_MEAN_V = bs.FULL_CHARGE_V # 14,0 V : moyenne sur 3 jours, solaire <= 13,50 V (VERMONT), secteur >= 14,08 V (4 stations)
MAINS_LOST_V = 13.4 # haut du plateau (table OCV) : secteur présent >= 13,65 V à l'heure, heure pleine sans secteur 13,11-13,30 V (MISSISSIPPI)
MIN_COVERAGE = bs.MIN_COVERAGE # 0,8 : 58 h mesurées sur 72
RULE = {
"id": "DAILY_MAINS_POWER",
"verdict": "aucun : anomaly = None ; le statut est dans facts.power, la perte du secteur dans facts.hours_lost",
"window_days": WINDOW_DAYS,
"mains_mean_v": MAINS_MEAN_V,
"mains_lost_v": MAINS_LOST_V,
"min_coverage": MIN_COVERAGE,
"doc": "docs/energy/analyses/daily_mains_power.md",
}
def run(series):
"""Analyse DAILY_MAINS_POWER, causale : le statut de J vient des 3 jours avant J, la perte des heures de J.
Un point par jour UTC, les mêmes jours que DAILY_BATTERY_STATE."""
v = series["BusVoltage"]
days, last = defaultdict(list), {}
for t in sorted(v):
last[t.date()] = t
if v[t] is not None and math.isfinite(v[t]): # NaN/inf = pas de mesure, comme DAILY_BATTERY_STATE
days[t.date()].append(v[t])
points = []
for d in sorted(last):
window = [x for k in range(1, WINDOW_DAYS + 1) for x in days.get(d - timedelta(days=k), [])]
coverage = len(window) / (24 * WINDOW_DAYS)
mean_v = round(sum(window) / len(window), 3) if window else None
if coverage < MIN_COVERAGE:
power = None # UNKNOWN : trop de trous pour conclure
else:
power = "MAINS" if mean_v >= MAINS_MEAN_V else "NOT_MAINS"
today = days.get(d, [])
# Sur secteur seulement : heures de J sous le plateau haut, donc sans chargeur (None : pas sur secteur, ou J sans mesure).
hours_lost = sum(x < MAINS_LOST_V for x in today) if power == "MAINS" and today else None
facts = {"power": power, "mean_3_days_v": mean_v, "coverage_3_days": round(coverage, 3),
"min_v": round(min(today), 3) if today else None, "hours_lost": hours_lost}
points.append({"t": last[d], "value": mean_v, "anomaly": None, "facts": facts})
return {"analysis": RULE["id"], "rule": RULE, "points": points}