Annotationsdateien

Die Dateien sind byte-gleich mit denen des Desktop-Werkzeugs LumiScan Annotation; LumiScan Training und jedes andere Werkzeug, das sie liest, funktionieren unverändert.

Neben jedem Bild

Zu einem Bild <Name>.png (oder .jpg, .bmp, .tif; eine Seite eines mehrseitigen TIFF verwendet <Name>_page002 usw., siehe Bildformate):

<Name>.csv

Die Rahmen (Referenzannotation): eine Zeile je Rahmen.

<Name>.json

Der Speicherverlauf: wer wann gespeichert hat.

CSV: die Rahmen

Tabulatorgetrennt, mit Kopfzeile, eine Zeile je Rahmen:

 centerX	 centerY	   width	  height	angleRad	   label	metadata
 +1106.6	  +149.1	   +68.3	   +59.0	  +0.857	     nut	    null
  +681.4	  +613.1	  +210.6	   +64.8	  +2.512	 bracket	    null

centerX, centerY

Mittelpunkt des Rahmens in Bildpixeln; x nach rechts, y nach unten ab der linken oberen Bildecke.

width

Entlang der eigenen x-Achse des Rahmens, in Pixeln.

height

Entlang der eigenen y-Achse des Rahmens, in Pixeln.

angleRad

Drehung in Radiant, im Uhrzeigersinn in Bildkoordinaten. 0: Die Oberkante zeigt nach oben. Die Unterkante (grün gezeichnet) ist die Kante bei +height/2.

label

Die Klasse des Objekts.

metadata

Zusatzdaten als kompaktes JSON, null, wenn keine.

Zahlen haben ein Vorzeichen und eine Nachkommastelle (Winkel: drei), rechtsbündig in 8 Zeichen; Label und Metadaten sind ebenfalls rechtsbündig in 8 Zeichen. Zeilenenden wie beim Desktop-Werkzeug: CRLF unter Windows, LF unter Linux.

JSON: der Speicherverlauf

Ein Array mit einem Eintrag je Speichern:

[
    {
        "user": "anna",
        "timestamp": 1794009447,
        "imageName": "part_003.png",
        "annotationName": "part_003.csv"
    },
    {
        "user": "david",
        "timestamp": 1794009449,
        "imageName": "part_003.png",
        "annotationName": "part_003.csv"
    }
]

timestamp ist die Zeit des Speicherns in Sekunden seit 1970-01-01 UTC (Unix-Zeit).

auto-consensus kennzeichnet eine automatisch geschriebene Referenz, weil alle Annotatoren übereinstimmten.

Mehrere Annotatoren je Bild

Die eigenen Versionen der Annotatoren liegen getrennt, damit das Training sie nicht liest:

<Ordner>/.annotations/<Name>/<Benutzer>.tsv     Version eines Annotators (gleiches Format wie die CSV)
<Ordner>/.annotations/<Name>/consensus.json    wer die Referenz wann entschieden hat

Projekteinstellungen

<Projektordner>/.lumiscan-annotation/settings.json: Labels, Interessensbereich, Linienstärke, mehrere Annotatoren je Bild, Rahmenvorschläge. Die Schlüssel labels und roiSettings sind die der settings.json des Desktop-Werkzeugs.

Was in der Datenbank liegt

Alles andere liegt in der Datenbank des Servers: Konten, Sitzungen, Projekte und Mitglieder, der Verlauf jeder gespeicherten Version, Überarbeitungshinweise und ein Verzeichnis der Bilder. Siehe Sicherung und Wiederherstellung.