"""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}