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:
1 parent
722ea0841b
commit
005e006b2f
1 file changed
+49
@@ -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}
|
||||||
Reference in new issue
Block a user