Add analysis 04 DAILY_BATTERY_TREND computation

Day-over-day trend from DAILY_BATTERY_STATE: a state change decides
(FULL > PARTIAL > NO_CHARGE > BELOW_PLATEAU), otherwise the night-end
voltage delta with a 0.05 V dead band. No verdict (anomaly = None).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 11:34:00 +02:00
1 parent 722ea0841b
commit 005e006b2f
1 file changed
+49
+49
View File
@@ -0,0 +1,49 @@
"""Analyse 04 DAILY_BATTERY_TREND : tendance de la batterie d'un jour à l'autre (modèle markovien : J face à J−1).
Documentation : docs/analyses/analyse_04.md
Bibliothèque standard uniquement (cible : système embarqué de la station).
"""
from datetime import timedelta
import battery_state as bs
# Constantes (fiche analyse_04, « Constantes et sources »).
NIGHT_END_DEADBAND_V = 0.05 # VERMONT : FULL_CHARGE enchaînés, écart de fin de nuit -0,026 à +0,043 V (5e-95e centiles, 125 paires)
STATE_RANK = {"FULL_CHARGE": 3, "PARTIAL_CHARGE": 2, "NO_CHARGE": 1, "BELOW_PLATEAU": 0} # choix de conception (fiche 04)
RULE = {
"id": "DAILY_BATTERY_TREND",
"verdict": "aucun : anomaly = None ; la tendance est dans facts.trend",
"night_end_deadband_v": NIGHT_END_DEADBAND_V,
"state_rank": STATE_RANK,
"doc": "docs/analyses/analyse_04.md",
}
def delta(prev, cur, key):
"""Écart cur − prev d'un fait de DAILY_BATTERY_STATE, None si l'un des deux manque."""
if prev.get(key) is None or cur.get(key) is None:
return None
return round(cur[key] - prev[key], 3) # arrondi au mV avant la comparaison à la zone morte
def run(series):
"""Analyse DAILY_BATTERY_TREND, causale : le jour J n'utilise que J et J−1. Un point par jour UTC."""
points, prev = [], None
for p in bs.run(series)["points"]:
a = prev["facts"] if prev and p["t"].date() - prev["t"].date() == timedelta(days=1) else {} # J−1, sinon rien
b = p["facts"]
facts = {"trend": None, "decided_by": None, "state_prev": a.get("state"), "state": b["state"],
"delta_night_end_v": delta(a, b, "night_end_v"), "delta_max_v": delta(a, b, "max_v"),
"delta_hours_full": delta(a, b, "hours_full")}
if facts["state_prev"] and facts["state"]:
if facts["state_prev"] != facts["state"]: # l'état a changé : il décide
up = STATE_RANK[facts["state"]] > STATE_RANK[facts["state_prev"]]
facts.update(trend="BETTER" if up else "WORSE", decided_by="state")
else: # même état : la fin de nuit décide, avec une zone morte
d = facts["delta_night_end_v"]
trend = "BETTER" if d > NIGHT_END_DEADBAND_V else "WORSE" if d < -NIGHT_END_DEADBAND_V else "STABLE"
facts.update(trend=trend, decided_by="night_end")
points.append({"t": p["t"], "value": facts["delta_night_end_v"], "anomaly": None, "facts": facts})
prev = p
return {"analysis": RULE["id"], "rule": RULE, "points": points}