Files
Support-Agent/src/energy/battery_state.py
T
maximeandClaude Opus 5.5 8a32f4d418 Organize the project by domain and name analyses by their rule
Energy code moves to src/energy/ and its docs to docs/energy/; shared code
(CSV loading, venv switch, browser, zoom script) goes to src/common/, and the
AIMsight originals to docs/aimsight/. Analyses are no longer numbered: two
Energy scripts remain, daily.py (delivered state and trend) and
all_analyses.py (comparison of the four). Calculations and pages unchanged (D-026).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 17:12:37 +02:00

82 lines
3.6 KiB
Python

"""DAILY_BATTERY_STATE : état de la batterie jour par jour (phase C : état seul, sans verdict).
Documentation : docs/energy/analyses/daily_battery_state.md
Bibliothèque standard uniquement (cible : système embarqué de la station).
"""
import math
from collections import defaultdict
from datetime import timedelta
HOUR = timedelta(hours=1) # grille des CSV : moyennes horaires (aucun import du projet : DAILY_BATTERY_STATE et DAILY_BATTERY_TREND se livrent seules)
# Constantes (fiche daily_battery_state, « Constantes et sources »).
FULL_CHARGE_V = 14.0 # VERMONT : maxima journaliers < 13,55 V (35 j) ou 14,02-14,33 V (135 j) ; absorption ~14,2 V
PLATEAU_FLOOR_V = 12.8 # coude LiFePO4 : table OCV du collecteur (12,8 V = 30 %) ; pente nocturne doublée sous 12,8 V
MIN_RISE_V = 0.05 # > variations horaires sur le plateau (<= 15 mV/h), < plus faible vraie montée (+0,18 V, VERMONT 04-11)
MIN_COVERAGE = 0.8 # repris de MOVING_AVERAGE_7_DAYS_DROP : 20 h mesurées sur 24
RULE = {
"id": "DAILY_BATTERY_STATE",
"phase": "C : état seul, sans verdict (anomaly = None)",
"full_charge_v": FULL_CHARGE_V,
"plateau_floor_v": PLATEAU_FLOOR_V,
"min_rise_v": MIN_RISE_V,
"min_coverage": MIN_COVERAGE,
"doc": "docs/energy/analyses/daily_battery_state.md",
}
def day_facts(day):
"""{heure UTC: tension mesurée} d'un jour -> faits et état (fiche daily_battery_state, « Principe »)."""
if not day:
return {"state": None, "coverage": 0.0}
max_v, min_v = max(day.values()), min(day.values())
# Montée du jour : la plus grande hausse depuis un minimum antérieur ; la fin de nuit est ce minimum.
# (Le maximum du jour peut être la queue de la soirée précédente, à 00:00 : il ne sert pas de repère.)
low = night_end_h = min(day)
rise_v = 0.0
for h in sorted(day):
if day[h] < day[low]:
low = h
if day[h] - day[low] > rise_v:
rise_v, night_end_h = day[h] - day[low], low
if not rise_v:
night_end_h = min(day, key=day.get) # sans montée : le point le plus bas du jour
night_end_v = day[night_end_h]
hours_full = sum(v >= FULL_CHARGE_V for v in day.values())
coverage = len(day) / 24
# Les états 1 et 2 reposent sur une valeur mesurée : ils passent avant la couverture minimale.
if hours_full:
state = "FULL_CHARGE"
elif min_v < PLATEAU_FLOOR_V:
state = "BELOW_PLATEAU"
elif coverage < MIN_COVERAGE:
state = None # UNKNOWN : trop de trous pour conclure à une absence
elif rise_v < MIN_RISE_V:
state = "NO_CHARGE"
else:
state = "PARTIAL_CHARGE"
return {"state": state, "max_v": round(max_v, 3), "min_v": round(min_v, 3), "night_end_v": round(night_end_v, 3),
"night_end_h": night_end_h,
"rise_v": round(rise_v, 3), "hours_full": hours_full, "coverage": round(coverage, 3)}
def run(series):
"""Analyse DAILY_BATTERY_STATE, causale : le jour d n'utilise que les heures de d. Un point par jour UTC."""
v = series["BusVoltage"]
if v:
t0 = min(v)
if any((t - t0) % HOUR for t in v):
raise ValueError("BusVoltage : horodatages hors de la grille horaire")
days, last = defaultdict(dict), {}
for t in sorted(v):
last[t.date()] = t
x = v[t]
if x is not None and math.isfinite(x): # NaN/inf (ex. export pandas) = pas de mesure
days[t.date()][t.hour] = x
points = []
for d in sorted(last):
facts = day_facts(days.get(d, {}))
points.append({"t": last[d], "value": facts.get("max_v"), "anomaly": None, "facts": facts})
return {"analysis": RULE["id"], "rule": RULE, "points": points}