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>
50 lines
2.5 KiB
Python
50 lines
2.5 KiB
Python
"""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}
|