diff --git a/CLAUDE.md b/CLAUDE.md index ce4855b..fe6f3ed 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -69,7 +69,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . ### Lire sans saturer le contexte - Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' `), puis la seule section utile (Read avec `offset` et `limit`). -- `docs/decisions.md` (940 l, D-001 à D-093) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée. +- `docs/decisions.md` (946 l, D-001 à D-094) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée. - `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV. - Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`. @@ -98,7 +98,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, `events-learner`, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069). - `detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées. -- `detectors-view/` : le développement de la page des détecteurs (D-093), `detecteurs.py` : images, courbes, Status, catégories, Error rate ; `run-detectors.sh` : la page sur chaque station de `data/` ; reprise par la page de fin de séance de `/events-learner` (`comparaison.py`) et par `/review-event`. +- `detectors-view/` : le développement de la page des détecteurs (D-093), `detecteurs.py` : images, courbes, Status, catégories, Error rate ; `run-detectors.sh` : la page sur chaque station de `data/` ; `status.py` : la page Status, version pseudo finale de la page Explore du site : corr_x, corr_y, mouvement de la caméra, événements des détecteurs en plages colorées (D-094) ; la page des détecteurs est reprise par la page de fin de séance de `/events-learner` (`comparaison.py`) et par `/review-event`. - `events-learner/`, `aiguiser/` : les séances de `/events-learner` et `/aiguiser` (D-084), une par dossier `_/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande. `aiguiser/voir.py` : ce que rendent les outils de lecture sur un lot. - `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/events-learner` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal, faux amis ; elle apprend de chaque event validé, D-087) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/events-learner`. - `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees`, aiguisé par `/aiguiser`. diff --git a/detectors-view/status.py b/detectors-view/status.py new file mode 100644 index 0000000..d5e65d9 --- /dev/null +++ b/detectors-view/status.py @@ -0,0 +1,95 @@ +"""La page Status d'une station : version pseudo finale de la page de l'onglet Explore du site (en anglais, D-023). +En haut, corr_x et corr_y de chaque capteur (px, une couleur par capteur, les références en pointillé ; la légende cache un +capteur dans les deux), puis le mouvement de la caméra (pan, tilt, rotation [deg], camera/ du pompage, si le dossier en a). +Sur les courbes, au lieu de la ligne Status de detecteurs.py, chaque événement des détecteurs en plage colorée transparente +(la plage classée avec ses 3 jours d'historique ; sans Shift to check ni Slow drift, comme le Status), une couleur par +catégorie, leur légende au-dessus des courbes (un clic cache une catégorie). +Usage : python3 detectors-view/status.py [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] + (--au exclu ; sans dates, toute la période du dossier ; page : out/status___.html, ouverte) +""" +import argparse +import html +import os +import statistics + +import detecteurs # la page des détecteurs : chargement, couleurs, références (bascule seule sur .venv si plotly manque) +from detecteurs import ROOT, donnees, go, make_subplots, open_served + +# Les plages du Status (l'utilisateur, 2026-10-29) : palette catégorielle de référence (skill dataviz), 8 teintes pour +# 10 catégories : les deux phases thermiques partagent l'orange, No data en gris. +TEINTES = {"visibilite_reduite": "#2a78d6", "visibilite_nulle": "#6250d6", "passage": "#1baf7a", "cible_masquee": "#e87ba4", + "cible_degradee": "#e34948", "turbulence": "#eda100", "dilatation_thermique": "#eb6834", + "contraction_thermique": "#eb6834", "saut_bref": "#008300", "trou": detecteurs.GRIS} + + +def page(dossier, du=None, au=None): + mesures = donnees.charger(dossier) + if not mesures: + raise SystemExit(f"Aucun export « advanced » dans {dossier}.") + tous = sorted({m["t"] for ms in mesures.values() for m in ms}) + a = donnees.instant(du) if du else tous[0] + b = donnees.instant(au) if au else tous[-1] + (tous[-1] - tous[-2]) + refs = detecteurs.references(mesures, a, b) + poses = [p for p in donnees.charger_camera(dossier) if a <= p["t"] < b] + + titres = ["corr_x (px)", "corr_y (px)", *["Camera movement: pan, tilt, rotation (deg)"] * bool(poses)] + hauteurs = [260, 260, 200][:len(titres)] # px + fig = make_subplots(rows=len(titres), cols=1, shared_xaxes=True, subplot_titles=titres, vertical_spacing=0.08, + row_heights=hauteurs) + for i, s in enumerate(sorted(mesures)): + ms = [m for m in mesures[s] if a <= m["t"] < b] + ref = s in refs + for row, col in ((1, "corr_x"), (2, "corr_y")): + fig.add_trace(go.Scatter(x=[m["t"] for m in ms], y=[m[col] for m in ms], name=s + " (ref.)" * ref, mode="lines", + legendgroup=s, showlegend=col == "corr_x", + line={"width": 1.2, "color": detecteurs.COULEURS[i % len(detecteurs.COULEURS)], + "dash": "dot" if ref else "solid"}, + hovertemplate=f"{s}: %{{y:.3f}} px"), row=row, col=1) + for col, couleur in detecteurs.POSE if poses else (): + fig.add_trace(go.Scatter(x=[p["t"] for p in poses], y=[p[col] for p in poses], name=col, mode="lines", + line={"width": 1.2, "color": couleur}, hovertemplate=f"{col}: %{{y:.4f}}°"), + row=3, col=1) + + # Un événement par plage, pas les blocs du Status : sur NIEDERHORN, une cible défaillante tout du long en fait un seul bloc. + pas = statistics.median(y - x for x, y in zip(tous, tous[1:])) # une plage finit un pas après sa dernière mesure + rang = {k: i for i, k in enumerate(detecteurs.score.categories.CATEGORIES)} + vus = set() + for v in detecteurs.score.evenements(mesures, donnees.iso(a), donnees.iso(b)): + if v["category"] in detecteurs.STATUT_HORS: + continue + for r in range(1, len(titres) + 1): + fig.add_vrect(x0=donnees.instant(v["start"]), x1=donnees.instant(v["end"]) + pas, row=r, col=1, + fillcolor=TEINTES.get(v["category"], detecteurs.GRIS), opacity=0.2, line_width=0, layer="below", + legend="legend2", legendgroup=v["label"], name=v["label"], legendrank=rang.get(v["category"], 99), + showlegend=v["label"] not in vus) + vus.add(v["label"]) + fig.update_layout(height=sum(hauteurs) + 220, hovermode="closest", plot_bgcolor="white", margin={"l": 60, "r": 20, "t": 100, "b": 40}, + legend={"x": 1.01, "y": 1, "yanchor": "top"}, # à droite des courbes (l'utilisateur, 2026-10-29) + legend2={"orientation": "h", "x": 0, "y": 1.04, "yanchor": "bottom", "title": {"text": "Status"}}) + fig.update_xaxes(type="date", range=[a, b], showgrid=True, gridcolor="#e6e6e2", showticklabels=True) # l'heure sous chaque courbe + fig.update_yaxes(showgrid=True, gridcolor="#eeeeea", zeroline=False) + + station = os.path.basename(os.path.normpath(dossier)) + nom = f"{station}_{donnees.iso(a)[:10]}_{donnees.iso(b)[:10]}" + chemin = os.path.join(ROOT, "out", f"status_{nom}.html") + os.makedirs(os.path.dirname(chemin), exist_ok=True) + with open(chemin, "w", encoding="utf-8") as f: + f.write(f"""Status {html.escape(nom)} + +

Status, {html.escape(station)}

+{fig.to_html(include_plotlyjs="cdn", full_html=False, config={"scrollZoom": False})} +""") + return chemin + + +if __name__ == "__main__": + p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + p.add_argument("dossier") + p.add_argument("--du") + p.add_argument("--au") + p.add_argument("--sans-ouvrir", action="store_true", help="écrit la page sans l'ouvrir") + o = p.parse_args() + chemin = page(o.dossier, o.du, o.au) + print(chemin) + if not o.sans_ouvrir: + open_served(chemin) diff --git a/docs/decisions.md b/docs/decisions.md index cdaf9c1..71623d2 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -938,3 +938,9 @@ Règles du journal : - **Pourquoi** : travailler sur la page sans toucher au skill de la boucle ; l'import circulaire `detecteurs` ↔ `comparaison` disparaît. - **Options écartées** : déplacer aussi `score.py` et `benchmark.py` (outils de la boucle, appelés par ses agents) ; sortir le JavaScript de la page dans des fichiers à part (non demandé). - **Conséquence** : `python3 detectors-view/detecteurs.py data/ [--du D --au F]` ; un lien vers `.claude/skills/events-learner/detecteurs.py` dans l'historique se lit `detectors-view/detecteurs.py`. + +## D-094 — 2026-10-29 — La page Status dans `detectors-view/` +- **Statut** : active. +- **Décision** : `detectors-view/status.py` (l'utilisateur) sera une version pseudo finale de la page de l'onglet Explore du site, à côté de `detecteurs.py`. Elle part d'une page vide (`out/status_[__].html`), même usage que `detecteurs.py` ; son contenu viendra des consignes de l'utilisateur. +- **Pourquoi** : `detecteurs.py` reste l'outil de développement des détecteurs, repris par `comparaison.py` et `/review-event` ; la page Status prépare la page Explore du site sans toucher à ces pages. +- **Conséquence** : `python3 detectors-view/status.py data/ [--du D --au F]`.