Labeling tool: a click on a label shows it, its text is edited and saved (point 68)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-02 08:56:16 +01:00
1 parent 8f6ed5ec60
commit 7518a386ae
1 file changed
+84 -12
+84 -12
View File
@@ -3,10 +3,11 @@ voit, en langage naturel, sans catégorie ; les données se consultent sur le mo
Status ; un menu déroulant, un plot à la fois, comme le menu Advanced d'Explore, plus les métriques système numériques de Status ; un menu déroulant, un plot à la fois, comme le menu Advanced d'Explore, plus les métriques système numériques de
metrics/ (« System: … », sans les identifiants) ; dessous, une barre de temps aux mêmes abscisses, qui suit le zoom : y glisser sélectionne une plage, puis du texte et Add. Add écrit aussitôt une ligne dans metrics/ (« System: … », sans les identifiants) ; dessous, une barre de temps aux mêmes abscisses, qui suit le zoom : y glisser sélectionne une plage, puis du texte et Add. Add écrit aussitôt une ligne dans
labeling/<STATION>.jsonl : {"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "description": "…"}, en UTC, les noms labeling/<STATION>.jsonl : {"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "description": "…"}, en UTC, les noms
de champs de l'analyste (etiquettes.json). Une étiquette se corrige dans ce fichier, puis recharger la page. Les zones de champs de l'analyste (etiquettes.json). Les zones étiquetées sont grisées sur tous les plots ; sur la barre, une barre
étiquetées sont grisées sur tous les plots ; sur la barre, une barre chacune, son texte au survol, celles qui se chevauchent chacune, son texte au survol, celles qui se chevauchent l'une sous l'autre. Un clic sur l'une l'affiche dessous, et Save y
l'une sous l'autre. Son serveur local (http://127.0.0.1:8767, lancé en tâche de fond) sert out/ et data/, plus /analyse enregistre son nouveau texte ; ses bornes se corrigent, et elle se retire, dans ce fichier, puis recharger la page. Son serveur
(ce script lancé à chaque fois, comme le data loader) et /labels (lire et ajouter). local (http://127.0.0.1:8767, lancé en tâche de fond) sert out/ et data/, plus /analyse (ce script lancé à chaque fois, comme
le data loader) et /labels (lire, ajouter, modifier) ; un changement de son code demande de l'arrêter (run.md).
Usage : python3 labeling/labeling.py [<dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ]] Usage : python3 labeling/labeling.py [<dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ]]
(sans dossier : le data loader seul ; --au exclu ; sans dates, toute la période du dossier ; page : (sans dossier : le data loader seul ; --au exclu ; sans dates, toute la période du dossier ; page :
out/labeling_<STATION>_<du>_<au>.html, ouverte) out/labeling_<STATION>_<du>_<au>.html, ouverte)
@@ -48,8 +49,12 @@ PAGE_JS = """
const GRIS = '#6b6b66', BLEU = '#2a78d6', VOIE = 22; // VOIE : px par rangée d'étiquettes const GRIS = '#6b6b66', BLEU = '#2a78d6', VOIE = 22; // VOIE : px par rangée d'étiquettes
const fig = document.getElementById('fig'), barre = document.getElementById('barre'), menu = document.getElementById('plot'); const fig = document.getElementById('fig'), barre = document.getElementById('barre'), menu = document.getElementById('plot');
const texte = document.getElementById('texte'), add = document.getElementById('add'), plage = document.getElementById('plage'); const texte = document.getElementById('texte'), add = document.getElementById('add'), plage = document.getElementById('plage');
const edition = document.getElementById('edition'), editPlage = document.getElementById('edit-plage'), editTexte = document.getElementById('edit-texte');
const save = document.getElementById('save'), note = document.getElementById('edit-note');
const AIDE = plage.textContent; const AIDE = plage.textContent;
let labels = [], choix = null; // choix : la plage sélectionnée, [debut, fin] au format des étiquettes // choix : la plage sélectionnée, [debut, fin] au format des étiquettes ; tries : les étiquettes dans l'ordre de la barre ;
// ouverte : celle affichée sous la barre
let labels = [], choix = null, tries = [], ouverte = null;
const lisible = s => s.slice(0, 16).replace('T', ' '); const lisible = s => s.slice(0, 16).replace('T', ' ');
const marge = () => ({l: 60, r: 20, t: 10, b: 30}); const marge = () => ({l: 60, r: 20, t: 10, b: 30});
@@ -78,8 +83,8 @@ function dessineFig() {
} }
function dessineBarre() { function dessineBarre() {
const tries = [...labels].sort((a, b) => a.debut < b.debut ? -1 : 1), voies = []; tries = [...labels].sort((a, b) => a.debut < b.debut ? -1 : 1);
const voie = tries.map(l => { // la première rangée libre, sinon une nouvelle, comme les status const voies = [], voie = tries.map(l => { // la première rangée libre, sinon une nouvelle, comme les status
const r = voies.findIndex(f => f <= l.debut), i = r < 0 ? voies.length : r; const r = voies.findIndex(f => f <= l.debut), i = r < 0 ? voies.length : r;
voies[i] = l.fin; voies[i] = l.fin;
return i; return i;
@@ -88,7 +93,7 @@ function dessineBarre() {
return Plotly.react(barre, [{type: 'bar', orientation: 'h', y: voie, base: tries.map(l => lisible(l.debut)), return Plotly.react(barre, [{type: 'bar', orientation: 'h', y: voie, base: tries.map(l => lisible(l.debut)),
x: tries.map(l => Date.parse(l.fin) - Date.parse(l.debut)), width: 0.85, marker: {color: GRIS}, text: tries.map(l => l.description), x: tries.map(l => Date.parse(l.fin) - Date.parse(l.debut)), width: 0.85, marker: {color: GRIS}, text: tries.map(l => l.description),
textposition: 'inside', insidetextanchor: 'start', textangle: 0, unselected: {marker: {opacity: 1}}, // sinon une sélection les pâlit textposition: 'inside', insidetextanchor: 'start', textangle: 0, unselected: {marker: {opacity: 1}}, // sinon une sélection les pâlit
hoverinfo: 'text', hovertext: tries.map(l => `${lisible(l.debut)} → ${lisible(l.fin)} UTC<br>${l.description.replace(/\\n/g, '<br>')}`)}], hoverinfo: 'text', hovertext: tries.map(l => `${lisible(l.debut)} → ${lisible(l.fin)} UTC<br>${l.description.replace(/\\n/g, '<br>')}<br><i>click: read, edit</i>`)}],
{height: 40 + VOIE * n, dragmode: 'select', selectdirection: 'h', hovermode: 'closest', plot_bgcolor: '#f2f2ef', showlegend: false, {height: 40 + VOIE * n, dragmode: 'select', selectdirection: 'h', hovermode: 'closest', plot_bgcolor: '#f2f2ef', showlegend: false,
margin: {...marge(), l: f._size.l, r: f._size.r}, uniformtext: {minsize: 9, mode: 'hide'}, margin: {...marge(), l: f._size.l, r: f._size.r}, uniformtext: {minsize: 9, mode: 'hide'},
xaxis: {type: 'date', range: f.xaxis.range.slice(), showgrid: false}, xaxis: {type: 'date', range: f.xaxis.range.slice(), showgrid: false},
@@ -108,6 +113,40 @@ function choisit(c) {
return Plotly.relayout(fig, {shapes: zones()}); return Plotly.relayout(fig, {shapes: zones()});
} }
const modifiee = () => ouverte && editTexte.value.trim() !== ouverte.description;
function majEdition(message = '') {
save.disabled = !modifiee() || !editTexte.value.trim();
note.textContent = message;
}
function ouvre(l) { // l : l'étiquette à afficher, null pour fermer ; un texte modifié, non enregistré, ne se perd pas sans le dire
if (modifiee() && !confirm('Discard your changes to this label?')) return;
ouverte = l;
edition.hidden = !l;
if (!l) return;
editPlage.textContent = `${lisible(l.debut)} → ${lisible(l.fin)} UTC`;
editTexte.value = l.description;
majEdition();
edition.scrollIntoView({block: 'nearest'});
}
editTexte.oninput = () => majEdition();
document.getElementById('fermer').onclick = () => ouvre(null);
save.onclick = async () => {
save.disabled = true;
const corps = {station: STATION, avant: ouverte, description: editTexte.value.trim()};
const r = await fetch('/labels', {method: 'PUT', body: JSON.stringify(corps)}).catch(e => e);
if (!r.ok) { // rien n'est perdu : le texte reste dans la fenêtre
majEdition();
return alert('Not saved: ' + (r.statusText || r.message));
}
ouverte.description = (await r.json()).description;
editTexte.value = ouverte.description;
await dessineBarre();
majEdition('Saved');
};
menu.onchange = dessineFig; menu.onchange = dessineFig;
texte.oninput = maj; texte.oninput = maj;
add.onclick = async () => { add.onclick = async () => {
@@ -132,6 +171,7 @@ dessineFig().then(dessineBarre).then(() => {
if (r) choisit(r.map(v => String(v).slice(0, 16).replace(' ', 'T') + 'Z')); if (r) choisit(r.map(v => String(v).slice(0, 16).replace(' ', 'T') + 'Z'));
}); });
barre.on('plotly_deselect', () => choisit(null)); barre.on('plotly_deselect', () => choisit(null));
barre.on('plotly_click', ev => ouvre(tries[ev.points[0].pointIndex]));
// Lues à chaque chargement, pas écrites dans la page : recharger montre toujours le fichier. // Lues à chaque chargement, pas écrites dans la page : recharger montre toujours le fichier.
fetch('/labels?station=' + encodeURIComponent(STATION)) fetch('/labels?station=' + encodeURIComponent(STATION))
.then(r => r.ok ? r.json() : Promise.reject(new Error(r.statusText))) .then(r => r.ok ? r.json() : Promise.reject(new Error(r.statusText)))
@@ -206,12 +246,16 @@ def page(dossier, du=None, au=None):
chemin.write_text(f"""<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Labeling {html.escape(nom)}</title> chemin.write_text(f"""<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Labeling {html.escape(nom)}</title>
<script src="https://cdn.plot.ly/plotly-{get_plotlyjs_version()}.min.js"></script> <script src="https://cdn.plot.ly/plotly-{get_plotlyjs_version()}.min.js"></script>
<style>body{{font-family:system-ui,sans-serif;margin:16px;background:#fff;color:#1a1a19}} <style>body{{font-family:system-ui,sans-serif;margin:16px;background:#fff;color:#1a1a19}}
textarea{{width:100%;box-sizing:border-box;font:inherit;padding:6px}} select,button{{font:inherit}} #plage{{margin:8px 0}}</style></head><body> textarea{{width:100%;box-sizing:border-box;font:inherit;padding:6px}} select,button{{font:inherit}} #plage{{margin:8px 0}}
#edition{{border:1px solid #d5d5d0;border-radius:6px;padding:8px 12px;margin:8px 0;background:#f7f7f4}} #edition textarea{{margin-top:6px}} #edition p{{margin:6px 0 0}}</style></head><body>
<h2>Labeling, {html.escape(station)}</h2> <h2>Labeling, {html.escape(station)}</h2>
{chargeur.formulaire(station, du or "", au or "")} {chargeur.formulaire(station, du or "", au or "")}
<label>Plot <select id="plot">{options}</select></label> <label>Plot <select id="plot">{options}</select></label>
<div id="fig"></div> <div id="fig"></div>
<div id="barre"></div> <div id="barre"></div>
<section id="edition" hidden><b id="edit-plage"></b>
<textarea id="edit-texte" rows="3"></textarea>
<p><button id="save" disabled>Save</button> <button id="fermer">Close</button> <span id="edit-note"></span></p></section>
<p id="plage">Drag on the bar above to select a time range.</p> <p id="plage">Drag on the bar above to select a time range.</p>
<textarea id="texte" rows="3" placeholder="What do we see in this range?"></textarea> <textarea id="texte" rows="3" placeholder="What do we see in this range?"></textarea>
<p><button id="add" disabled>Add</button></p> <p><button id="add" disabled>Add</button></p>
@@ -247,6 +291,28 @@ def ajouter(corps):
return label return label
def modifier(corps):
"""Le corps d'un Save (station, avant : l'étiquette telle que la page l'a lue, description : le nouveau texte) -> l'étiquette
écrite ; ValueError s'il n'est pas bon. Retrouvée par son contenu, pas par son rang : le fichier a pu changer à la main
depuis le chargement de la page. Les autres lignes restent telles quelles."""
station, avant, description = corps["station"], corps["avant"], corps["description"].strip()
if station not in chargeur.stations():
raise ValueError("unknown station")
if not description:
raise ValueError("empty text")
f = fichier(station)
lignes = f.read_text(encoding="utf-8").split("\n") if f.exists() else []
for i, ligne in enumerate(lignes):
if ligne.strip() and json.loads(ligne) == avant:
label = {**avant, "description": description}
lignes[i] = json.dumps(label, ensure_ascii=False)
provisoire = f.with_name(f.name + ".tmp") # écrit à côté puis remplacé : une coupure ne peut pas abîmer le fichier
provisoire.write_text("\n".join(lignes), encoding="utf-8")
os.replace(provisoire, f)
return label
raise ValueError("this label is no longer in the file, reload the page")
class Serveur(chargeur.Chargeur): class Serveur(chargeur.Chargeur):
SCRIPT = __file__ SCRIPT = __file__
@@ -270,16 +336,22 @@ class Serveur(chargeur.Chargeur):
except ValueError as e: # une ligne abîmée à la main : le dire, sans toucher au fichier except ValueError as e: # une ligne abîmée à la main : le dire, sans toucher au fichier
self.send_error(500, f"labeling/{station}.jsonl unreadable: {e}") self.send_error(500, f"labeling/{station}.jsonl unreadable: {e}")
def do_POST(self): def ecrit(self, action):
if self.path != "/labels": if self.path != "/labels":
return self.send_error(404) return self.send_error(404)
# Ce fichier sera lu par l'analyste : une autre page du navigateur ne doit pas pouvoir y écrire. # Ce fichier sera lu par l'analyste : une autre page du navigateur ne doit pas pouvoir y écrire.
if self.headers.get("Origin") not in (None, f"http://127.0.0.1:{PORT}"): if self.headers.get("Origin") not in (None, f"http://127.0.0.1:{PORT}"):
return self.send_error(403) return self.send_error(403)
try: try:
self.repond(ajouter(json.loads(self.rfile.read(int(self.headers["Content-Length"]))))) self.repond(action(json.loads(self.rfile.read(int(self.headers["Content-Length"])))))
except (KeyError, TypeError, AttributeError, ValueError) as e: except (KeyError, TypeError, AttributeError, ValueError) as e:
self.send_error(400, f"Not a label: {e}") self.send_error(400, str(e))
def do_POST(self):
self.ecrit(ajouter)
def do_PUT(self):
self.ecrit(modifier)
if __name__ == "__main__": if __name__ == "__main__":