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:
1 parent
148870f3ff
commit
010798d992
5 files changed
+91
-16
No files matched your search
+84
-12
@@ -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
|
||||
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
|
||||
de champs de l'analyste (etiquettes.json). Une étiquette se corrige dans ce fichier, puis recharger la page. Les zones
|
||||
étiquetées sont grisées sur tous les plots ; sur la barre, une barre chacune, son texte au survol, celles qui se chevauchent
|
||||
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
|
||||
(ce script lancé à chaque fois, comme le data loader) et /labels (lire et ajouter).
|
||||
de champs de l'analyste (etiquettes.json). Les zones étiquetées sont grisées sur tous les plots ; sur la barre, une barre
|
||||
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
|
||||
enregistre son nouveau texte ; ses bornes se corrigent, et elle se retire, dans ce fichier, puis recharger la page. Son serveur
|
||||
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]]
|
||||
(sans dossier : le data loader seul ; --au exclu ; sans dates, toute la période du dossier ; page :
|
||||
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 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 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;
|
||||
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 marge = () => ({l: 60, r: 20, t: 10, b: 30});
|
||||
|
||||
@@ -78,8 +83,8 @@ function dessineFig() {
|
||||
}
|
||||
|
||||
function dessineBarre() {
|
||||
const tries = [...labels].sort((a, b) => a.debut < b.debut ? -1 : 1), voies = [];
|
||||
const voie = tries.map(l => { // la première rangée libre, sinon une nouvelle, comme les status
|
||||
tries = [...labels].sort((a, b) => a.debut < b.debut ? -1 : 1);
|
||||
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;
|
||||
voies[i] = l.fin;
|
||||
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)),
|
||||
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
|
||||
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,
|
||||
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},
|
||||
@@ -108,6 +113,40 @@ function choisit(c) {
|
||||
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;
|
||||
texte.oninput = maj;
|
||||
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'));
|
||||
});
|
||||
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.
|
||||
fetch('/labels?station=' + encodeURIComponent(STATION))
|
||||
.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>
|
||||
<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}}
|
||||
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>
|
||||
{chargeur.formulaire(station, du or "", au or "")}
|
||||
<label>Plot <select id="plot">{options}</select></label>
|
||||
<div id="fig"></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>
|
||||
<textarea id="texte" rows="3" placeholder="What do we see in this range?"></textarea>
|
||||
<p><button id="add" disabled>Add</button></p>
|
||||
@@ -247,6 +291,28 @@ def ajouter(corps):
|
||||
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):
|
||||
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
|
||||
self.send_error(500, f"labeling/{station}.jsonl unreadable: {e}")
|
||||
|
||||
def do_POST(self):
|
||||
def ecrit(self, action):
|
||||
if self.path != "/labels":
|
||||
return self.send_error(404)
|
||||
# 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}"):
|
||||
return self.send_error(403)
|
||||
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:
|
||||
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__":
|
||||
|
||||
Reference in new issue
Block a user