From 005e006b2f95e2ff65c692ff14257de198ce4994 Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 12 Oct 2026 11:34:00 +0200 Subject: [PATCH] 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 --- src/battery_trend.py | 49 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 src/battery_trend.py diff --git a/src/battery_trend.py b/src/battery_trend.py new file mode 100644 index 0000000..59666a3 --- /dev/null +++ b/src/battery_trend.py @@ -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}