Files
Support-Agent/src/battery_trend.py
T
maximeandClaude Opus 5.5 005e006b2f 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>
2026-10-12 11:34:00 +02:00

50 lines
2.5 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""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}