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>
This commit is contained in:
1 parent
77c8f24d2f
commit
8a32f4d418
44 files changed
+1757
-771
No files matched your search
@@ -0,0 +1,81 @@
|
||||
"""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}
|
||||
Reference in new issue
Block a user