- Analysis 02 MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP: same rule as analysis 01 on the 00:00 UTC BusVoltage sample only, one point per day. Shared computation in energy_check._ma_drop(); analysis 01 results unchanged on VERMONT. - Common page: one panel per analysis (02 under 01), then the time series (D-016); src/analyse_02.py launches that page. - Analysis panel reduced to two curves on one volt axis: 7-day mean and threshold; gap and reference moved to hover (D-015). - Date tick labels under every subplot. - Rule IDs spelled out: MA7D_DROP -> MOVING_AVERAGE_7_DAYS_DROP, MA7D_MIDNIGHT_DROP -> MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP (D-017). - Docs: analysis sheet 02, sheet 01, CLAUDE.md, README, decisions D-015..D-017, analysis rule and nouvelle-analyse skill. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
56 lines
3.1 KiB
Markdown
56 lines
3.1 KiB
Markdown
---
|
|
name: nouvelle-analyse
|
|
description: Créer une nouvelle analyse numérotée (analyse_NN) dans le projet de diagnostic AIMsight — script, fiche, index, journal. À utiliser dès que l'utilisateur veut ajouter, concevoir ou prototyper une nouvelle analyse des séries temporelles d'une station.
|
|
---
|
|
|
|
# Créer une nouvelle analyse
|
|
|
|
## 1. Situer l'analyse
|
|
|
|
- Prendre le numéro suivant `NN` : voir le tableau « Analyses » de `CLAUDE.md` et `docs/analyses/`.
|
|
- Lire, sans tout charger :
|
|
- les « Pistes » et les « Limites connues » des fiches existantes. La nouvelle analyse en couvre souvent une ;
|
|
- `docs/decisions.md`, en particulier les options écartées ;
|
|
- la note de `docs/domaine/` qui concerne la question posée.
|
|
- Si la conception demande des choix, en discuter avec l'utilisateur. Avec superpowers (brainstorming), **la spec s'écrit directement dans la fiche** `docs/analyses/analyse_NN.md`, pas dans `docs/superpowers/specs/` (D-010).
|
|
|
|
## 2. Écrire la fiche
|
|
|
|
- Copier `docs/analyses/_modele.md` vers `docs/analyses/analyse_NN.md` et remplir :
|
|
- la question posée ;
|
|
- le principe et le calcul exact ;
|
|
- les constantes **avec leur source** ;
|
|
- les options écartées.
|
|
- Statut : « en conception ».
|
|
- Nom de la règle : en anglais, majuscules, **mots complets sans abréviation** (ex. `MOVING_AVERAGE_7_DAYS_DROP`, D-017).
|
|
|
|
## 3. Écrire le code
|
|
|
|
- Le calcul respecte le contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`.
|
|
- Il est causal.
|
|
- Il utilise uniquement la bibliothèque standard.
|
|
- `value` est exprimé dans une unité physique, sans pseudo-probabilité.
|
|
- Une analyse seule conclut au plus `consistent with`.
|
|
- Réutiliser `src/energy_check.py` (`load_stations`, grille horaire, traitement des `NaN`) plutôt que de le recopier. Extraire du code partagé seulement quand une deuxième analyse en a vraiment besoin.
|
|
- Point d'entrée `src/analyse_NN.py`, sur le modèle de `src/analyse_01.py` :
|
|
- il s'exécute sur `data/` par défaut ;
|
|
- il bascule sur `.venv` si plotly manque ;
|
|
- il écrit le graphique dans `out/` et l'ouvre dans le navigateur.
|
|
- Graphique (D-011) : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle. Écrire le HTML avec `post_script=energy_plot.AUTOSCALE_Y_JS` et des ordonnées en `fixedrange`, pour que l'ordonnée se recale à chaque zoom.
|
|
- Pas de tests automatisés en phase prototype (D-008).
|
|
|
|
## 4. Vérifier
|
|
|
|
- Lancer `python3 src/analyse_NN.py` sur VERMONT.
|
|
- Comparer les résultats au diagnostic expert (`docs/domaine/cas-annotes-par-l-expert.md`).
|
|
- Reporter les dates et valeurs observées dans la section « Résultats » de la fiche.
|
|
|
|
## 5. Documenter
|
|
|
|
- Fiche : statut « prototype en place », résultats, limites, historique.
|
|
- `CLAUDE.md` :
|
|
- ajouter une ligne au tableau « Analyses » et la commande dans « Commandes » ;
|
|
- mettre à jour « État et prochaine étape ».
|
|
- `docs/decisions.md` : une entrée **seulement** si une décision de niveau projet a été prise (nouveau principe, changement de cap). Les choix propres à l'analyse restent dans sa fiche.
|
|
- Un savoir métier découvert en chemin va dans `docs/domaine/`.
|