--- paths: - "src/**" - "docs/analyses/**" --- # Travailler sur une analyse - **Avant de modifier** une analyse, lire sa fiche `docs/analyses/analyse_NN.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 = None` signifie UNKNOWN (exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`) ; - une analyse seule conclut au plus `consistent with`. - **Code de calcul** : bibliothèque standard uniquement, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`). - **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) ; - zoom horizontal seulement, avec l'ordonnée recalée sur la plage visible (`post_script=energy_plot.AUTOSCALE_Y_JS`, ordonnées en `fixedrange`, D-013). - **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/`. - **Vérifier à la main** avec `python3 src/analyse_NN.py` sur VERMONT (`data/`). Pas de tests automatisés en phase prototype (D-008). - **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.