---
title: "Annotationsdateien"
description: "Dateiformat von LumiScan Annotation Web: CSV mit den gedrehten Rahmen, JSON-Speicherverlauf, Versionen der Annotatoren, wie im Desktop-Werkzeug."
product: "LumiScan Annotation Web"
component: "lumiscan-annotation-web-de"
version: "2.1.0"
display_version: "2.1.0.0"
latest_version: false
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/2.1.0/annotation-files.html"
---

# Annotationsdateien – LumiScan Annotation Web

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`:

|   |   |
| --- | --- |
| `<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:

```none
 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:

```json
[
    {
        "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:

```none
<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](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/2.1.0/backup-and-restore.html).