The user's preferred name. The module becomes src/energy/power_source.py and the sheet docs/energy/analyses/daily_power_source.md; the calculation and the results are unchanged (D-043). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.4 KiB
2.4 KiB
paths
| paths | ||
|---|---|---|
|
Travailler sur une analyse
- Avant de modifier une analyse, lire sa fiche
docs/<domaine>/analyses/<règle>.md(ex.docs/energy/analyses/daily_battery_state.md). En particulier :- le principe ;
- les constantes et leurs sources ;
- les limites connues ;
- les options écartées (ne pas les reproposer sans raison nouvelle).
- Contrat commun :
run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]};- calcul causal : le point t n'utilise que les données ≤ t ;
anomaly = Nonesignifie UNKNOWN (exception :DAILY_BATTERY_STATEen phase C,DAILY_BATTERY_TREND,DAILY_LINK_STATE,DAILY_SIGNAL_STATE,DAILY_STORAGE_STATE,DAYS_UNTIL_STORAGE_FULLetDAILY_POWER_SOURCE, oùNone= pas de verdict ; l'UNKNOWN est dansfacts.state,facts.trend,facts.fillingoufacts.power) ;- une analyse seule conclut au plus
consistent with.
- Code de calcul (
src/<domaine>/) : bibliothèque standard uniquement et aucun import desrc/common/, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (.venv). Le chargement des CSV est danscommon.stations. - Constantes : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source.
- Graphique :
- en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011). Des analyses à comparer partagent une page, un panneau chacune (D-016) : pour Energy,
src/energy/all_analyses.py; - zoom horizontal seulement, avec l'ordonnée recalée sur la plage visible (
post_script=common.page.AUTOSCALE_Y_JS, ordonnées enfixedrange, D-013).
- en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011). Des analyses à comparer partagent une page, un panneau chacune (D-016) : pour Energy,
- Après modification :
- mettre à jour la fiche dans le même changement (résultats, limites, historique) ;
- si c'est une décision projet, ajouter une entrée dans
docs/decisions.md; - si c'est un savoir métier nouveau, l'ajouter dans
docs/domaine/(commun) oudocs/<domaine>/domaine/.
- Vérifier à la main sur le jeu de travail du domaine : VERMONT (
data/VERMONT/) pour Energy, avecpython3 src/energy/all_analyses.py, etpython3 src/energy/final.pysi l'analyse est livrée ; WEISSHORN (data/WEISSHORN/) pour Storage et Cellular (D-030) ; WEISSHORN et NORDEND pour Temperature (D-040). Pas de tests automatisés en phase prototype (D-008). - Nouvelle analyse : utiliser le skill
nouvelle-analyse.