Status page: status hierarchy and filter by visible targets (D-095)

detectors-view/hierarchie-des-status.md, validated by the user: No visibility hides Reduced
visibility, Faulty target hides Target hidden, No data hides everything, No visibility hides Target
hidden; the two thermal phases form one status, Thermal movements. A hidden status is cut, not
removed, and only when the stronger one covers all its sensors. status.py transcribes it.

Hiding or isolating targets in the sensor legend keeps only the statuses that touch a visible
target, or all sensors. Discarded labels become transparent, without text, hover or click:
restyling x or base of the label row made Plotly retype its axis as linear.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 11:42:18 +01:00
1 parent 71111b9f29
commit dcbffeaa71
4 files changed
+176 -46

No files matched your search

+56
View File
@@ -0,0 +1,56 @@
# Hiérarchie des status (page Status)
Ce que la page Status (`status.py`) affiche quand deux événements des détecteurs se superposent dans le temps : l'un occulte l'autre, ou les deux restent visibles. Le code transcrit ce document, comme `day_color.py` transcrit une matrice ; il ne change que l'affichage, pas les détecteurs.
**Statut : validé par l'utilisateur le 2026-10-29 (D-095).** Les règles marquées (proposé) venaient de Claude ; l'utilisateur les a validées avec le reste.
## Les règles
1. **Deux événements se superposent** quand leurs plages se chevauchent dans le temps.
2. **Un status supérieur occulte un status inférieur** : le second n'est affiché, en plage comme en étiquette, qu'en dehors de la plage du premier. Il est coupé, pas supprimé : une Reduced visibility de 10:00 à 14:00 qui contient une No visibility de 11:00 à 12:00 s'affiche de 10:00 à 11:00, puis de 12:00 à 14:00.
3. **Deux status superposables** restent affichés tous les deux, l'un sous l'autre dans la rangée des étiquettes (comme aujourd'hui).
4. (proposé) **Les capteurs comptent** : un status n'en occulte un autre que si les capteurs de l'inférieur sont tous parmi ceux du supérieur, ou si le supérieur concerne tous les capteurs. Sinon, les deux restent affichés. Sans cette règle, sur NIEDERHORN (2026-09-25 → 2026-10-08), la Faulty target qui couvre toute la plage occulterait les 8 Target hidden qu'elle chevauche, dont 7 sur d'autres capteurs.
## Les familles
À l'intérieur d'une famille, le premier occulte le suivant (Thermique : un seul status). Deux familles différentes sont superposables, sauf exception de la section suivante.
| Famille | Status, du plus fort au plus faible | Source |
|---|---|---|
| Visibilité | No visibility (`visibilite_nulle`) > Reduced visibility (`visibilite_reduite`) | l'utilisateur |
| Cible | Faulty target (`cible_degradee`) > Target hidden (`cible_masquee`) | l'utilisateur |
| Thermique | Thermal movements : Thermal expansion (`dilatation_thermique`) et Thermal contraction (`contraction_thermique`) regroupées en un seul status ; deux phases qui se touchent forment un seul Thermal movements | l'utilisateur |
| Seuls | Passing obstacle (`passage`), Heat haze (`turbulence`), Brief jump (`saut_bref`), No data (`trou`) | (proposé) |
## Entre familles (proposé)
- **No data occulte tout** : sans mesure, aucun autre status ne se lit sur les courbes.
- **No visibility occulte Target hidden** : quand on ne voit rien, toutes les cibles sont masquées ; Target hidden n'apprend rien de plus.
- Tout le reste est superposable, en particulier les effets thermiques, qui forment le fond de la journée et se lisent avec le reste.
## Hors de la page
Shift to check (`a_verifier`) et Slow drift (`derive_lente`) n'ont pas de status, comme dans la ligne Status de `detecteurs.py` : un mouvement possible ne se range pas avec les moments où il ne faut pas se fier aux données.
## Réponses aux questions (2026-10-29)
1. Cible : Faulty target gagne sur Target hidden.
2. Thermique : les deux phases forment un seul status, Thermal movements.
3. Passing obstacle reste seul.
4. Règle 4 (capteurs) : validée.
## Superpositions observées
Paires de status qui se chevauchent, avec entre parenthèses le nombre de paires qui partagent un capteur ou dont l'un concerne tous les capteurs. Les deux plages de `run-detectors.sh`.
| Paire | NORDEND, 2026-10-11 → 2026-10-25 | NIEDERHORN, 2026-09-25 → 2026-10-08 |
|---|---|---|
| Thermal contraction × Thermal expansion | 12 (12) | 11 (11) |
| Faulty target × Reduced visibility | 10 (0) | 2 (2) |
| Faulty target × No visibility | 5 (0) | – |
| Faulty target × Target hidden | – | 8 (1) |
| Faulty target × Passing obstacle | 1 (0) | 7 (5) |
| Target hidden × thermique | 9 (9) | 12 (12) |
| No visibility × Reduced visibility | 3 (3) | – |
| No visibility × Target hidden | 1 (1) | – |
| Reduced visibility × thermique | 7 (7) | – |
+111 -44
View File
@@ -1,12 +1,13 @@
"""La page Status d'une station : version pseudo finale de la page de l'onglet Explore du site (en anglais, D-023).
En haut, la rangée des événements des détecteurs (la plage classée avec ses 3 jours d'historique ; sans Shift to check ni Slow
drift, comme le Status de detecteurs.py) : une étiquette par événement, à son heure, de la couleur de sa catégorie, les
événements qui se chevauchent l'un sous l'autre. Dessous, corr_x et corr_y de chaque capteur (px, une couleur par capteur,
les références en pointillé ; la légende, à droite, 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, chaque événement en plage colorée
transparente, la légende des catégories au-dessus (un clic cache une catégorie). Un clic sur une étiquette sélectionne
l'événement : zoom sur lui (marge avant et après), ses seuls capteurs sur les courbes, sa plage soulignée ; un second clic
rend tout.
En haut, la rangée des status : les événements des détecteurs (la plage classée avec ses 3 jours d'historique ; sans Shift to
check ni Slow drift, comme le Status de detecteurs.py), regroupés et occultés selon hierarchie-des-status.md (D-095) ; une
étiquette par status, à son heure, de la couleur de sa catégorie, les status qui se chevauchent l'un sous l'autre. Dessous,
corr_x et corr_y de chaque capteur (px, une couleur par capteur, les références en pointillé ; la légende, à droite, 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, chaque status en plage colorée transparente, la légende des catégories au-dessus (un clic cache une
catégorie). Un clic sur une étiquette sélectionne le status : zoom sur lui (marge avant et après), ses seuls capteurs sur les
courbes, ses plages soulignées ; un second clic rend tout. Des cibles cachées dans la légende (clic, ou double clic pour
n'en garder qu'une) : seuls restent les status qui touchent une cible visible, ou tous les capteurs.
Usage : python3 detectors-view/status.py <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ]
(--au exclu ; sans dates, toute la période du dossier ; page : out/status_<STATION>_<du>_<au>.html, ouverte)
"""
@@ -21,34 +22,97 @@ import detecteurs # la page des détecteurs : chargement, couleurs, référence
from detecteurs import ROOT, donnees, go, make_subplots, open_served, plotly_t
# 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.
# 9 status, 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}
"cible_degradee": "#e34948", "turbulence": "#eda100", "thermique": "#eb6834", "saut_bref": "#008300",
"trou": detecteurs.GRIS}
# La hiérarchie des status (hierarchie-des-status.md, validée par l'utilisateur le 2026-10-29) : les deux phases thermiques
# en un status ; un status occulte les plus faibles qu'il chevauche ; tout le reste se superpose.
FUSION = {"dilatation_thermique": "thermique", "contraction_thermique": "thermique"}
NOMS = {"thermique": "Thermal movements"}
OCCULTE = {"visibilite_nulle": {"visibilite_reduite", "cible_masquee"}, "cible_degradee": {"cible_masquee"},
"trou": set(TEINTES) - {"trou"}}
VOIE = 24 # px par rangée d'étiquettes
# Un clic sur l'étiquette d'un événement (customdata : début, fin, capteurs, rang) le sélectionne ; un second clic rend
# tout. Marge du zoom : la moitié de la durée, de 1 h à 6 h (comme le timelapse de detecteurs.py). Ses plages : les R
# shapes de rang k.
# Un clic sur l'étiquette d'un status (customdata : début, fin, capteurs, rang) le sélectionne ; un second clic rend tout.
# Marge du zoom : la moitié de la durée, de 1 h à 6 h (comme le timelapse de detecteurs.py). EV : le rang du status de
# chaque shape. Des cibles cachées dans la légende (l'utilisateur, 2026-10-29) : seuls restent, en étiquette et en plage,
# les status qui touchent une cible visible, ou tous les capteurs.
SELECTION_JS = """
const R = __R__, PLAGE = __PLAGE__, ms = s => Date.parse(s.replace(' ', 'T') + 'Z');
const EV = __EV__, PLAGE = __PLAGE__, ms = s => Date.parse(s.replace(' ', 'T') + 'Z');
const iso = t => new Date(t).toISOString().slice(0, 16).replace('T', ' ');
let choisi = null;
const TEXTE = Array.from(gd.data[0].text), CD = Array.from(gd.data[0].customdata), S = {};
CD.forEach(c => S[c[3]] = c[2]); // les capteurs de chaque status (vide : tous)
let choisi = null, vus = null; // vus : les cibles visibles (null : toutes)
const touche = k => !vus || !S[k].length || S[k].some(s => vus.has(s));
// Les axes x suivent celui du bas (matches), mais pas dans un relayout avec les shapes : chaque mise à jour leur redonne à
// tous la plage r, par défaut celle de l'axe du bas. Une étiquette écartée devient transparente, sans texte, survol ni clic :
// changer x ou base de la rangée ferait deviner à Plotly un axe linéaire au lieu de dates.
const AXES = Object.keys(gd._fullLayout).filter(x => /^xaxis\\d*$/.test(x)), BAS = AXES.find(x => !gd._fullLayout[x].matches);
function applique(r = gd._fullLayout[BAS].range.slice()) {
const d = {}, vis = CD.map(c => touche(c[3]));
Plotly.restyle(gd, {'marker.opacity': [vis.map(v => +v)], text: [TEXTE.map((t, i) => vis[i] ? t : '')],
customdata: [CD.map((c, i) => vis[i] ? c : null)], hoverinfo: [vis.map(v => v ? 'text' : 'skip')]}, [0]);
gd.layout.shapes.forEach((_, i) => d[`shapes[${i}].opacity`] = !touche(EV[i]) ? 0 : choisi === null ? 0.2 : EV[i] === choisi ? 0.4 : 0.05);
AXES.forEach(x => d[x + '.range'] = r);
Plotly.relayout(gd, d);
}
const visibles = () => { // les cibles visibles, null : toutes
const g = gd.data.filter(t => t.legendgroup), v = g.filter(t => t.visible === true || t.visible === undefined);
return v.length === g.length ? null : new Set(v.map(t => t.legendgroup));
};
gd.on('plotly_restyle', () => { // la légende des capteurs : les cibles visibles ont-elles changé ?
const n = visibles();
if (String(n && [...n].sort()) === String(vus && [...vus].sort())) return;
vus = n;
applique();
});
gd.on('plotly_click', ev => {
const p = ev.points[0];
if (!p.customdata) return;
const [debut, fin, cs, k] = p.customdata, un = choisi !== k;
choisi = un ? k : null;
const m = Math.min(6 * 3600e3, Math.max(3600e3, (ms(fin) - ms(debut)) / 2)), d = {};
gd.layout.shapes.forEach((_, i) => d[`shapes[${i}].opacity`] = !un ? 0.2 : Math.floor(i / R) === k ? 0.4 : 0.05);
for (const x of Object.keys(gd._fullLayout).filter(x => /^xaxis\\d*$/.test(x))) // toutes : elles suivent celle du bas (matches)
d[x + '.range'] = un ? [iso(ms(debut) - m), iso(ms(fin) + m)] : PLAGE;
Plotly.relayout(gd, d);
const m = Math.min(6 * 3600e3, Math.max(3600e3, (ms(fin) - ms(debut)) / 2));
capteurs(un ? cs : []);
vus = visibles(); // déjà à jour : l'événement plotly_restyle de capteurs(), plus tard, ne refait rien
applique(un ? [iso(ms(debut) - m), iso(ms(fin) + m)] : PLAGE);
});
"""
def status(evts, pas):
"""Événements des détecteurs -> status affichés (hierarchie-des-status.md) : [(status, morceaux)] ; status : category,
label, sensors, text, d0, d1 (un pas après la dernière mesure) ; morceaux : ses plages [(début, fin)] non occultées."""
ss = []
for v in sorted(evts, key=lambda v: v["start"]):
if v["category"] in detecteurs.STATUT_HORS:
continue
c = FUSION.get(v["category"], v["category"])
s = {"category": c, "label": NOMS.get(c, v["label"]), "sensors": v["sensors"], "text": v["text"],
"d0": donnees.instant(v["start"]), "d1": donnees.instant(v["end"]) + pas}
p = next((p for p in reversed(ss) if p["category"] == c), None)
if c in NOMS and p and s["d0"] <= p["d1"]: # deux phases thermiques qui se touchent : un seul Thermal movements
p["d1"] = max(p["d1"], s["d1"])
p["sensors"] = sorted(set(p["sensors"]) | set(s["sensors"])) if p["sensors"] and s["sensors"] else []
p["text"] += " " + s["text"]
else:
ss.append(s)
def occulte(f, s): # règles 2 et 4 : f est plus fort, et concerne tous les capteurs ou au moins tous ceux de s
return s["category"] in OCCULTE.get(f["category"], ()) and (
not f["sensors"] or bool(s["sensors"]) and set(s["sensors"]) <= set(f["sensors"]))
out = []
for s in ss:
morceaux = [(s["d0"], s["d1"])]
for f in ss:
if occulte(f, s): # s coupé : ce qui reste avant f, ce qui reste après
morceaux = [m for a, b in morceaux for m in ((a, min(b, f["d0"])), (max(a, f["d1"]), b)) if m[0] < m[1]]
if morceaux:
out.append((s, morceaux))
return out
def page(dossier, du=None, au=None):
mesures = donnees.charger(dossier)
if not mesures:
@@ -61,28 +125,28 @@ def page(dossier, du=None, au=None):
# 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
evts = sorted((v for v in detecteurs.score.evenements(mesures, donnees.iso(a), donnees.iso(b))
if v["category"] not in detecteurs.STATUT_HORS), key=lambda v: v["start"])
plages = [(donnees.instant(v["start"]), donnees.instant(v["end"]) + pas) for v in evts]
voies, voie = [], [] # fin de la dernière étiquette de chaque rangée ; la rangée de chaque événement
for d0, d1 in plages:
k = next((i for i, f in enumerate(voies) if f <= d0), len(voies)) # la première rangée libre, sinon une nouvelle
voies[k:k + 1] = [d1]
voie.append(k)
affiches = status(detecteurs.score.evenements(mesures, donnees.iso(a), donnees.iso(b)), pas)
morceaux = sorted(((k, d0, d1) for k, (_, ms) in enumerate(affiches) for d0, d1 in ms), key=lambda m: m[1])
voies, voie = [], [] # fin de la dernière étiquette de chaque rangée ; la rangée de chaque morceau
for _, d0, d1 in morceaux:
r = next((i for i, f in enumerate(voies) if f <= d0), len(voies)) # la première rangée libre, sinon une nouvelle
voies[r:r + 1] = [d1]
voie.append(r)
titres = ["", "corr_x (px)", "corr_y (px)", *["Camera movement: pan, tilt, rotation (deg)"] * bool(poses)]
hauteurs = [VOIE * max(1, len(voies)), 260, 260, 200][:len(titres)] # px
fig = make_subplots(rows=len(titres), cols=1, shared_xaxes=True, subplot_titles=titres, vertical_spacing=0.06,
row_heights=hauteurs)
survol = {k: f"<b>{s['label']}</b><br>{plotly_t(donnees.iso(s['d0']))} → {plotly_t(donnees.iso(s['d1']))} UTC<br>sensors: "
+ (", ".join(s["sensors"]) or "all") + "<br>" + "<br>".join(textwrap.wrap(s["text"], 90))
+ "<br><i>click: select, again: show all</i>" for k, (s, _) in enumerate(affiches)}
fig.add_trace(go.Bar(
orientation="h", y=voie, base=[d0 for d0, _ in plages], x=[(d1 - d0).total_seconds() * 1000 for d0, d1 in plages],
marker_color=[TEINTES.get(v["category"], detecteurs.GRIS) for v in evts], text=[v["label"] for v in evts],
textposition="inside", insidetextanchor="middle", textangle=0, hoverinfo="text", showlegend=False, name="Events",
hovertext=[f"<b>{v['label']}</b><br>{plotly_t(v['start'])} → {plotly_t(donnees.iso(d1))} UTC<br>sensors: "
+ (", ".join(v["sensors"]) or "all") + "<br>" + "<br>".join(textwrap.wrap(v["text"], 90))
+ "<br><i>click: select, again: show all</i>" for v, (_, d1) in zip(evts, plages)],
customdata=[[plotly_t(v["start"]), plotly_t(donnees.iso(d1)), v["sensors"], k]
for k, (v, (_, d1)) in enumerate(zip(evts, plages))]), row=1, col=1)
orientation="h", y=voie, base=[d0 for _, d0, _ in morceaux], x=[(d1 - d0).total_seconds() * 1000 for _, d0, d1 in morceaux],
marker_color=[TEINTES.get(affiches[k][0]["category"], detecteurs.GRIS) for k, _, _ in morceaux],
text=[affiches[k][0]["label"] for k, _, _ in morceaux], textposition="inside", insidetextanchor="middle", textangle=0,
hoverinfo="text", showlegend=False, name="Events", hovertext=[survol[k] for k, _, _ in morceaux],
customdata=[[plotly_t(donnees.iso(s["d0"])), plotly_t(donnees.iso(s["d1"])), s["sensors"], k]
for k, s in ((k, affiches[k][0]) for k, _, _ in morceaux)]), row=1, col=1)
for i, s in enumerate(sorted(mesures)):
ms = [m for m in mesures[s] if a <= m["t"] < b]
ref = s in refs
@@ -98,13 +162,16 @@ def page(dossier, du=None, au=None):
row=4, col=1)
rang = {k: i for i, k in enumerate(detecteurs.score.categories.CATEGORIES)}
vus = set()
for v, (d0, d1) in zip(evts, plages): # les plages de l'événement k : shapes k * R à k * R + R - 1 (SELECTION_JS)
rang["thermique"] = rang["dilatation_thermique"]
vus, ev = set(), []
for k, d0, d1 in morceaux:
s = affiches[k][0]
for r in range(2, len(titres) + 1):
fig.add_vrect(x0=d0, x1=d1, 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.add_vrect(x0=d0, x1=d1, row=r, col=1, fillcolor=TEINTES.get(s["category"], detecteurs.GRIS), opacity=0.2,
line_width=0, layer="below", legend="legend2", legendgroup=s["label"], name=s["label"],
legendrank=rang.get(s["category"], 99), showlegend=s["label"] not in vus)
vus.add(s["label"])
ev.append(k)
fig.update_layout(height=sum(hauteurs) + 260, hovermode="closest", plot_bgcolor="white",
margin={"l": 60, "r": 20, "t": 100, "b": 40}, bargap=0.15,
uniformtext={"minsize": 9, "mode": "hide"}, # une étiquette trop courte pour son nom : au survol seul
@@ -116,7 +183,7 @@ def page(dossier, du=None, au=None):
fig.update_yaxes(autorange="reversed", showticklabels=False, showgrid=False, fixedrange=True, row=1, col=1)
script = ("const gd = document.getElementById('{plot_id}');" + detecteurs.CAPTEURS_JS
+ SELECTION_JS.replace("__R__", str(len(titres) - 1))
+ SELECTION_JS.replace("__EV__", json.dumps(ev))
.replace("__PLAGE__", json.dumps([plotly_t(donnees.iso(a)), plotly_t(donnees.iso(b))])))
station = os.path.basename(os.path.normpath(dossier))
nom = f"{station}_{donnees.iso(a)[:10]}_{donnees.iso(b)[:10]}"