Rename DAILY_MAINS_POWER to DAILY_POWER_SOURCE

The user's preferred name. The module becomes src/energy/power_source.py
and the sheet docs/energy/analyses/daily_power_source.md; the
calculation and the results are unchanged (D-043).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 17:23:26 +02:00
1 parent 9177982de1
commit 997e842568
17 files changed
+54 -53

No files matched your search

+5 -5
View File
@@ -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, 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
from energy import battery_state as bs, battery_trend as bt, power_source as ps, moving_average as ma # noqa: E402
from energy.final import daily_state_panel, daily_trend_panel, power_source_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,8 +38,8 @@ 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)
if result["analysis"] == ps.RULE["id"]:
power_source_panel(fig, result, row)
continue
analyse = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}")
thr = result["rule"]["threshold_v"]
@@ -85,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), mp.run(series)]
results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series), ps.run(series)]
figure(station, series, results).write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS,
config={"scrollZoom": True})
print(path)
+6 -6
View File
@@ -1,4 +1,4 @@
"""Couleur du jour : sur secteur (DAILY_MAINS_POWER), la perte du secteur décide (D-043) ; sinon, matrice
"""Couleur du jour : sur secteur (DAILY_POWER_SOURCE), 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)
@@ -6,7 +6,7 @@ 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, mains_power as mp
from energy import battery_state as bs, battery_trend as bt, power_source as ps
# Matrice tenue par l'utilisateur dans docs/energy/matrice-etat-tendance.drawio : MATRIX[état][tendance].
MATRIX = {
@@ -22,14 +22,14 @@ 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.
# Statut d'alimentation (DAILY_POWER_SOURCE), 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,
"mains_lost_v": ps.MAINS_LOST_V,
"matrix": MATRIX,
"doc": "docs/energy/guide/diagnostic-energetique.md",
}
@@ -38,8 +38,8 @@ RULE = {
def run(series):
"""Couleur du jour, causale comme ses trois analyses (J, J−1, et les 3 jours avant J). Un point par jour UTC."""
points = []
# 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"]):
# Mêmes jours, même ordre : bt part de bs, ps parcourt les mêmes horodatages de BusVoltage.
for s, t, m in zip(bs.run(series)["points"], bt.run(series)["points"], ps.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"
+9 -9
View File
@@ -1,8 +1,8 @@
"""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).
"""Analyses livrées (D-020, D-043) : DAILY_BATTERY_STATE, DAILY_BATTERY_TREND et DAILY_POWER_SOURCE, 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, daily_battery_trend.md et daily_mains_power.md
Documentation : docs/energy/analyses/daily_battery_state.md, daily_battery_trend.md et daily_power_source.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, mains_power as mp # noqa: E402
from energy import battery_state as bs, battery_trend as bt, power_source as ps # 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,12 +86,12 @@ 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.
# Statuts de DAILY_POWER_SOURCE : 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)."""
def power_source_panel(fig, result, row):
"""Panneau DAILY_POWER_SOURCE : 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]
@@ -124,12 +124,12 @@ def mains_power_panel(fig, result, row):
def daily_figure(station, series):
"""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."""
puis DAILY_POWER_SOURCE (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)])
subplot_titles=[f"Analysis {r['id']}" for r in (bs.RULE, bt.RULE, ps.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)
power_source_panel(fig, ps.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, mains power", height=1000, barmode="overlay",
+4 -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, mains_power as mp # noqa: E402
from energy import battery_state as bs, battery_trend as bt, day_color as dc, power_source as ps # 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).
@@ -38,9 +38,9 @@ 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]}"]
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'}")
if cur["power"] == "MAINS": # sur secteur, la perte du secteur décide (fiche daily_power_source)
lines.append(f" rule: on mains (3-day mean {cur['mean_3_days_v']} V ≥ {ps.MAINS_MEAN_V} V):"
f" {cur['hours_lost']} h < {ps.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'}")
@@ -1,6 +1,6 @@
"""DAILY_MAINS_POWER : la station est-elle sur secteur ? Sur secteur, a-t-elle perdu le secteur ce jour-là ?
"""DAILY_POWER_SOURCE : 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
Documentation : docs/energy/analyses/daily_power_source.md
Bibliothèque standard uniquement (cible : système embarqué de la station).
"""
import math
@@ -9,25 +9,25 @@ from datetime import timedelta
from energy import battery_state as bs
# Constantes (fiche daily_mains_power, « Constantes et sources »).
# Constantes (fiche daily_power_source, « 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",
"id": "DAILY_POWER_SOURCE",
"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",
"doc": "docs/energy/analyses/daily_power_source.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.
"""Analyse DAILY_POWER_SOURCE, 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), {}