# LumiScan Annotation Web 2.4.1.2 – complete documentation

> All pages of the LumiScan Annotation Web 2.4.1.2 manual (language: de) by HD Vision Systems GmbH, in navigation order. Each page starts with a level-1 heading followed by its URL; cite that URL. Manual: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/

# LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/index.html

|   |   |   |
| --- | --- | --- |
| ![Browserfenster: Bilder von Teilen in gedrehten Rahmen, zwei Personen arbeiten gleichzeitig](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/intro/step-1.svg)<br><br>**Im Browser annotieren.** Gedrehte Rahmen als Mittellinien-Rechteck mit drei Klicks, von beliebig vielen Personen gleichzeitig. | ![Die Rahmen zweier Annotatoren über demselben Teil, verglichen: Übereinstimmung und eine markierte Abweichung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/intro/step-2.svg)<br><br>**Qualität prüfen.** Annotatoren vergleichen, Abweichungen entscheiden, Übereinstimmung sehen. | ![Bild (PNG) mit seinen Annotationsdateien (CSV mit Rahmen, JSON mit Speicherverlauf), gelesen von LumiScan Training](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/intro/step-3.svg)<br><br>**Netz trainieren.** Die Rahmen liegen als CSV neben jedem Bild, bereit für LumiScan Training. |

LumiScan Annotation Web ist die Browser-Version von LumiScan Annotation. Ein Server unter Windows oder Linux hält die Bilder und Annotationen; die Annotatoren brauchen nur einen Webbrowser und melden sich mit einem lokalen Konto, dem Firmenverzeichnis oder Single Sign-on an. Die Arbeit ist in Projekte mit eigenen Bildern, Mitgliedern und Einstellungen gegliedert. Mehrere Annotatoren können dasselbe Bild unabhängig annotieren: Der Server vergleicht ihre Rahmen, schreibt die Referenz selbst, wenn sie übereinstimmen, und zeigt Prüfern, wo sie abweichen. Rahmenvorschläge Ihrer trainierten Netze beschleunigen die Arbeit. Die Dateien sind genau die des Desktop-Werkzeugs; LumiScan Training liest sie unverändert.

Zum Einstieg siehe [Die ersten Bilder annotieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/annotate-your-first-images.html). Server installieren: [Vor der Installation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/before-installation.html). Fragen oder eine Fehlermeldung? Siehe [FAQ](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/faq.html) und [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html).

# Beschreibung – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/description.html

LumiScan Annotation Web erzeugt die Trainingsdaten für neuronale Netze, die Objekte erkennen und lokalisieren, etwa für LumiScan AI Object Matching oder LumiScan VGR. Sie zeichnen einen **gedrehten Rahmen** (ein Rechteck, das gedreht werden kann) um jedes Objekt in einem Bild und geben ihm ein Label, die Klasse des Objekts. LumiScan Training lernt aus diesen Rahmen.

Es ist der Nachfolger des Desktop-Werkzeugs LumiScan Annotation. Die Annotationslogik läuft in einem Server; annotiert wird im Webbrowser, von jedem PC im Firmennetz, ohne Installation.

## Was es bietet

- **Annotieren:**
  - Gedrehte Rahmen, als [Mittellinien-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-line-rectangle) mit drei Klicks gezeichnet, verschoben, in der Größe geändert und gedreht mit Maus oder Tastatur.
  - Eine Lupe mit Fadenkreuz am Mauszeiger für Kanten auf ein Zehntel Pixel genau.
  - Labels mit den Tasten 1 bis 9, Helligkeit und Kontrast, ein Interessensbereich, **Speichern und aufs nächste kopieren** für Bildserien.
  - Rückgängig und Wiederherstellen sowie ein Verlauf jedes gespeicherten Stands jedes Bildes.
- **Im Team arbeiten:**
  - **Projekte**: unabhängige Annotationsaufträge, jeder mit eigenen Bildern, Einstellungen und Mitgliedern.
  - **Rollen**: Annotator, Prüfer (Reviewer), Projekt-Admin und Server-Admin. Der Server setzt sie durch.
  - **Anmeldung** mit lokalen Konten, dem Firmenverzeichnis (Active Directory / LDAP) oder Single Sign-on (OpenID Connect, z. B. Keycloak oder Microsoft Entra ID).
  - **Bearbeitungssperren**: Ein Bild, das jemand bearbeitet, ist für die anderen nur lesbar.
  - **Überarbeitungshinweise**: Ein Prüfer hinterlässt einem Annotator eine Anweisung an einem Bild.
- **Qualität:**
  - **Mehrere Annotatoren je Bild**: Jeder annotiert das Bild unabhängig, ohne die Rahmen der anderen zu sehen.
  - Der Server vergleicht ihre Rahmen. Stimmen alle überein, schreibt er die Referenzannotation selbst.
  - Prüfer sehen die Abweichungen nummeriert im Bild und entscheiden mit einem Klick.
  - Übereinstimmungsstatistik je Annotator, je Annotatorenpaar und je Ordner.
- **Tempo:**
  - **Rahmenvorschläge** Ihrer trainierten LumiScan-Netze (ONNX) oder eines Detektors mit offenem Vokabular für Teile ohne Netz. Sie übernehmen, korrigieren oder verwerfen sie.
  - Für Bildserien: Rahmen vom vorigen Bild, auf die nächsten Bilder, Kopieren und Einfügen sowie Rahmenvorlagen je Label.
  - **Aktives Lernen**: Das Netz bewertet jedes Bild; die unsichersten werden zuerst annotiert.
  - Suche und Filter: nach Dateinamen, ohne Rahmen, nach Label, mit Hinweisen für Sie, als fertig markiert, nach Trainings-, Validierungs- oder Testmenge.
  - **Fertig-Markierung**: ein Bild als fertig markieren, auch ohne Rahmen; `Shift+D` markiert und geht weiter.
- **Daten:**
  - Die Annotationsdateien sind byte-gleich mit denen des Desktop-Werkzeugs: eine CSV-Datei mit den Rahmen und eine JSON-Datei mit dem Speicherverlauf neben jedem Bild. LumiScan Training und andere Werkzeuge lesen sie unverändert.
  - Projekte in Ordnern auf dem Server oder einer Netzwerkfreigabe oder in einem S3-Bucket (AWS S3, MinIO, SeaweedFS).
  - Export und Import ganzer Projekte, etwa um ein Projekt zur Annotation an HD Vision Systems zu schicken.
  - Bilder in PNG, JPEG, BMP und TIFF, auch mehrseitiges TIFF (Seite für Seite), aus den Ordnern des Servers oder [im Browser hinzugefügt](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html).
  - **Export für LumiScan Training**: ein fertiges Training-Projekt mit stabiler Aufteilung in Trainings-, Validierungs- und Testbilder; dieselben Bilder und dieselbe Aufteilung auch im **COCO**-Format für andere Werkzeuge.
  - Eine **Einzelplatz-Installation** für eine Person an einem PC, im eigenen Fenster, ohne Anmeldung.
  - Automatische Sicherungen von allem, was der Server verwaltet.

## Funktionsweise

Der **Server** (`lumiscan-annotation-server`, Windows oder Linux) liefert die Webseiten und die REST-API. Er liest die Bilder, schreibt jede Annotationsdatei, prüft jede Eingabe und setzt die Rollen durch. Seine eigenen Daten (Konten, Projekte, Verlauf, Hinweise) liegen in einer Datenbankdatei neben seiner Konfiguration.

Der **Browser** zeigt die Bilder und zeichnet die Rahmen. Ohne den Server wird nichts gespeichert.

Der optionale **Dienst für Rahmenvorschläge** führt die Netze auf einem Rechner mit GPU aus und beantwortet die Anfragen des Servers. Bilder verlassen das Firmennetz nicht.

```none
Browser  --HTTP(S)-->  lumiscan-annotation-server  --->  Projektordner oder S3-Bucket
                              |                            <Bild>.png, .csv, .json
                              +--->  Dienst für Rahmenvorschläge (optional, GPU)
```

## Begriffe

- **Annotation:** die Rahmen eines Bildes, gespeichert in `<Bild>.csv`.
- **Label:** die Klasse eines Objekts, z. B. `bracket`. Die Labels eines Projekts gelten für alle darin.
- **Unterkante:** die grün gezeichnete Kante eines Rahmens. Sie gibt dem Rahmen seine Richtung: Ein Winkel von 0 bedeutet, die Oberkante des Rahmens zeigt nach oben.
- **Referenzannotation:** bei mehreren Annotatoren je Bild die Annotation, die das Training verwendet. Automatisch geschrieben, wenn die Annotatoren übereinstimmen, oder von einem Prüfer entschieden.
- **Interessensbereich (ROI):** der Teil der Bilder, der annotiert wird. Vorschläge außerhalb entfallen.

# Voraussetzungen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/requirements.html

## Server

|   |   |
| --- | --- |
| Betriebssystem | Windows 11 oder Ubuntu 24.04 (64 Bit) |
| Speicher | Platz für die Bilder und Annotationsdateien. Die Datenbank (Konten, Verlauf, Hinweise) muss auf einer **lokalen Festplatte** des Servers liegen, nicht auf einer Netzwerkfreigabe. Die Projektordner dürfen auf einer Freigabe liegen. |
| Netzwerk | Ein TCP-Port für die Browser, Standard `8080`. Standardmäßig HTTPS (selbstsigniertes Zertifikat, eigenes Zertifikat oder ein Reverse Proxy wie nginx oder IIS). |
| Optional | Zugriff auf das Firmenverzeichnis (LDAP/LDAPS) oder einen OpenID-Connect-Anbieter für die Anmeldung; Zugriff auf einen S3-Speicher für Projekte in Buckets. |

## Benutzer

- Eine aktuelle Version von Google Chrome, Microsoft Edge oder Mozilla Firefox.
- Empfohlen: ein Bildschirm mit 1280 × 800 Pixeln oder mehr und eine Maus mit Rad. Auf kleineren Bildschirmen werden die Bereiche untereinander angeordnet.
- Keine Installation.

## Dienst für Rahmenvorschläge (optional)

|   |   |
| --- | --- |
| Betriebssystem | Ubuntu 24.04, Windows 11 oder macOS |
| Software | Python 3.12 (alles Weitere richten die Installationsskripte ein) |
| Hardware | Empfohlen ist eine NVIDIA-GPU (CUDA 11.8 oder 12). Unter Windows eignet sich jede DirectX-12-GPU für Ihre ONNX-Netze, unter macOS Apple Silicon. Ohne GPU geht es auch, Vorschläge dauern dann Sekunden je Bild. |
| Netze | Ihre trainierten Netze, wie LumiScan Training sie exportiert (`network.onnx` und `network_description.json`) |

Siehe [Dienst für Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html).

## Lizenz {#licence}

Diese Version von LumiScan Annotation Web läuft ohne LumiScan Key. Bei Fragen zur Lizenzierung wenden Sie sich an HD Vision Systems.

# Die ersten Bilder annotieren – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/annotate-your-first-images.html

Diese Anleitung führt Sie von der Anmeldung bis zu Ihren ersten gespeicherten Annotationen. Sie brauchen die Adresse des Servers (z. B. `https://annotation.example.com`) und ein Konto; beides erhalten Sie von Ihrem Administrator.

## 1. Anmelden

1. Öffnen Sie die Adresse in Chrome, Edge oder Firefox.
2. Melden Sie sich an:
   - mit Benutzername und Passwort oder
   - mit **Mit … anmelden**, wenn Ihr Unternehmen Single Sign-on nutzt.
3. Bei der ersten Anmeldung mit einem lokalen Konto wählen Sie Ihr eigenes Passwort (mindestens 10 Zeichen).

![Anmeldeseite von LumiScan Annotation: Produktname, Anmeldung per Single Sign-on oder mit Benutzername und Passwort, daneben eine Übersicht der LumiScan-Apps Annotation, Training und VGR](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/login.jpg)

## 2. Projekt und Bild öffnen

1. Wählen Sie in der oberen Leiste das **Projekt**. Aufgeführt sind nur Projekte, an denen Sie beteiligt sind; bei nur einem ist die Liste ausgeblendet.
2. Wählen Sie den **Ordner**, meist ein Ordner je Aufnahmetag.
3. Klicken Sie links in der Liste auf ein Bild. Bilder mit gefülltem Punkt haben bereits Rahmen.

## 3. Einen Rahmen zeichnen

Rahmen werden als [Mittellinien-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-line-rectangle) gezeichnet: die Mittellinie von unten nach oben, dann die Breite.

1. Wählen Sie zuerst das Label: Klicken Sie es rechts in der Liste **Labels** an oder drücken Sie seine Zifferntaste.
2. Doppelklicken Sie ins Bild, wo die **Unterkante** des Objekts liegt (oder drücken Sie `N` und klicken Sie).
3. Klicken Sie, wo die **Oberkante** des Objekts liegt. Das zeichnet die Mittellinie und legt Höhe und Winkel fest.
4. Bewegen Sie die Maus seitlich und klicken Sie erneut. Das legt die Breite auf beiden Seiten der Mittellinie fest.

|   |   |   |
| --- | --- | --- |
| ![Erster Klick auf die Unterkante, die gestrichelte Linie folgt der Maus zur Oberkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-1.png) | ![Zweiter Klick auf die Oberkante: Der Rahmen folgt der Maus seitlich; die grüne Linie ist die Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-2.png) | ![Dritter Klick: der fertige Rahmen, ausgewählt, mit dem Label bracket und vier Eckgriffen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-3.png) |
| Unten klicken, zur Oberkante ziehen | Oben klicken, seitlich ziehen | Klicken: Der Rahmen ist fertig |

Die grüne Kante ist die **Unterkante** des Rahmens. Zeichnen Sie alle Objekte einer Art in derselben Richtung, z. B. Unterkante immer dort, wo das Teil flach aufliegt. Das Netz lernt diese Richtung.

> [!TIP]
> Die Lupe neben dem Mauszeiger zeigt die Pixel darunter vergrößert, mit der Position auf 0,1 Pixel. Mit `M` schalten Sie sie aus und ein.

## 4. Einen Rahmen korrigieren

- Ziehen Sie den Rahmen, um ihn zu verschieben, eine Kante, um die Größe zu ändern, eine Ecke, um ihn zu drehen.
- Tasten: Pfeiltasten verschieben um 1 Pixel (mit `Shift` um 10 Pixel); siehe [Tastenkombinationen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/keyboard-shortcuts.html).
- Die Zifferntasten 1 bis 9 ändern das Label des ausgewählten Rahmens.
- Rechtsklick oder `Entf` löscht den ausgewählten Rahmen. `Strg+Z` macht rückgängig.

## 5. Speichern und weiter

- **Speichern** (`S`) speichert die Rahmen. Der Status in der oberen Leiste bestätigt es, z. B. **part_002.png gespeichert**.
- **Speichern und aufs nächste kopieren** (`Alt+S`) speichert, öffnet das nächste Bild und kopiert die Rahmen hinein: praktisch für Bildserien, in denen sich die Teile kaum bewegen.
- `A` und `D` öffnen das vorige und das nächste Bild. Bei ungespeicherten Änderungen werden Sie vorher gefragt.
- **Anzeigen → Ohne Rahmen** zeigt, was noch zu tun ist.

Weiter: [Bilder annotieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html) beschreibt jede Funktion im Detail.

# Ein Projekt für ein Team einrichten – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/set-up-a-project-for-a-team.html

Ein Projekt ist ein unabhängiger Annotationsauftrag: ein Ordner mit Bildern, seine Labels und Einstellungen und die Personen, die daran arbeiten. Diese Anleitung richtet ein Projekt für ein Team von Annotatoren mit einem Prüfer ein. Sie brauchen die Rolle **Admin** (Server-Administrator).

## 1. Bilder bereitstellen

Kopieren Sie die Bilder (PNG, JPEG, BMP oder TIFF) in einen Ordner, den der Server lesen kann, oder fügen Sie sie später im Browser hinzu ([Bilder hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html)); der Ordner kann z. B. `D:\LumiScan\Line7` oder eine auf dem Server eingebundene Netzwerkfreigabe. Die Bilder liegen entweder direkt in diesem Ordner oder in einer Ebene von Unterordnern, meist einem je Tag:

```none
D:\LumiScan\Line7\
    2026-11-02\  image_001.png  image_002.png ...
    2026-11-03\  ...
```

Die Annotationsdateien werden neben die Bilder geschrieben. Ordner mit Annotationen aus dem Desktop-Werkzeug werden übernommen, wie sie sind.

## 2. Projekt anlegen

1. Klicken Sie oben rechts auf Ihren Namen, dann auf **Projekte**.
2. Klicken Sie auf **Neues Projekt**.
3. Geben Sie einen **Name** und auf Wunsch eine **Beschreibung** ein.
4. Tragen Sie unter **Vorhandener Ordner auf dem Server** den Ordner ein, z. B. `D:\LumiScan\Line7`. Leer gelassen legt der Server einen leeren Projektordner an; Bilder kommen dann per Import oder Kopieren hinein.
5. Klicken Sie auf **Projekt anlegen**.

![Dialog Neues Projekt mit den Feldern Name, Beschreibung, Vorhandener Ordner auf dem Server und der Option Für alle angemeldeten Benutzer offen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/new-project.png)

> [!NOTE]
> Welche Ordner Admins verwenden dürfen, lässt sich in der Serverkonfiguration begrenzen (`project_folders`, siehe [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html)). Mit konfigurierten S3-Buckets bietet der Dialog außerdem **Dateien speichern in: S3-Bucket** an, siehe [Projekte in S3-Buckets](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html).

## 3. Mitglieder eintragen

1. Klicken Sie in der Projektliste neben dem Projekt auf **Mitglieder & Zugriff**.
2. Klicken Sie für jede Person oder Gruppe auf **Mitglied hinzufügen**:
   - **Benutzer**: ein Konto des Servers, über seinen Benutzernamen.
   - **Gruppe**: eine Gruppe Ihres Firmenverzeichnisses oder Single Sign-on, z. B. `Annotation Team`. Alle in der Gruppe erhalten die Rollen, auch Personen, die sich erst später zum ersten Mal anmelden.
3. Haken Sie die Rollen an: **Annotator** zeichnet und speichert Rahmen, **Prüfer** vergleicht und entscheidet, **Projektadmin** verwaltet Mitglieder und Einstellungen dieses Projekts.
4. Klicken Sie auf **Speichern**.

![Dialog Mitglieder & Zugriff des Projekts Line 5 – brackets: Name, Beschreibung, die Option offen für alle und eine Mitgliedertabelle mit Benutzer oder Gruppe, Name und den Rollen Annotator, Prüfer und Projektadmin](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/members.png)

Alternativ haken Sie **Für alle angemeldeten Benutzer offen** an: Dann arbeiten alle mit ihren serverweiten Rollen im Projekt (siehe [Benutzer und Rollen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html)).

## 4. Labels und Optionen festlegen

1. Wählen Sie das neue Projekt in der oberen Leiste.
2. Klicken Sie auf **Einstellungen**.
3. Tragen Sie die Labels ein, eines je Zeile, z. B. `bracket`, `nut`, `washer`. Die Reihenfolge ergibt die Tasten 1 bis 9.
4. Optional: ein Interessensbereich, zwei oder mehr Annotatoren je Bild (siehe [Annotationen mit zwei Annotatoren prüfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/check-annotations-with-two-annotators.html)), Rahmenvorschläge.
5. Klicken Sie auf **Einstellungen speichern**.

Alle Optionen: [Projekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html).

## 5. Dem Team Bescheid geben

Schicken Sie den Mitgliedern die Adresse des Servers. Sie melden sich an, wählen das Projekt in der oberen Leiste und legen los; siehe [Die ersten Bilder annotieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/annotate-your-first-images.html).

# Annotationen mit zwei Annotatoren prüfen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/check-annotations-with-two-annotators.html

Zwei Personen, die dasselbe Bild unabhängig annotieren, zeichnen selten genau dieselben Rahmen. Wo sie abweichen, ist das Bild schwierig oder die Anweisung unklar. LumiScan Annotation Web nutzt das, um die Trainingsdaten zu verbessern: Der Server vergleicht die Annotatoren, schreibt die Referenz selbst, wenn sie übereinstimmen, und zeigt einem Prüfer genau, wo sie abweichen.

## 1. Einschalten

Ein Projekt-Admin öffnet **Einstellungen** und setzt unter **Mehrere Annotatoren je Bild**:

- **Annotatoren je Bild**: `2` (oder mehr).
- **Übereinstimmung: Überlappung ≥ %**: wie stark sich zwei Rahmen überlappen müssen, um als derselbe Rahmen zu gelten, Standard 85 %.
- **Übereinstimmung: Winkel innerhalb °**: Standard 5°.
- **Referenz automatisch schreiben, wenn alle Annotatoren übereinstimmen**: ein.

## 2. Blind annotieren

Die Annotatoren arbeiten wie gewohnt im Modus **Annotieren**. Jeder sieht nur seine eigenen Rahmen, nie die der anderen. Die Bildliste zeigt, wie viele ein Bild annotiert haben (`1/2`).

![Modus Annotieren mit zwei Annotatoren je Bild: Die Bildliste zeigt 1/2 oder 2/2 je Bild, das Bild zeigt nur die eigenen Rahmen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/annotate-blind.jpg)

Wenn der letzte Annotator speichert:

- **alle stimmen überein**: dieselben Objekte, dieselben Labels, Überlappung und Winkel innerhalb der Grenzen. Der Server schreibt die gemittelten Rahmen als Referenz `<Bild>.csv`. Der Status meldet **Gespeichert. Alle 2 Annotatoren stimmen überein: Referenzannotation geschrieben**.
- **sie weichen ab**: Das Bild geht in die Prüfung.

## 3. Abweichungen prüfen

Prüfer wechseln in der oberen Leiste auf **Prüfen**. Die Liste ist nach den größten Abweichungen sortiert.

![Modus Prüfen: die Rahmen der beiden Annotatoren in Blau und Orange im Bild, rote nummerierte Markierungen an den Abweichungen und die Liste der Abweichungen rechts](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/review.jpg)

Jeder Annotator hat eine Farbe; rote nummerierte Markierungen zeigen die Abweichungen:

- ein Rahmen, den nur eine Person gezeichnet hat,
- Überlappung zu gering,
- Winkel zu verschieden,
- Unterkante auf der gegenüberliegenden Seite,
- anderes Label.

Für jede Abweichung bietet der Bereich rechts die Rahmen jeder Person, **Mittelwert** oder **Keiner** an. **Anzeigen** zoomt dorthin. Ist jede Abweichung entschieden, schreibt **Speichern** die Referenzannotation. Eine geprüfte Referenz wird nie automatisch überschrieben.

![Bereich Unterschiede: zwei Annotatoren, zwei von sieben Objekten weichen ab; je Abweichung die Schaltflächen Anzeigen, die Namen der Annotatoren, Mittelwert und Keiner](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/review-differences.png)

## 4. Statistik lesen

**Statistik** in der oberen Leiste zeigt die Übereinstimmung für einen Ordner oder das ganze Projekt:

![Übereinstimmung zwischen Annotatoren: Bilder mit zwei Annotatoren, Anteil übereinstimmender Bilder und Objekte, mittlere Überlappung; Tabellen je Annotator, je Paar, Abweichungen nach Art und die Bilder mit den größten Abweichungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/statistics.png)

- **Je Annotator**: Überlappung mit dem Konsens und systematische Gewohnheiten, z. B. breiter als die anderen gezeichnete Rahmen (Breite +3 %) oder gedrehte.
- **Annotatorenpaare**: Übereinstimmung (F1) und mittlere Überlappung.
- **Unterschiede nach Art** und **Größte Unterschiede**: Klicken Sie ein Bild an, um es zu prüfen.

Nutzen Sie die Werte je Annotator, um die Anweisungen zu verbessern: Eine systematische Abweichung bedeutet meist, dass die Regel nicht klar war.

Mehr: [Mehrere Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html).

# Schneller annotieren mit Rahmenvorschlägen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/annotate-faster-with-box-suggestions.html

Einen vorgeschlagenen Rahmen zu korrigieren geht viel schneller, als ihn zu zeichnen. Mit einem Dienst für Rahmenvorschläge fragt LumiScan Annotation Web Ihr trainiertes Netz nach Rahmen für das offene Bild; Sie prüfen und korrigieren nur noch.

## Der Kreislauf

1. Annotieren Sie die ersten paar Hundert Bilder von Hand.
2. Trainieren Sie ein Netz mit LumiScan Training.
3. Kopieren Sie das exportierte Netz in den Dienst für Rahmenvorschläge (siehe [Dienst für Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html)).
4. Annotieren Sie die nächsten Bilder mit Vorschlägen: übernehmen, korrigieren, Fehlendes ergänzen.
5. Trainieren Sie erneut mit dem größeren Datensatz. Jede Runde verbessert die Vorschläge.

Für Teile ohne Netz kann der Dienst einen Detektor mit offenem Vokabular ausführen, der Objekte über die Namen der Labels findet.

## 1. Netz für das Projekt wählen

Ein Projekt-Admin öffnet **Einstellungen** und wählt unter **Rahmenvorschläge** das **Netz** des Projekts. Hat der Dienst nur ein Netz, wird es ohne Auswahl verwendet. Außerdem:

- **Vorschläge ab Konfidenz %**: Vorschläge darunter entfallen (Standard 30 %).
- **Höchstens Rahmen je Bild**: Standard 50.

## 2. Vorschläge holen

Öffnen Sie ein Bild und klicken Sie auf **Rahmen vorschlagen** (`P`). Nach einem Moment erscheinen die Vorschläge als **gestrichelte Rahmen** mit ihrer Konfidenz:

![Ein Bild mit gestrichelten vorgeschlagenen Rahmen, beschriftet mit bracket, nut und washer und ihrer Konfidenz in Prozent; rechts der Hinweis, dass die Vorschläge noch nicht übernommen sind, mit den Schaltflächen Alle übernehmen und Verwerfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/suggestions.jpg)

Rahmen, die schon im Bild sind, und Vorschläge außerhalb des Interessensbereichs werden nicht erneut vorgeschlagen.

## 3. Übernehmen, korrigieren oder verwerfen

- **Korrigieren** Sie einen Vorschlag (verschieben, Größe ändern, drehen, Label ändern): Er ist übernommen.
- Wählen Sie einen Vorschlag aus und drücken Sie `Enter`: Er wird übernommen, wie er ist.
- Rechtsklick: Er wird gelöscht.
- **Alle übernehmen** / **Verwerfen** erledigen alle übrigen Vorschläge.

![Sieben vorgeschlagene Rahmen noch nicht übernommen. Korrigieren oder Enter auf dem ausgewählten übernimmt ihn. Schaltflächen Alle übernehmen und Verwerfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/suggestions-bar.png)

Speichern Sie mit offenen Vorschlägen, werden Sie gefragt, ob sie übernommen oder weggelassen werden sollen. Vorschläge werden nie von selbst gespeichert.

> [!TIP]
> Prüfen Sie jeden Vorschlag, auch solche mit hoher Konfidenz. Ein Netz, das mit korrigierten Vorschlägen trainiert wird, wiederholt seine eigenen Fehler, wenn sie nicht korrigiert werden.

# Vor der Installation – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/before-installation.html

Klären Sie diese Punkte, bevor Sie den Server installieren. Jeder verweist auf die Seite mit den Einzelheiten.

| Frage | Möglichkeiten |
| --- | --- |
| Welcher Rechner betreibt den Server? | Ein Rechner mit Windows 11 oder Ubuntu 24.04, der läuft, solange annotiert wird. Er braucht wenig Rechenleistung; wichtiger sind seine Festplatten. Siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/requirements.html). |
| Wo liegen die Bilder? | In Ordnern auf dem Server oder einer dort eingebundenen Netzwerkfreigabe oder in einem S3-Bucket (AWS S3, MinIO, SeaweedFS). Ordner, die das Desktop-Werkzeug verwendet hat, werden übernommen, wie sie sind. Siehe [Projekte](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html) und [Projekte in S3-Buckets](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html). |
| Wie melden sich die Personen an? | Lokale Konten, im Browser verwaltet, das Firmenverzeichnis (Active Directory / LDAP), Single Sign-on (OpenID Connect) oder eine Kombination. Behalten Sie mindestens einen lokalen Administrator. Siehe [Anmeldeverfahren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/sign-in-methods.html). |
| HTTPS? | Standardmäßig an, mit einem selbstsignierten Zertifikat, vor dem Browser warnen, bis sie ihm vertrauen. Entscheiden Sie, ob stattdessen ein Zertifikat der Zertifizierungsstelle Ihres Unternehmens oder ein Reverse Proxy mit TLS zum Einsatz kommt. Siehe [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https). |
| Rahmenvorschläge? | Brauchen einen Rechner mit GPU für den Dienst für Rahmenvorschläge und Ihre trainierten Netze. Lässt sich später ergänzen. Siehe [Dienst für Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html). |
| Sicherungen? | Der Server sichert seine Datenbank und Konfiguration automatisch. Bilder und Annotationsdateien werden mit den Ordnern selbst gesichert. Siehe [Sicherung und Wiederherstellung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html). |

## Was Sie brauchen

- Das Release-Archiv `LumiScanAnnotationWeb-<Version>-win64.zip` (Windows) oder den Linux-Build von HD Vision Systems.
- Administratorrechte auf dem Serverrechner.
- Für das Verzeichnis: die Adresse eines Domänencontrollers und ein Dienstkonto mit Lesezugriff. Für Single Sign-on: einen beim Identitätsanbieter registrierten Client.

# Server installieren – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/installing-the-server.html

## Windows 11

1. Entpacken Sie `LumiScanAnnotationWeb-<Version>-win64.zip`, z. B. nach `C:\LumiScanAnnotationWeb`. Es enthält:
   ```none
   C:\LumiScanAnnotationWeb\
       lumiscan-annotation-server.exe    der Server
       www\                              die Webseiten
       config\annotation-server.example.json
       README.md, Changelog.md
   ```
2. Kopieren Sie `config\annotation-server.example.json` nach `config\annotation-server.json` und passen Sie die Datei an, siehe [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html). Für den Anfang genügen `port` und entweder `data_root` (ein vorhandener Bildordner) oder `projects_root`.
3. Starten Sie den Server in einer Eingabeaufforderung:
   ```bat
   cd C:\LumiScanAnnotationWeb
   lumiscan-annotation-server.exe --config config\annotation-server.json
   ```
4. Geben Sie den Port (Standard 8080) in der Windows-Firewall für das Netz der Benutzer frei.

## Ubuntu 24.04

1. Kopieren Sie den Server und den Ordner `www`, z. B. nach `/opt/lumiscan-annotation-web`, und die Konfiguration nach `/etc/lumiscan-annotation-web/annotation-server.json`.
2. Legen Sie ein Dienstkonto an, das die Projektordner lesen und schreiben darf:
   ```bash
   sudo useradd --system --home-dir /var/lib/lumiscan-annotation-web --create-home --shell /usr/sbin/nologin lsa
   sudo chown -R lsa: /etc/lumiscan-annotation-web
   ```
3. Starten Sie ihn einmal von Hand, um die Konfiguration zu prüfen:
   ```bash
   sudo -u lsa /opt/lumiscan-annotation-web/lumiscan-annotation-server --config /etc/lumiscan-annotation-web/annotation-server.json
   ```

## Erste Anmeldung

Beim ersten Start, wenn es noch keine Konten gibt, legt der Server den lokalen Benutzer `admin` mit einem zufälligen Passwort an und schreibt es in `initial-admin-password.txt` neben der Datenbank (das Protokoll nennt die Datei).

1. Öffnen Sie `https://<Server>:8080/` im Browser. Der Browser warnt vor dem selbstsignierten Zertifikat: Vergleichen Sie den Fingerabdruck mit dem Serverprotokoll und fahren Sie fort, siehe [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https).
2. Melden Sie sich als `admin` mit diesem Passwort an.
3. Wählen Sie ein neues Passwort. Die Datei wird dann gelöscht.
4. Legen Sie die weiteren Konten an oder richten Sie Verzeichnis oder Single Sign-on ein, siehe [Benutzer und Rollen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html).

Kann sich niemand mehr als Administrator anmelden:

```none
lumiscan-annotation-server --config <Konfiguration> --reset-password admin
```

Das gibt ein neues Passwort aus (und legt das Konto an, falls es fehlt). Es muss bei der nächsten Anmeldung geändert werden.

## Server automatisch starten

Der Server ist ein Programm ohne Fenster. Starten Sie ihn beim Hochfahren mit den üblichen Mitteln des Betriebssystems, unter dem Dienstkonto.

- **Linux (systemd), `/etc/systemd/system/lumiscan-annotation-web.service`:**
  ```ini
  [Unit]
  Description=LumiScan Annotation Web
  After=network-online.target
  Wants=network-online.target

  [Service]
  User=lsa
  ExecStart=/opt/lumiscan-annotation-web/lumiscan-annotation-server --config /etc/lumiscan-annotation-web/annotation-server.json
  Restart=on-failure

  [Install]
  WantedBy=multi-user.target
  ```

  Dann `sudo systemctl enable --now lumiscan-annotation-web`.

- **Windows (Aufgabenplanung), in einer PowerShell als Administrator:**
  ```powershell
  $exe = "C:\LumiScanAnnotationWeb\lumiscan-annotation-server.exe"
  $action = New-ScheduledTaskAction -Execute $exe -Argument "--config C:\LumiScanAnnotationWeb\config\annotation-server.json" -WorkingDirectory "C:\LumiScanAnnotationWeb"
  $trigger = New-ScheduledTaskTrigger -AtStartup
  $settings = New-ScheduledTaskSettingsSet -RestartCount 999 -RestartInterval (New-TimeSpan -Minutes 1) -ExecutionTimeLimit ([TimeSpan]::Zero)
  Register-ScheduledTask -TaskName "LumiScan Annotation Web" -Action $action -Trigger $trigger -Settings $settings -User "SYSTEM" -RunLevel Highest
  ```

  Das Konto muss die Projektordner lesen und schreiben können; für Netzwerkfreigaben verwenden Sie statt `SYSTEM` ein Dienstkonto der Domäne.

## Befehlszeilenoptionen

Optionen auf der Befehlszeile haben Vorrang vor der Konfigurationsdatei.

|   |   |
| --- | --- |
| `--config <Datei>` | die Konfigurationsdatei (JSON) |
| `--data-root <Ordner>` | ein Bildordner, wird zum Projekt `default` |
| `--bind <Adresse>`, `--port <Port>` | Adresse (Standard `0.0.0.0`) und Port (Standard `8080`) |
| `--https <Modus>` | `auto`, `on` oder `off`, siehe [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https) |
| `--web-root <Ordner>` | die Webseiten (Standard: `www` neben dem Programm) |
| `--log-dir <Ordner>` | rotierende Protokolldateien dorthin schreiben |
| `--database <Datei>` | die Datenbank (Standard: `annotation-server.db` neben der Konfiguration); nur lokale Festplatte |
| `--backup <Datei>` | eine Sicherung schreiben und beenden; geht auch, während der Server läuft |
| `--restore <Datei>` | eine Sicherung wiederherstellen und beenden; der Server muss gestoppt sein (`--force` überspringt die Prüfung) |
| `--reset-password <Benutzer>` | einem lokalen Benutzer ein neues zufälliges Passwort geben, ausgeben und beenden |
| `--version`, `--help` | Version, Liste der Optionen |

## Aktualisieren

1. Stoppen Sie den Server. Optional, aber empfohlen: vorher eine Sicherung erstellen (`--backup`, siehe [Sicherung und Wiederherstellung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html)).
2. Ersetzen Sie das Programm und den Ordner `www`. Konfiguration und Datenbank bleiben.
3. Starten Sie den Server. Er aktualisiert seine Datenbank bei Bedarf selbst.
4. Die Benutzer laden die Seite im Browser neu.

# Einzelplatz-Installation – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/single-pc-installation.html

Für eine Person an einem PC, z. B. einen Laptop an der Produktionslinie, einen PC ohne Netzwerk oder einen Test, läuft LumiScan Annotation Web nur auf diesem PC. Es ist dasselbe Programm wie auf einem Server, in einem eigenen Fenster und ohne Anmeldung.

![LumiScan Annotation in einem eigenen Fenster auf einem Einzelplatz: keine Anmeldung, das Benutzermenü nennt die Einzelplatz-Installation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/single-pc-window.jpg)

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/single-pc-installation.mp4)

## Installieren

1. Starten Sie das Installationsprogramm von LumiScan Annotation Web (`setup.exe`) und folgen Sie ihm. Es installiert nach `C:\Program Files\LumiScan Annotation Web` und legt **LumiScan Annotation Web** im Startmenü und auf dem Desktop an. Die Visual-C++-Laufzeit wird bei Bedarf mitinstalliert.
2. Starten Sie **LumiScan Annotation Web**. Das Fenster öffnet sich maximiert; es gibt keine Anmeldung.
3. Fügen Sie Ihre Bilder unter Ihrem Namen → **Projekte** → **Neues Projekt** hinzu, mit einem vorhandenen Bildordner oder einem neuen, wie unter [Projekte](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html) beschrieben.

Voraussetzungen: Windows 10 oder 11 (64 Bit) mit der Microsoft-Edge-WebView2-Laufzeit, die zu Windows 11 und aktuellen Windows-10-Installationen gehört. Ohne sie öffnet sich LumiScan Annotation stattdessen im Standardbrowser.

## Arbeiten

Alles funktioniert wie auf einem Server, mit diesen Unterschieden:

- Es gibt keine Anmeldung. Sie sind das lokale Konto, benannt nach Ihrem Windows-Benutzer, und haben alle Rollen: Annotator, Prüfer und Admin.
- Das Benutzermenü zeigt **Einzelplatz-Installation, ohne Anmeldung**; es gibt kein **Abmelden**, **Passwort ändern** oder **Benutzer und Anmeldung**.
- Schließen des Fensters mit ungespeicherten Änderungen fragt zuerst: **Speichern**, **Verwerfen** oder **Abbrechen**. Schließen beendet LumiScan Annotation.
- Ein zweiter Start holt das offene Fenster nach vorn.
- Nur dieser PC erreicht es (127.0.0.1). Andere PCs können es nicht öffnen, auch nicht im selben Netzwerk.

## Datenordner

Alles, was das Programm schreibt, liegt in Ihrem Benutzerprofil:

```none
%LOCALAPPDATA%\HD Vision Systems\LumiScan Annotation Web\
    config.json      Konfiguration (beim ersten Start angelegt)
    networks\        trainierte Netze für Rahmenvorschläge
    projects\        hier angelegte Projekte (hinzugefügte Bilder, Annotationsdateien)
    backups\         automatische Sicherungen
    logs\            Protokolldateien
```

Bildordner, die Sie als Projekt hinzufügen, bleiben, wo sie sind; ihre Annotationsdateien werden wie auf einem Server neben die Bilder geschrieben.

## Rahmenvorschläge ohne Server {#box-suggestions-without-a-server}

Die Einzelplatz-Installation führt Ihre trainierten Netze selbst aus, ohne Dienst für Rahmenvorschläge:

1. Kopieren Sie den exportierten Netzordner aus LumiScan Training (mit `network.onnx` und `network_description.json`) nach `networks\` im Datenordner, z. B. `networks\line-5-parts\`.
2. Schließen Sie LumiScan Annotation und starten Sie es neu.
3. Wählen Sie in den [Projekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html#box-suggestions) unter **Rahmenvorschläge** das Netz.

**Rahmen vorschlagen** (`P`) und [Rate with network](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#rate-with-network) funktionieren dann wie auf einem Server. Die Netze laufen auf dem Prozessor; wie lange ein Bild dauert, hängt von Netz und PC ab.

## Lizenz

Je nach Lizenz braucht LumiScan Annotation den **LumiScan Key** (einen CodeMeter-USB-Schlüssel) an diesem PC. Ohne gültige Lizenz sagt die Anwendung das und nimmt keine Änderungen an, bis der Schlüssel wieder steckt.

## Updates

Einmal täglich schaut LumiScan Annotation auf docs.hdvisionsystems.com nach, ob eine neuere Version erschienen ist. Wenn ja, erscheint **Version … verfügbar** in der oberen Leiste; der Hinweis führt zu den Versionshinweisen. Es wird nichts von selbst heruntergeladen oder installiert: Installieren Sie das neue Setup über das alte, Ihre Daten bleiben erhalten.

Zum Abschalten setzen Sie `"update_check": false` in `config.json`.

## Ohne Fenster

`Start LumiScan Annotation.cmd` im Installationsordner startet LumiScan Annotation im Hintergrund und öffnet es im Standardbrowser; `Stop LumiScan Annotation.cmd` beendet es.

# Konfiguration – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html

Der Server liest eine JSON-Datei, angegeben mit `--config`. Ein Beispiel mit allen Abschnitten liegt in `config\annotation-server.example.json`. Relative Pfade beziehen sich auf den Ordner der Konfigurationsdatei. Geheimnisse (Passwörter, Schlüssel) können in eigenen Dateien liegen, die nur das Dienstkonto lesen darf: Verwenden Sie dafür die Schlüssel mit der Endung `_file`.

## Beispiel

```json
{
  "bind": "0.0.0.0",
  "port": 8080,
  "public_url": "https://annotation.example.com",
  "projects_root": "../projects",
  "project_folders": ["D:/LumiScan"],
  "data_root": "D:/LumiScan/annotation-data",
  "database": "annotation-server.db",
  "web_root": "../www",
  "log_dir": "../logs",
  "backup": { "dir": "../backups", "every_hours": 24, "keep": 14 },
  "pre_annotation": [
    { "url": "http://gpu-server:8090", "token_file": "preannotate.token" }
  ],
  "auth": {
    "local_login": true,
    "default_role": "annotator",
    "ldap": { "enabled": false },
    "oidc": { "enabled": false }
  }
}
```

## Schlüssel

| Schlüssel | Bedeutung |
| --- | --- |
| `bind`, `port` | Adresse (Standard `0.0.0.0`, alle Netzwerkschnittstellen) und Port (Standard `8080`). |
| `public_url` | Die Adresse, die die Benutzer öffnen, z. B. `https://annotation.example.com`. Nötig hinter einem Reverse Proxy und für Single Sign-on (Rücksprungadresse). |
| `https` | `auto` (Standard), `on` oder `off`. Siehe [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https). |
| `tls_cert`, `tls_key` | Zertifikat und privater Schlüssel (PEM) für HTTPS. Ohne sie verwendet der Server ein selbstsigniertes Zertifikat. Siehe [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https). |
| `tls_names` | Optionale Liste: weitere Hostnamen oder IP-Adressen für das selbstsignierte Zertifikat. |
| `web_root` | Die Webseiten. Standard: `www` neben dem Programm. |
| `data_root` | Optional: ein Bildordner, der zum Projekt `default` wird, offen für alle Benutzer. So laufen bestehende Installationen der Version 2.0 unverändert weiter. |
| `projects_root` | Ordner für neue und importierte Projekte. Standard: `projects` neben der Konfiguration. |
| `project_folders` | Optionale Liste: Admins dürfen Projekte auf vorhandenen Ordnern nur unterhalb dieser anlegen. |
| `s3_targets` | Optionale Liste von S3-Buckets für Projekte, siehe [Projekte in S3-Buckets](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html). |
| `pre_annotation` | Optional: ein Dienst für Rahmenvorschläge oder eine Liste davon, je mit `url`, `token_file` (oder `token`), `timeout_s`, `enabled`. Siehe [Dienst für Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html). Ein Eintrag `{"type": "onnx", "networks": "networks"}` führt stattdessen die Netze in diesem Ordner im Server aus (Programmversionen mit eingebauten Netzen wie die [Einzelplatz-Installation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/single-pc-installation.html)). |
| `update_check` | `true`: Einmal täglich fragt der Server docs.hdvisionsystems.com nach der aktuellen Version und zeigt Projekt-Admins **Version … verfügbar**. Es wird nichts heruntergeladen. Standard: aus; an in der Einzelplatz-Installation. |
| `database` | Die Datenbank: Konten, Sitzungen, Projekte, Verlauf, Hinweise. Standard: `annotation-server.db` neben der Konfiguration. **Nur lokale Festplatte**, nie auf einer Netzwerkfreigabe. |
| `index_refresh_seconds` | Wie oft die Projektordner nach Änderungen außerhalb der Web-App durchsucht werden. Standard 60. |
| `upload_max_mb` | Größte Bilddatei, die Projekt-Admins [im Browser hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html) dürfen, in MB. Standard 2048. |
| `translations_dir` | Ordner mit Ihren eigenen Übersetzungstabellen der Oberfläche; sie haben Vorrang vor den mitinstallierten. Standard: `translations` neben der Konfiguration. Siehe [Sprachen und Übersetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/languages-and-translations.html). |
| `lock_lease_seconds` | Wie lange eine Bearbeitungssperre ohne Erneuerung gilt. Standard 60; der Browser erneuert sie, solange das Bild offen ist. |
| `log_dir` | Ordner für rotierende Protokolldateien. Ohne ihn geht das Protokoll nur auf die Konsole. |
| `backup.dir`, `backup.every_hours`, `backup.keep` | Automatische Sicherungen: Ordner (Standard `backups` neben der Konfiguration), Abstand in Stunden (Standard 24), Anzahl der aufbewahrten (Standard 14). Siehe [Sicherung und Wiederherstellung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html). |
| `auth` | Anmeldeverfahren und Sitzungen, siehe [Anmeldeverfahren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/sign-in-methods.html). |
| `license` | Für den LumiScan Key vorbereitet; in dieser Version nicht verwendet. |

## HTTPS {#https}

Der Server spricht standardmäßig HTTPS, Passwörter und Sitzungs-Cookies laufen also nie unverschlüsselt. Die Benutzer öffnen `https://<Server>:<Port>/`, z. B. `https://annotation-pc:8080/`. Der Port spricht entweder HTTPS oder HTTP: Eine Adresse mit `http://` bekommt keine Antwort.

- **Selbstsigniertes Zertifikat (Standard):** Ohne `tls_cert` und `tls_key` erzeugt der Server beim ersten Start ein Zertifikat und legt es im Ordner `tls` neben der Konfiguration ab (`self-signed-cert.pem`, `self-signed-key.pem`). Einzurichten ist nichts.
  - Das Zertifikat nennt den Hostnamen des Rechners, `localhost`, die Netzwerkadressen des Rechners, den Host aus `public_url` und die Einträge von `tls_names`. Tragen Sie in `tls_names` jeden weiteren Namen oder jede IP-Adresse ein, die Benutzer eingeben, z. B. einen DNS-Alias.
  - Es gilt 825 Tage. Der Server erneuert es 30 Tage vor dem Ablauf, auch im laufenden Betrieb, und wenn ein Name aus `public_url` oder `tls_names` darin fehlt.
  - Browser zeigen eine Warnung wie „Dies ist keine sichere Verbindung", bis sie dem Zertifikat vertrauen. Vergleichen Sie den SHA-256-Fingerabdruck in den Zertifikatsdetails der Warnung mit dem, den das Serverprotokoll beim Start zeigt (`HTTPS: SHA-256 fingerprint …`), und fahren Sie dann fort. Um die Warnung zu vermeiden, importieren Sie `self-signed-cert.pem` auf den Clients als vertrauenswürdiges Zertifikat (Windows: **Vertrauenswürdige Stammzertifizierungsstellen**, macOS: Schlüsselbund, **Immer vertrauen**), oder verwenden Sie ein Zertifikat der Zertifizierungsstelle Ihres Unternehmens.
  - Sichern Sie den Ordner `tls` mit der Konfiguration (die automatischen Sicherungen enthalten ihn). Ein neues Zertifikat bedeutet eine neue Warnung auf jedem Client.

- **Eigenes Zertifikat:** Setzen Sie `tls_cert` und `tls_key` auf die PEM-Dateien eines Zertifikats der Zertifizierungsstelle Ihres Unternehmens oder einer öffentlichen Zertifizierungsstelle (das Zertifikat mit seinen Zwischenzertifikaten) und seines Schlüssels. Der Server prüft beim Start, ob beide zusammengehören, und warnt 30 Tage vor dem Ablauf des Zertifikats. Starten Sie den Server nach dem Austausch der Dateien neu.
  ```json
    "tls_cert": "tls/annotation.pem",
    "tls_key": "tls/annotation.key",
  ```

- **Hinter einem Reverse Proxy (nginx, IIS, Apache):** Der Proxy beendet TLS und leitet an den Server auf demselben Rechner weiter, z. B. auf `127.0.0.1:8080`. Mit `"bind": "127.0.0.1"` bleibt der Server von selbst bei unverschlüsseltem HTTP (`"https": "auto"`); andernfalls setzen Sie `"https": "off"`. Setzen Sie `public_url` auf die Adresse, die die Benutzer öffnen. Der Proxy sollte den Header `X-Forwarded-Proto: https` senden, damit das Sitzungs-Cookie als sicher markiert wird.
  ```nginx
  server {
      listen 443 ssl;
      server_name annotation.example.com;
      ssl_certificate     /etc/ssl/annotation.pem;
      ssl_certificate_key /etc/ssl/annotation.key;
      client_max_body_size 64m;
      location / {
          proxy_pass http://127.0.0.1:8080;
          proxy_set_header Host $host;
          proxy_set_header X-Forwarded-Proto https;
          proxy_read_timeout 600s;
      }
  }
  ```

  `client_max_body_size` muss die 8-MB-Stücke eines Projektimports zulassen.

## Sitzungen und Sicherheit

- Die Anmeldung erzeugt ein Sitzungs-Cookie (HttpOnly, SameSite=Lax, Secure über HTTPS). Eine Sitzung endet nach `auth.session_hours` ohne Aktivität (Standard 12) und spätestens nach `auth.max_session_days` (Standard 7).
- Nach 5 fehlgeschlagenen Anmeldungen ist ein Konto für 15 Minuten gesperrt (30 Fehlversuche je Netzwerkadresse).
- Deaktivieren eines Benutzers oder Zurücksetzen seines Passworts beendet seine Sitzungen sofort.
- Jede ändernde Anfrage braucht den Header `X-Requested-With: lsa`; das schützt vor seitenübergreifenden Anfragen.

# Anmeldeverfahren – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/sign-in-methods.html

Alle melden sich an; der Name im Speicherverlauf jedes Bildes ist der angemeldete Benutzer. Drei Verfahren lassen sich kombinieren. Sie und ihre Geheimnisse werden nur in der Konfigurationsdatei des Servers eingestellt (Abschnitt `auth`), nie im Browser.

![Anmeldekarte mit der Schaltfläche Mit Company SSO anmelden, den Feldern Benutzername und Passwort für das Firmenkonto und der Sprachauswahl unten](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/login-card.png)

## Lokale Konten

`"local_login": true` (Standard). Admins legen lokale Konten im Browser an (siehe [Benutzer und Rollen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html)). Passwörter haben mindestens 10 Zeichen und werden als PBKDF2-SHA256-Hashes mit 600 000 Runden gespeichert.

> [!TIP]
> Behalten Sie mindestens einen lokalen Administrator, auch mit Verzeichnis oder Single Sign-on. Er ist Ihr Zugang, wenn das Verzeichnis nicht erreichbar ist.

## Active Directory / LDAP

Der Server sucht den Benutzer mit einem Dienstkonto mit Lesezugriff, prüft das Passwort mit einer Anmeldung als dieser Benutzer und liest die Gruppen. Die Benutzer melden sich mit demselben Namen und Passwort an wie an ihrem Arbeitsplatzrechner.

```json
"ldap": {
  "enabled": true,
  "label": "company account",
  "url": "ldaps://dc01.ad.example.com:636",
  "ca_file": "company-root-ca.pem",
  "bind_dn": "CN=ldap-bind,OU=Service Accounts,DC=ad,DC=example,DC=com",
  "bind_password_file": "ldap-bind.secret",
  "base_dn": "DC=ad,DC=example,DC=com",
  "user_filter": "(&(objectClass=user)(sAMAccountName={username})(!(userAccountControl:1.2.840.113556.1.4.803:=2)))",
  "group_attribute": "memberOf",
  "group_filter": "(&(objectClass=group)(member:1.2.840.113556.1.4.1941:={dn}))"
}
```

|   |   |
| --- | --- |
| `url` | `ldaps://host:636` (empfohlen) oder `ldap://host:389` mit `"start_tls": true`. Das Zertifikat wird gegen `ca_file` oder den Zertifikatspeicher des Systems geprüft. |
| `bind_dn`, `bind_password_file` | Das Dienstkonto mit Lesezugriff. Leer: anonyme Suche. |
| `base_dn`, `user_filter` | Wo und wie Benutzer gesucht werden; `{username}` wird durch den eingegebenen Namen ersetzt. Das Beispiel überspringt deaktivierte Konten. |
| `group_attribute` | Gruppen am Benutzereintrag (`memberOf` im Active Directory). |
| `group_filter`, `group_base_dn` | Optionale Gruppensuche; das Beispiel findet verschachtelte Gruppen im Active Directory. `{dn}` und `{username}` werden ersetzt. |
| `username_attribute`, `display_name_attribute`, `email_attribute` | Standard `sAMAccountName`, `displayName`, `mail`. |
| `label` | Name auf der Anmeldeseite. |
| `timeout_s` | Standard 10. |

Eine zusätzliche Bibliothek ist nicht nötig: Der LDAP-Client ist Teil des Servers.

## Single Sign-on (OpenID Connect)

Die Benutzer klicken auf **Mit … anmelden** und melden sich beim Identitätsanbieter des Unternehmens an (Authorization Code Flow mit PKCE). Abmelden beendet auch die Sitzung beim Anbieter.

1. Registrieren Sie beim Anbieter einen **vertraulichen Client** mit der Rücksprungadresse `<public_url>/api/auth/oidc/callback`.
2. Konfigurieren Sie ihn:
   ```json
   "oidc": {
     "enabled": true,
     "label": "Company SSO",
     "issuer": "https://sso.example.com/realms/example",
     "client_id": "lumiscan-annotation",
     "client_secret_file": "oidc-client.secret",
     "scopes": "openid profile email",
     "username_claim": "preferred_username",
     "groups_claim": "groups"
   }
   ```
3. Setzen Sie `public_url` (siehe [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html)).
   - **Keycloak:** Client mit **Client authentication** an, **Valid redirect URI** wie oben, **Valid post logout redirect URI** `<public_url>/` und einem Mapper \*Group Membership mit dem Claim-Namen `groups`. Alternativ Client-Rollen: `"groups_claim": "resource_access.lumiscan-annotation.roles"`.
   - **Microsoft Entra ID:** Issuer `https://login.microsoftonline.com/<Tenant>/v2.0`; `"groups_claim": "groups"` (Objekt-IDs der Gruppen) oder App-Rollen mit `"roles"`.

## Wer welche Rolle bekommt

- Neue Verzeichnis- und Single-Sign-on-Benutzer erhalten `default_role` (Standard `annotator`; leer: keine Rolle, bis ein Admin oder eine Gruppenzuordnung eine vergibt).
- In `initial_admins` aufgeführte Namen werden bei ihrer ersten Anmeldung Admins.
- **Gruppen → Rollen** im Browser vergibt Rollen an ganze Gruppen; sie werden bei jeder Anmeldung aktualisiert. Siehe [Gruppen und Rollen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html#groups).
- Benutzer ohne jede Rolle können sich nicht anmelden; sie werden gebeten, einen Administrator zu fragen, und den Admins aufgelistet.

Unter Ihrem Namen → **Benutzer und Anmeldung** → **Anmeldeverfahren** sehen Admins, was konfiguriert ist, die beim Anbieter einzutragende Rücksprungadresse und können eine Verzeichnisanmeldung testen:

![Reiter Anmeldeverfahren: lokale Konten, Verzeichniseinstellungen mit einem Formular zum Testen einer Verzeichnisanmeldung, Single-Sign-on-Einstellungen mit der Redirect URI](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/sign-in-methods.png)

# Dienst für Rahmenvorschläge – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html

Der Dienst für Rahmenvorschläge schlägt Rahmen für das offene Bild vor (siehe [Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestions.html)). Er läuft auf einem Ihrer Rechner, am besten mit GPU; kein Bild verlässt das Firmennetz. Er ist ein eigenes Programm, der Annotationsserver selbst braucht also keine GPU.

## Backends

| Backend | Was vorschlägt | Braucht |
| --- | --- | --- |
| `onnx` (Standard) | **Ihre trainierten LumiScan-Netze**: `network.onnx` + `network_description.json`, wie LumiScan Training sie exportiert | ONNX Runtime (CPU, CUDA oder DirectML) |
| `grounded-sam` | Ein Detektor mit offenem Vokabular (Grounding DINO) findet die mit den Labels benannten Objekte; SAM 2 schneidet jedes aus. Für Teile ohne Netz. | PyTorch; GPU empfohlen; etwa 1 GB Modelle, beim ersten Start heruntergeladen |
| `threshold` | Klassische Bildverarbeitung: helle Teile auf dunklem Grund | nichts weiter |

Der Dienst liefert Umrisse; der Annotationsserver legt um jeden Umriss den kleinsten gedrehten Rahmen.

## Installieren

Der Dienst und seine Installationsskripte liegen im Ordner `preannotate` von LumiScan Annotation Web; fragen Sie HD Vision Systems danach, falls er nicht zu Ihrer Lieferung gehört. Kopieren Sie den Ordner auf den Rechner, der den Dienst betreiben soll. Die Skripte in `preannotate/install` richten Python, die Pakete für das Backend, ein Zugriffstoken und den Start beim Hochfahren ein und geben am Ende die Zeile für die Serverkonfiguration aus.

| System | Befehl | Läuft als |
| --- | --- | --- |
| Ubuntu 24.04 | `sudo preannotate/install/install-ubuntu.sh --gpu cuda11` | systemd-Dienst `lsa-preannotate` |
| Windows 11 | `preannotate\install\install-windows.ps1 -Gpu cuda11` in einer PowerShell als Administrator; braucht Python 3.12 (`winget install Python.Python.3.12`) | geplante Aufgabe „LumiScan PreAnnotate" beim Start, als SYSTEM |
| macOS | `preannotate/install/install-macos.sh` | Launch Agent des Benutzers |

Optionen (unter Windows mit einem Bindestrich und großem Anfangsbuchstaben, z. B. `-Backend`):

|   |   |
| --- | --- |
| `--backend onnx\|grounded-sam\|threshold` | das Backend (Standard `onnx`) |
| `--gpu cpu\|cuda\|cuda11` | `cuda` für CUDA 12, `cuda11` für CUDA 11.8 mit cuDNN 8 (wie auf LumiScan-PCs), `cpu` ohne GPU; unter Windows außerdem `directml` für jede DirectX-12-GPU |
| `--port`, `--host` | Adresse des Dienstes (Standard-Port 8090) |
| `--instance <Name>` | ein zweiter Dienst auf demselben Rechner, z. B. Grounding DINO neben den Netzen |
| `--dry-run` | jeden Schritt ausgeben, ohne ihn auszuführen |
| `--uninstall` | den Dienst entfernen; Programm und Netze bleiben |

Beispiel: Netze auf einer NVIDIA-GPU, dazu Grounding DINO als zweiter Dienst:

```bash
sudo preannotate/install/install-ubuntu.sh --gpu cuda11
sudo preannotate/install/install-ubuntu.sh --backend grounded-sam --gpu cuda11 --instance dino --port 8091
```

## Netze hinzufügen

Kopieren Sie jeden Netzordner, wie LumiScan Training ihn exportiert, in den Netzordner des Dienstes, einen Ordner je Netz. Der Ordnername ist der Name des Netzes.

```none
networks/
  line-5-parts/      network.onnx  network_description.json
  housing-seams/     network.onnx  network_description.json
```

Netzordner:

- Ubuntu: `/var/lib/lsa-preannotate/networks`
- Windows: `C:\ProgramData\LumiScan\PreAnnotate\networks`
- macOS: `~/Library/Application Support/LumiScan/PreAnnotate/networks`

Starten Sie den Dienst danach neu (Ubuntu: `sudo systemctl restart lsa-preannotate`; Windows: `Restart-ScheduledTask "LumiScan PreAnnotate"`).

Der Dienst bereitet die Bilder genau wie LumiScan Training auf (Größe, Farbreihenfolge, Normierung aus `network_description.json`) und wandelt die Ausgabe des Netzes in gedrehte Rahmen um. Die Klassennamen stammen aus `classList`; vorgeschlagen werden nur Klassen, die Labels des Projekts sind. Für Netze, die mit BGR-Bildern trainiert wurden, starten Sie den Dienst mit `--bgr`.

## Annotationsserver anbinden

Tragen Sie den Dienst, oder mehrere, in die Serverkonfiguration ein und starten Sie den Server neu. Kopieren Sie die vom Installationsskript erzeugte Tokendatei neben die Konfiguration.

```json
"pre_annotation": [
  { "url": "http://gpu-server:8090", "token_file": "preannotate.token" },
  { "url": "http://gpu-server:8091", "token_file": "preannotate-dino.token" }
]
```

- Bei mehreren Diensten werden alle gefragt; von überlappenden Vorschlägen bleibt der sicherste.
- Antwortet einer nicht, schlagen die anderen trotzdem vor, und der Browser zeigt eine Warnung.
- Das Serverprotokoll nennt beim Start jeden Dienst mit Backend und Netzen.

Die Schaltfläche **Rahmen vorschlagen** erscheint im Browser, sobald ein Dienst konfiguriert ist. Das Netz jedes Projekts wird in seinen [Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html#box-suggestions) gewählt.

## Dienst prüfen {#checking-the-service}

```bash
curl -H "Authorization: Bearer $(sudo cat /etc/lsa-preannotate/default.token)" http://127.0.0.1:8090/v1/health
```

Die Antwort nennt Backend, Gerät und die Netze mit ihren Klassen. Protokolle: Ubuntu `journalctl -u lsa-preannotate -f`; Windows `C:\ProgramData\LumiScan\PreAnnotate\default.log`.

# Projekte in S3-Buckets – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html

Statt in einem Ordner auf dem Server kann ein Projekt seine Dateien in einem S3-Bucket ablegen: AWS S3, MinIO, SeaweedFS oder jeder andere Speicher mit S3-Schnittstelle. Unterhalb des Präfixes des Projekts ist der Aufbau genau der eines Projektordners (Datumsordner, `<Bild>.png`, `.csv`, `.json`). Ein Ordner lässt sich also mit jedem S3-Werkzeug (`aws s3 sync`, `mc mirror`, …) in einen Bucket kopieren und zurück, und LumiScan Training liest dieselben Dateien.

## 1. Buckets konfigurieren

Der Server-Admin trägt die Buckets in die Konfiguration ein. Die Zugangsschlüssel bleiben in der Konfiguration; der Browser sieht nur den Namen.

```json
"s3_targets": [
  { "name": "aws-frankfurt", "endpoint": "https://s3.eu-central-1.amazonaws.com",
    "region": "eu-central-1", "bucket": "annotation-data", "path_style": false,
    "access_key_id": "AKIA...", "secret_access_key_file": "aws-annotation.secret" },
  { "name": "seaweedfs-lab", "endpoint": "https://s3.lab.example.com:8333", "bucket": "annotation",
    "path_style": true, "access_key_id": "annotation-server",
    "secret_access_key_file": "seaweedfs-annotation.secret", "ca_file": "root-ca.pem" }
]
```

| Schlüssel | Bedeutung |
| --- | --- |
| `name` | Wird Admins beim Anlegen eines Projekts angezeigt; Projekte verweisen darauf. Später nicht umbenennen. |
| `endpoint` | `https://s3.<Region>.amazonaws.com` (AWS), `http(s)://host:9000` (MinIO), `http(s)://host:8333` (SeaweedFS) |
| `region` | Die Region des Buckets bei AWS, z. B. `eu-central-1`; MinIO und SeaweedFS akzeptieren `us-east-1`. |
| `bucket` | Der Bucket; er muss existieren. |
| `path_style` | `true`: `endpoint/bucket/key` (MinIO, SeaweedFS; Standard). `false`: `bucket.endpoint/key` (AWS; nötig für Buckets in neueren Regionen). |
| `access_key_id`, `secret_access_key_file` | Die Schlüssel. `secret_access_key` direkt in der Datei geht auch, eine eigene, nur für das Dienstkonto lesbare Datei ist besser. Ohne Schlüssel werden `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` und `AWS_SESSION_TOKEN` aus der Umgebung verwendet. |
| `ca_file`, `tls_verify` | Eigene Zertifizierungsstelle für selbst signierte Zertifikate; `"tls_verify": false` nur für Tests. |
| `proxy` | `http://proxy:3128`, wenn der Server den Speicher nur über einen Proxy erreicht. |
| `cache_mb`, `cache_dir` | Lokaler Bildzwischenspeicher, Standard 2048 MB in `s3-cache/<Name>` neben der Konfiguration; `0` schaltet ihn ab. |
| `timeout_s` | Je Anfrage, Standard 30. |

## 2. Projekt in einem Bucket anlegen

Unter Ihrem Namen → **Projekte** → **Neues Projekt** (oder **Projekt importieren**) wählen Sie **Dateien speichern in: S3-Bucket …** und geben einen Ordner im Bucket an (das Präfix, z. B. `line-5`). Ein Bucket nimmt beliebig viele Projekte auf; die Präfixe zweier Projekte dürfen sich nicht überschneiden. Bilder, die schon unter dem Präfix liegen, werden verwendet, wie sie sind; ein Import braucht ein leeres Präfix.

## Verhalten

- Annotationsdateien werden immer aus dem Bucket gelesen und dorthin geschrieben, nie zwischengespeichert. Wurde eine Datei inzwischen im Bucket geändert (durch ein S3-Werkzeug oder einen anderen Server), wird das Speichern wie bei einem Ordner mit einem Konflikt abgelehnt, und die fremde Version bleibt im Verlauf.
- Bilder werden auf der Festplatte des Servers zwischengespeichert und bei jeder Anfrage mit dem Bucket abgeglichen: Geänderte Bilder werden neu geholt, unveränderte kosten eine kleine Anfrage.
- Datenbank, Sperren, Sitzungen und Sicherungen bleiben auf dem Server. Das Löschen eines Bucket-Projekts löscht nie etwas im Bucket.
- Fehlgeschlagene Anfragen (Netzwerk, `503 SlowDown`) werden wiederholt; Fehler werden mit dem Grund gemeldet, den S3 angibt (falscher Schlüssel, Uhrzeitabweichung, fehlender Bucket, falsche Region).

## Rechte bei AWS {#aws-permissions}

Der IAM-Benutzer oder die Rolle braucht:

- auf dem Bucket: `s3:ListBucket`,
- auf `arn:aws:s3:::<Bucket>/*`: `s3:GetObject`, `s3:PutObject`, `s3:DeleteObject`.

Ohne `s3:ListBucket` beantwortet AWS fehlende Dateien mit 403 statt 404. Halten Sie die Uhr des Servers synchron: AWS lehnt Anfragen ab, die mehr als 15 Minuten abweichen.

## MinIO oder SeaweedFS?

Beide funktionieren für LumiScan Annotation Web gleich. Der Hersteller von MinIO veröffentlicht die Community-Edition seit Oktober 2025 nicht mehr als fertige Programme; bestehende Installationen laufen weiter. Für einen neuen selbst betriebenen Speicher ist SeaweedFS (Apache 2.0, aktiv gepflegt) die sicherere Wahl.

# Benutzeroberfläche – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/user-interface.html

Nach der Anmeldung zeigt der Browser das offene Projekt mit seiner Bildliste links, dem Bild in der Mitte und den Bereichen rechts. Die Oberfläche ist englisch; die Namen der Bedienelemente stehen hier so, wie sie auf dem Bildschirm erscheinen.

![Das Fenster von LumiScan Annotation mit nummerierten Markierungen: Projektauswahl, Bildliste, Bildbereich, Werkzeugleiste, Überarbeitungshinweise, Labels, ausgewählter Rahmen, Benutzermenü, Hinweise für Sie und Logo](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/workspace-callouts.jpg)

**Tabelle 1. Elemente der Benutzeroberfläche**

| Nr. | Element | Beschreibung |
| --- | --- | --- |
| 1 | Projekt und Ordner | **Projekt**: die Projekte, an denen Sie beteiligt sind (bei nur einem ausgeblendet). **Ordner**: die Unterordner des Projekts, meist einer je Tag. Daneben: das offene Bild und seine Position im Ordner. |
| 2 | Bildliste | Alle Bilder des Ordners. Gefüllter Punkt: Das Bild hat Rahmen; hohler Punkt: noch nicht. Ein Name in Rot: Diese Person bearbeitet das Bild gerade. ✎ mit Zahl: offene Überarbeitungshinweise. ✓: [als fertig markiert](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#marking-images-as-done); VAL / TEST: Das Bild liegt in der Validierungs- oder Testmenge des Exports. Über der Liste: **+ Bilder hinzufügen** (Projekt-Admins, siehe [Bilder hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html)), Suche nach Dateinamen, **Anzeigen**, **Label**, **Menge** und **Sortieren** sowie **Mit Netz bewerten**, siehe [Bilder finden und sortieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html). |
| 3 | Bildbereich | Das offene Bild mit seinen Rahmen. Die grüne Kante ist die Unterkante jedes Rahmens, das Label steht daneben. Der ausgewählte Rahmen ist gelb mit vier Eckgriffen. Mausrad: zoomen; leere Fläche ziehen: Bild verschieben. |
| 4 | Werkzeugleiste | **Zurück** / **Weiter** (voriges / nächstes Bild), Rückgängig ↶ und Wiederherstellen ↷, **Neuer Rahmen** mit dem Schalter für die Zeichenart ([Mittellinien-](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-line-rectangle) oder [Kanten-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#edge-rectangle)), Zoom − / + mit der aktuellen Vergrößerung, **1:1** (ein Bildschirmpixel je Bildpixel), **Einpassen** und die Mausposition in Bildpixeln. Darunter **Kopieren ▾** ([Rahmen kopieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html)), **Als fertig markieren** (`Shift+D`: markieren und weiter), **Speichern und aufs nächste kopieren** und **Speichern**. |
| 5 | Überarbeitungshinweise | Anweisungen zu diesem Bild, siehe [Überarbeitungshinweise](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/revision-notes.html). **Hinweis hinzufügen** hinterlässt einen. |
| 6 | Labels | Die Labels des Projekts; die Zahl ist die Taste, die es setzt. Ein Klick auf ein Label setzt es für den ausgewählten Rahmen und neue Rahmen. **Hinzufügen** fügt der gemeinsamen Liste ein Label hinzu. ▭: Das Label hat eine [Rahmenvorlage](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html#box-templates); **…-Vorlage setzen** (`T`) setzt sie. |
| 7 | Ausgewählter Rahmen | Mittelpunkt, Breite, Höhe (in Pixeln) und Winkel (in Grad) des ausgewählten Rahmens, editierbar, und die Schaltflächen **Unterkante**, die die 0°-Seite drehen; **Als Vorlage speichern** (Projekt-Admins). Darunter **Rahmen vorschlagen**, wenn ein Dienst für Rahmenvorschläge konfiguriert ist. Weiter unten: **Ansicht** (Helligkeit, Kontrast, Labels zeigen, Mittellinien zeigen, Lupe) und **Verlauf**. |
| 8 | Benutzermenü | Ihr Name und Ihre Rollen; **Passwort ändern** (lokale Konten), **Projekte** und **Benutzer und Anmeldung** (Admins), **Sprache** (siehe [Sprachen und Übersetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/languages-and-translations.html)), **Abmelden**. |
| 9 | Hinweise für Sie | Anzahl der offenen Überarbeitungshinweise an Sie in diesem Projekt. Ein Klick öffnet den nächsten. |
| 10 | Logo | Bleibt unten an der Bildliste stehen; nur die Liste scrollt. |

Je nach Rolle und Projekt zeigt die obere Leiste außerdem:

- **Annotieren** / **Prüfen**: Wechsel zwischen der eigenen Annotation und dem Vergleich der Annotatoren (bei mehreren Annotatoren je Bild, wenn Sie beide Rollen haben).
- **Statistik**: Übereinstimmung der Annotatoren (Prüfer).
- **Export**: die annotierten Bilder als LumiScan-Training-Projekt oder im COCO-Format, siehe [Annotationen exportieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html) (Prüfer, Projekt-Admins).
- **Version … verfügbar**: Eine neuere Version ist erschienen (Einzelplatz-Installation, Projekt-Admins).
- **Einstellungen**: Labels, Interessensbereich, mehrere Annotatoren, Rahmenvorschläge (Projekt-Admins).
- **Tasten**: die Liste der Tastenkombinationen.
- Den Status: **Bereit**, **… gespeichert**, Meldungen und Fehler.

![Benutzermenü einer Prüferin mit Name, Benutzername, Kontoart und Rolle sowie den Einträgen Passwort ändern, Meine Projekte, Sprache: Deutsch und Abmelden](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/user-menu.png)

## Kleine Bildschirme

Unterhalb einer Breite von etwa 1000 Pixeln werden die Bereiche untereinander angeordnet: zuerst das Bild, dann die Bereiche, dann die Bildliste.

# Bilder annotieren – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html

## Gedrehte Rahmen

Ein gedrehter Rahmen ist ein Rechteck, das gedreht werden kann. Er hat einen Mittelpunkt, eine Breite, eine Höhe und einen Winkel. Die **grüne Kante ist die Unterkante** des Rahmens: Sie gibt ihm seine Richtung. Ein Winkel von 0° bedeutet, die Oberkante zeigt nach oben; positive Winkel drehen im Uhrzeigersinn.

Die Richtung ist für das Training wichtig: Das Netz lernt, wo die Unterkante eines Objekts liegt. Vereinbaren Sie für jede Objektart eine Regel, z. B. „Unterkante dort, wo das Teil flach aufliegt", und zeichnen Sie alle Rahmen dieser Art gleich. [Ausrichtung der Rahmen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-orientation.html) zeigt mit Beispielen, warum das wichtig ist.

## Einen Rahmen zeichnen

Es gibt zwei Arten, einen Rahmen zu zeichnen, jeweils mit drei Klicks. Der Schalter neben **Neuer Rahmen** zeigt, welche verwendet wird:

![Die Schaltfläche Neuer Rahmen mit dem Schalter für die Zeichenart daneben: links Mittellinien-Rechteck, rechts Kanten-Rechteck, ausgewählt](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-modes.png)

- `N` beginnt ein [Mittellinien-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-line-rectangle), `E` ein [Kanten-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#edge-rectangle). Ein Klick auf eine Seite des Schalters tut dasselbe.
- **Neuer Rahmen** und ein Doppelklick ins Bild beginnen einen Rahmen in der zuletzt verwendeten Art. Der Browser merkt sie sich für Ihr Konto.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/drawing-a-box.mp4)

### Mittellinien-Rechteck {#center-line-rectangle}

In der Oberfläche *center-line rectangle*: zuerst die Mittellinie des Rahmens, von der Mitte seiner Unterkante zur Mitte seiner Oberkante, dann die Breite, die sich gleichmäßig nach beiden Seiten dieser Linie verteilt. Das sind die Klicks des Desktop-Werkzeugs:

1. Drücken Sie `N` und klicken Sie, wo die **Unterkante** des Objekts liegt, oder doppelklicken Sie dort.
2. Klicken Sie, wo die **Oberkante** des Objekts liegt: Das zeichnet die Mittellinie und legt Höhe und Winkel fest.
3. Bewegen Sie die Maus seitlich und klicken Sie: Das legt die Breite fest, gleich auf beiden Seiten der Mittellinie.

|   |   |   |
| --- | --- | --- |
| ![Nach dem ersten Klick folgt die Mittellinie als gestrichelte Linie der Maus von der Unterkante zur Oberkante des Halters](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-1.png) | ![Nach dem zweiten Klick folgt der Rahmen der Maus seitlich; die grüne Linie ist die Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-2.png) | ![Nach dem dritten Klick: Der Rahmen ist fertig und ausgewählt](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/draw-3.png) |

### Kanten-Rechteck {#edge-rectangle}

In der Oberfläche *edge rectangle*: zuerst die Unterkante des Rahmens, dann die Höhe, nur nach einer Seite:

1. Drücken Sie `E` und klicken Sie auf ein Ende der **Unterkante** des Objekts, oder doppelklicken Sie dort, wenn zuletzt das Kanten-Rechteck verwendet wurde.
2. Klicken Sie auf das andere Ende der Unterkante: Das legt Breite und Winkel fest.
3. Bewegen Sie die Maus zur **Oberkante** des Objekts und klicken Sie: Das legt die Höhe fest. Die Seite, zu der Sie die Maus bewegen, wird die Oberkante; die Reihenfolge der ersten beiden Klicks spielt also keine Rolle.

|   |   |   |
| --- | --- | --- |
| ![Nach dem ersten Klick folgt die grüne Unterkante der Maus entlang der unteren Seite des Halters](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/edge-1.png) | ![Nach dem zweiten Klick wächst der Rahmen von der Unterkante zur Maus](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/edge-2.png) | ![Nach dem dritten Klick: Der Rahmen ist fertig und ausgewählt](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/edge-3.png) |

### Welche Art wann

- Das **Kanten-Rechteck** ist einfacher, wenn eine Seite des Objekts eine klare, gerade Kante ist, z. B. bei einem flach liegenden Teil, der Kante einer Kiste oder einer Platte, oder wenn im Bild nur eine Seite scharf ist. Sie klicken auf das, was Sie sehen.
- Das **Mittellinien-Rechteck** ist einfacher bei langen, ungefähr symmetrischen Objekten mit offensichtlicher Achse, etwa Stiften, Schrauben oder Kabeln. Ein Fehler in der Breite verteilt sich auf beide Seiten.

Beide ergeben dieselbe Art von Rahmen; Sie können jederzeit wechseln.

Der neue Rahmen erhält das in der Liste **Labels** gewählte Label. `Esc` oder ein Rechtsklick bricht das Zeichnen ab.

## Einen Rahmen bearbeiten

Klicken Sie einen Rahmen an, um ihn auszuwählen. Der ausgewählte Rahmen ist gelb, mit einem Griff an jeder Ecke.

![Ein ausgewählter Rahmen um eine Mutter: gelber Umriss, vier runde Eckgriffe, grüne Unterkante und das Label nut](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/box-selected.png)

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/editing-a-box.mp4)

|   |   |
| --- | --- |
| Verschieben | Rahmen ziehen, oder Pfeiltasten (1 Pixel; mit `Shift` 10 Pixel), oder `Strg` / `Shift` + `I` `J` `K` `L` |
| Größe ändern | Eine Kante ziehen; die gegenüberliegende bleibt. Tasten: `Strg` / `Shift` + `V` `B` (Höhe), `N` `M` (Breite) um 1 / 10 Pixel |
| Drehen | Eine Ecke ziehen, oder `Strg` / `Shift` + `U` `O` um 1° / 10° |
| Genaue Werte | Im Bereich **Gewählter Rahmen** eintippen: Mittelpunkt, Breite, Höhe in Pixeln, Winkel in Grad |
| Unterkante | `R` / `Shift+R` oder die Schaltflächen **Unterkante**: Die nächste Seite wird Unterkante (0°), siehe [Mittellinien und Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge) |
| Label | Zifferntasten 1 bis 9, oder das Label in der Liste anklicken |
| Löschen | Rechtsklick, oder `Entf` |

Der Browser behält `Strg+N` für sich: Verwenden Sie `Shift+N` / `Shift+M` für die Breite.

## Mittellinien und Unterkante {#center-lines-and-bottom-edge}

Gestrichelte **Mittellinien** laufen längs und quer durch jeden Rahmen, durch seinen Mittelpunkt. Wo sie sich kreuzen, liegt der Mittelpunkt des Rahmens, zum Beispiel die Stelle, an der ein Greifer das Teil hält. So sehen Sie auf einen Blick, ob der Mittelpunkt richtig sitzt: Bei einem Halter sollte die Linie längs des Rahmens durch beide Bohrungen laufen. Die Linien erscheinen auch in der Lupe und beim Zeichnen eines Rahmens, und sie stören nie beim Klicken. **Mittellinien anzeigen** unter **Ansicht** oder `C` schaltet sie aus und ein; der Browser merkt sich die Wahl für Ihr Konto.

Die **grüne Unterkante** ist die 0°-Seite des Rahmens und gibt ihm seine Richtung. Liegt sie auf der falschen Seite, müssen Sie den Rahmen nicht neu zeichnen: `R` macht die nächste Seite im Uhrzeigersinn zur Unterkante, `Shift+R` die nächste gegen den Uhrzeigersinn. Die beiden Schaltflächen **Unterkante** neben **Winkel** tun dasselbe. Der Umriss bleibt genau, wo er ist; der Winkel ändert sich um 90°, Breite und Höhe tauschen. Jede Drehung ist ein Rückgängig-Schritt.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/center-lines-and-bottom-edge.mp4)

## Genau arbeiten: die Lupe

Der Mauszeiger ist ein Fadenkreuz. Daneben zeigt eine Lupe den Bereich unter dem Zeiger vergrößert, mit Pixelraster, den Rahmen und der Position auf 0,1 Pixel. So setzen Sie Kanten subpixelgenau. `M` oder **Lupe am Mauszeiger** schaltet sie aus und ein.

![Lupe: ein Kreis mit Fadenkreuz und Pixelraster über der Ecke eines Halters, mit der Position x 245.5, y 314.9 und der Vergrößerung 15-fach](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/magnifier.png)

Rahmen werden auf 0,1 Pixel und Winkel auf 0,001 Radiant gespeichert, genau wie im Desktop-Werkzeug.

## Zoom und Ansicht

- Mausrad oder `+` / `−`: am Zeiger zoomen. `F`: Bild ins Fenster einpassen. `Z` oder **1:1**: ein Bildschirmpixel je Bildpixel.
- Leere Fläche ziehen, oder `Alt` + Ziehen: Bild verschieben.
- **Helligkeit** und **Kontrast** ändern nur die Anzeige, nicht das Bild.
- **Labels anzeigen** blendet die Labeltexte für einen freien Blick aus.
- **Mittellinien anzeigen** (`C`) blendet die Mittellinien aus und ein, siehe [Mittellinien und Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge).

## Labels

Die Labels gelten für alle im Projekt. **Hinzufügen** fügt den ins Feld getippten Namen hinzu; Projekt-Admins können in den [Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html) auch Labels entfernen und die Reihenfolge ändern. Die ersten neun haben die Tasten 1 bis 9.

## Speichern

- **Speichern** (`S` oder `Strg+S`) schreibt die Rahmen in `<Bild>.csv` und ergänzt einen Eintrag in `<Bild>.json`.
- **Speichern und aufs nächste kopieren** (`Alt+S`): speichert, öffnet das nächste Bild und kopiert die Rahmen ungespeichert hinein. Praktisch für Serien, in denen sich die Teile kaum bewegen: korrigieren, speichern, weiter.
- Wechseln Sie mit ungespeicherten Änderungen zu einem anderen Bild, werden Sie gefragt: **Speichern**, **Änderungen verwerfen** (verwerfen) oder **Abbrechen**.

## Interessensbereich

Hat das Projekt einen Interessensbereich, ist er im Bild violett umrandet. Annotieren Sie nur innerhalb; Rahmenvorschläge außerhalb entfallen. Projekt-Admins legen ihn in den [Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html) fest.

## Ein Bild löschen

Projekt-Admins können ein Bild löschen: Rechtsklick darauf in der Bildliste und bestätigen. Das löscht das Bild mit seinen Annotationsdateien, allen Versionen, seinem Verlauf und seinen Hinweisen und lässt sich nicht rückgängig machen.

# Ausrichtung der Rahmen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-orientation.html

Ein gedrehter Rahmen sagt nicht nur, *wo* ein Teil liegt, sondern auch, *wohin es zeigt*. Die grüne Unterkante legt die Richtung fest, und der Winkel des Rahmens ergibt sich daraus (siehe [Mittellinien und Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge)). Bei den meisten Teilen ist dieser Winkel die tatsächliche Drehung des Teils: LumiScan Training lernt ihn aus Ihren Rahmen, und eine Anwendung wie LumiScan VGR dreht das Teil damit richtig herum, bevor sie es ablegt. Der Winkel ist nur so richtig wie die grüne Kante, deshalb ist die Regel dieser Seite kurz:

> [!IMPORTANT]
> Legen Sie für jedes Label fest, welche Seite des Teils seine Unterseite ist, und setzen Sie die grüne Unterkante in jedem Rahmen genau auf diese Seite, egal wie das Teil im Bild liegt.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/box-orientation.mp4)

## Teile mit eindeutiger Ausrichtung

Der Halter in den Bildern dieser Seite sieht in jeder Drehung anders aus: Die abgeschrägte Ecke, die große Bohrung, das Langloch und die Lasche mit ihrer kleinen Bohrung passen nur auf eine Weise zusammen. Ein solches Teil hat genau einen richtigen Winkel zwischen −180° und 180°.

![Derselbe Halter viermal, gedreht um 0°, 90°, 180° und −90°: Die abgeschrägte Ecke, die große Bohrung und die Lasche mit der kleinen Bohrung liegen jedes Mal an einer anderen Stelle](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/orientation/orientation-rotations.jpg)

Die meisten Industrieteile sind so, auch wenn der Unterschied klein ist: eine Bohrung außer der Mitte, eine Kerbe, ein aufgedrucktes Zeichen. Annotieren Sie sie alle mit Ausrichtung. Nur Teile, die in jeder Drehung wirklich gleich aussehen, sind eine Ausnahme, siehe [Teile ohne Ausrichtung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-orientation.html#parts-without-orientation).

## Eine Regel je Label

Wählen Sie die Unterseite nach einem Merkmal, das in jedem Bild gut zu sehen ist, auch wenn das Teil schräg liegt, halb im Schatten oder teilweise verdeckt ist. Für den Halter lautet die Regel: **Die Unterkante liegt an der Lasche**. Dann hat jeder Rahmen des Labels seine grüne Kante an der Lasche, und der Winkel jedes Rahmens ist die Drehung des Halters, über den ganzen Bereich von −180° bis 180°:

![Fünf Halter in verschiedenen Drehungen, jeder mit einem Rahmen, dessen grüne Unterkante an der Lasche liegt; die Winkel sind 18°, 147°, −64°, −128° und 96°](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/orientation/orientation-consistent.jpg)

- Schreiben Sie die Regel mit einem Beispielbild auf, wo alle Annotatoren sie sehen, bevor das erste Bild annotiert wird. Sie später zu ändern heißt, jeden schon gezeichneten Rahmen zu prüfen.
- Nehmen Sie ein Merkmal des Teils, nie das Bild: „Unterkante unten im Bild" ergibt für jedes Teil einen Winkel nahe 0°, egal wie es tatsächlich gedreht ist.
- Sehen sich zwei Labels ähnlich (etwa ein Teil und sein spiegelbildliches Gegenstück), bekommt jedes seine eigene Regel, nach dem Merkmal, das sie unterscheidet.

## Was schiefgeht, wenn die Kante auf einer anderen Seite liegt

Der Umriss eines Rahmens kann perfekt sein, während seine Richtung falsch ist. Zwei typische Fehler, markiert wie beim Prüfen:

![Dieselben fünf Halter; zwei Rahmen sind markiert: 1 hat die grüne Kante auf der Seite gegenüber der Lasche (−33° statt 147°), 2 auf einer Nachbarseite (−38° statt −128°)](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/orientation/orientation-inconsistent.jpg)

|   |   |
| --- | --- |
| 1: gegenüberliegende Seite | Der Umriss passt, aber der Winkel ist um 180° falsch. Das ist der häufigste Fehler: Der Rahmen sieht auf den ersten Blick richtig aus. |
| 2: Nachbarseite | Auch hier passt der Umriss, aber der Winkel ist um 90° falsch, und Breite und Höhe sind vertauscht. |

In beiden Fällen zeigt nur die grüne Kante den Fehler.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/box-orientation-why.mp4)

### Im Training

Das Netz lernt den Winkel aus den Beispielen, die es bekommt. Ist derselbe Halter, gleich liegend, in einem Bild mit 147° und im nächsten mit −33° annotiert, widersprechen sich die Beispiele. Das Netz kann nicht lernen, wohin der Halter zeigt, nur ungefähr, wo seine lange Seite liegt: Seine Winkel werden unsicher und kommen oft um 180° gedreht heraus, und bei 90°-Fehlern geraten auch Breite und Höhe durcheinander. Schon wenige solcher Rahmen schaden spürbar, weil jeder das Gegenteil aller richtigen Rahmen lehrt.

Falsche Rahmen im Validierungs- oder Testanteil verfälschen außerdem die Ergebnisse des Trainings: Eine richtige Vorhersage zählt als Fehler, und das Netz wirkt schlechter oder besser, als es ist.

### Am Roboter

Ein Roboter greift das Teil typischerweise im Mittelpunkt des Rahmens und dreht es um den Winkel, damit es richtig herum in der Aufnahme ankommt. Der Mittelpunkt eines Rahmens mit falscher Unterkante stimmt trotzdem, das Teil wird also problemlos gegriffen. Der Fehler zeigt sich erst beim Ablegen:

![Oben: Rahmen mit 18°, grüne Kante an der Lasche; um −18° gedreht passt der Halter in seine Aufnahme (grüner Umriss, Haken). Unten: derselbe Halter mit einem Rahmen bei −162°; um 162° gedreht kommt er verkehrt herum an und passt nicht (roter Umriss, Kreuz)](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/orientation/orientation-consequence.jpg)

Ein um 180° falscher Winkel legt das Teil verkehrt herum ab: Es passt nicht, liegt schief in der Aufnahme oder wird falsch herum montiert, und das fällt oft erst später in der Linie auf.

## Die Ausrichtung richtig halten

- **Achten Sie auf die grüne Kante**, bevor Sie speichern. Liegt sie auf der falschen Seite, zeichnen Sie den Rahmen nicht neu: `R` macht die nächste Seite im Uhrzeigersinn zur Unterkante, `Shift+R` die nächste gegen den Uhrzeigersinn; zweimal `R` legt sie auf die gegenüberliegende Seite. Der Umriss bleibt, wo er ist (siehe [Mittellinien und Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge)).
- **Zeichnen Sie von unten**: Beim [Mittellinien-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-line-rectangle) klicken Sie zuerst auf die Unterseite des Teils; beim [Kanten-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#edge-rectangle) zuerst auf die beiden Enden der Unterkante und bewegen dann die Maus zur Oberseite. Die Richtung stimmt dann ohne Drehen.
- **Vorlagen** merken sich die Ausrichtung des Rahmens, aus dem sie erstellt wurden. Erstellen Sie die Vorlage mit der Unterkante auf der richtigen Seite und drehen Sie einen platzierten Vorlagenrahmen passend zum Teil (siehe [Rahmenvorlagen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html#box-templates)). Dasselbe gilt für Rahmen, die aus dem vorigen Bild kopiert wurden.
- **Rahmenvorschläge** können die Unterkante auf jeder Seite haben, besonders die des Detektors. Prüfen Sie die grüne Kante jedes Vorschlags, bevor Sie ihn übernehmen (siehe [Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestions.html)).
- **Zwei Annotatoren je Bild**: Das [Prüfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html) markiert Rahmen, deren Winkel sich um mehr als 135° unterscheiden, als *Unterkante auf der anderen Seite*. Ein solcher Unterschied kommt nie von ungenauem Zeichnen; es lohnt sich, die Regel mit beiden Annotatoren noch einmal abzustimmen.

Der Winkel steht in der Annotationsdatei als `angleRad`, gemessen von der grünen Unterkante aus (siehe [Annotationsdateien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html)).

## Teile ohne Ausrichtung {#parts-without-orientation}

Manche Teile sehen in jeder Drehung genau gleich aus, zum Beispiel eine runde Unterlegscheibe oder eine Kugel. Für sie bedeutet der Winkel des Rahmens nichts, und jeder Winkel ist so gut wie ein anderer. Markieren Sie solche Labels beim [Export der Annotationen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html) unter **Labels without orientation** (Labels ohne Orientierung; `nonRotables` in LumiScan Training): Das Training lässt ihren Winkel dann außer Acht.

Verwenden Sie das nur für Teile, die wirklich kein Vorne und Hinten haben. Ein Teil, das nur *fast* symmetrisch aussieht, etwa ein Halter, der sich nur durch eine kleine Bohrung unterscheidet, hat trotzdem eine Ausrichtung, und der Roboter braucht sie: Annotieren Sie es nach einer Regel, wie oben beschrieben.

## Mit den Beispielbildern ausprobieren {#sample-images}

Zwei Downloads mit denselben 24 Bildern von Haltern und Unterlegscheiben (synthetische Kamerabilder, 1280 × 960 Pixel, Graustufen), frei zum Testen und Trainieren:

|   |   |
| --- | --- |
| [Beispielprojekt](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_attachments/lumiscan-annotation-web-sample-brackets.lumiscan-project.tar) (14 MB) | Die Bilder **mit** ihren Referenz-Annotationen, als Projektdatei zum Laden auf Ihrem Server: **Projekte** → **Projekt importieren** (siehe [Exportieren und importieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html#exporting-and-importing)). Das Projekt *Sample – oriented brackets* hat die Labels `bracket` und `washer`; `washer` ist für den [Export](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html) schon ein Label ohne Orientierung. |
| [Beispielbilder](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_attachments/lumiscan-annotation-web-sample-brackets.zip) (14 MB) | Die Bilder **ohne** Annotationen, zum selbst Annotieren (`images/`), die Referenz-Annotationen als CSV-Dateien des Desktop-Werkzeugs (`reference/`) und eine kurze Anleitung (`README.txt`). |

Annotieren Sie die Bilder aus dem ZIP nach der Regel dieser Seite, die grüne Unterkante an der Lasche, und vergleichen Sie Ihre Rahmen mit dem Beispielprojekt: Die Winkel sollten auf wenige Grad übereinstimmen, nie um 180° abweichen.

# Rahmen kopieren und Vorlagen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html

Die Bilder einer Serie zeigen oft dieselben Teile an fast derselben Stelle. Die Rahmen zu kopieren und ein wenig zu verschieben geht viel schneller, als sie neu zu zeichnen.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/copying-boxes.mp4)

Das Menü **Kopieren ▾** unter dem Bild fasst die Möglichkeiten zusammen:

![Menü Kopieren mit den Einträgen Rahmen aus dem vorigen Bild, Diese Rahmen auf die nächsten Bilder kopieren, Alle Rahmen kopieren und Rahmen einfügen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/copy-menu.png)

## Rahmen vom vorigen Bild

`V` (oder **Kopieren ▾ → Rahmen aus dem vorigen Bild**) übernimmt die Rahmen des Bildes, das in der Liste davor steht, in das offene Bild. Hat das offene Bild schon Rahmen, wählen Sie: **Hinzufügen** oder **Diese ersetzen**.

Danach korrigieren Sie, was sich verschoben hat, und speichern. Das Kopieren ist ein Schritt von [Rückgängig](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/history-and-undo.html): `Strg+Z` nimmt es zurück.

## Auf die nächsten Bilder kopieren

Für eine Serie, in der sich die Teile nicht bewegen, speichert **Kopieren ▾ → Diese Rahmen auf die nächsten Bilder kopieren …** die Rahmen des offenen Bildes direkt in die nächsten Bilder der Liste:

|   |   |
| --- | --- |
| Number of next images | Wie viele Bilder nach diesem, in der Reihenfolge der Liste (Bilder, die die Liste nicht zeigt, werden übersprungen). |
| Also replace boxes those images have already | Aus (Standard): Bilder mit Rahmen behalten ihre. An: Ihre Rahmen werden ersetzt. |

Bilder, die gerade jemand anderes geöffnet hat, werden übersprungen; der Status sagt, wie viele. Öffnen Sie die Bilder danach mit `D` und korrigieren Sie, was abweicht.

> [!TIP]
> **Speichern und aufs nächste kopieren** (`Alt+S`) macht dasselbe Bild für Bild: speichern, nächstes Bild öffnen und die Rahmen ungespeichert hineinlegen, sodass Sie jedes Bild sehen, bevor es gespeichert wird.

## Kopieren und einfügen

- `Strg+C` kopiert den ausgewählten Rahmen oder, wenn keiner ausgewählt ist, alle Rahmen.
- `Strg+V` fügt sie an derselben Stelle in das offene Bild ein. Das geht in jedem Bild, auch in einem anderen Tab desselben Browsers.

`Strg+V` fügt ein, wenn kein Rahmen ausgewählt ist. Mit ausgewähltem Rahmen behält `Strg+V` seine Bedeutung aus dem Desktop-Werkzeug (Höhe − 1 Pixel); Kopieren hebt die Auswahl auf, sodass `Strg+C`, `Strg+V` einfügt. Am Mac kopieren und einfügen `Cmd+C` und `Cmd+V` immer.

## Rahmenvorlagen {#box-templates}

Teile fester Größe erhalten in jedem Bild Rahmen fast gleicher Größe und Ausrichtung. Eine **Vorlage** merkt sich diese Größe und Ausrichtung je Label.

1. Zeichnen Sie einen Rahmen des Labels sorgfältig, mit der [Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge) auf der richtigen Seite.
2. Klicken Sie bei ausgewähltem Rahmen im Bereich **Gewählter Rahmen** auf **Als Vorlage speichern** (Projekt-Admins). Die Labelliste markiert Labels mit Vorlage mit ▭.
3. Von nun an setzt `T` einen Rahmen des aktuellen Labels an den Mauszeiger: das Label des ausgewählten Rahmens oder das zuletzt angeklickte. **…-Vorlage setzen** im Bereich **Labels** setzt ihn in die Bildmitte.
4. Schieben Sie den Rahmen an seinen Platz (ziehen oder Pfeiltasten) und drehen Sie ihn bei Bedarf (`Strg` / `Umschalt` + `U` / `O`).

Vorlagen gehören zu den [Projekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html#box-templates); dort lassen sie sich auch ändern oder entfernen.

# Bilder finden und sortieren – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html

Über der Bildliste liegen die Bedienelemente, die bestimmen, welche Bilder die Liste zeigt und in welcher Reihenfolge.

![Bildliste mit Suchfeld, Anzeigen, Label, Menge und Sortieren, Seiten einer TIFF-Datei, als fertig markierten Bildern mit Haken und den Kennzeichen VAL / TEST für Validierungs- und Testmenge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/image-filters.png)

## Suchen

Tippen Sie einen Teil eines Dateinamens ein, z. B. `14-13` oder `part_03`. Die Liste zeigt nur noch passende Bilder. `Enter` öffnet den ersten Treffer, `Esc` leert die Suche.

## Show (anzeigen)

|   |   |
| --- | --- |
| All images | Alle Bilder des Ordners. |
| Without boxes | Bilder, die noch annotiert werden müssen. Bei [mehreren Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html): **Nicht von mir annotiert** (beim Annotieren) oder **Prüfung nötig** (beim Prüfen). |
| With boxes | Bilder mit Annotation. Bei mehreren Annotatoren: **Von mir annotiert** oder **Abgeschlossen**. |
| Marked done | Bilder, die [als fertig markiert](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#marking-images-as-done) sind. |
| Not marked done | Noch nicht markierte Bilder. |
| With notes for me | Bilder mit einem offenen [Überarbeitungshinweis](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/revision-notes.html) für Sie. |
| Network unsure | Bilder, bei denen das Netz des Projekts unsicher ist (50 % oder mehr), nach der [Bewertung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#rate-with-network). |

Das offene Bild bleibt immer in der Liste. **Zurück** und **Weiter** (`A` / `D`) überspringen die Bilder, die die Liste nicht zeigt.

## Label

Nur Bilder mit mindestens einem Rahmen dieses Labels, oder **Ohne Rahmen**. Praktisch, um alle Rahmen einer seltenen Klasse zu prüfen oder Bilder zu finden, in denen eine Klasse fehlt. Die Labels stammen aus den gespeicherten Annotationen; ungespeicherte Änderungen zählen noch nicht.

> [!NOTE]
> Bei mehreren Annotatoren je Bild sehen Annotatoren die Referenzannotation nicht; der Labelfilter steht dort nur Prüfern zur Verfügung.

## Set (Menge)

Die Menge, in die der [Export](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html) das Bild legt: **Training**, **Validierung** oder **Test**, mit der Anzahl der Bilder. Die Liste kennzeichnet Validierungsbilder mit VAL und Testbilder mit TEST. Die Menge folgt aus Ordner- und Dateiname und den Exporteinstellungen des Projekts (**Validierung %**, **Test %**, **Jeden Ordner zusammenhalten**); sie steht also fest, bevor etwas exportiert wird, und ändert sich nicht, wenn weitere Bilder annotiert werden. Der Filter erscheint, sobald der Export einen Validierungs- oder Testanteil hat.

Praktisch, um zu prüfen, ob die Validierungsbilder alle Arten von Teilen abdecken, oder um die Testbilder besonders sorgfältig zu annotieren.

## Bilder als fertig markieren {#marking-images-as-done}

**Als fertig markieren** neben **Speichern** markiert das offene Bild als fertig. Das zählt bei Bildern ohne Rahmen: Ein Bild ohne Objekte sieht aus wie eines, das noch niemand angesehen hat, bis es markiert ist. `Shift+D` speichert die Rahmen, markiert das Bild und öffnet das nächste, der schnellste Weg durch eine Serie.

Die Liste zeigt ✓ neben markierten Bildern, die Zeile darüber, wie viele fertig sind, und **Anzeigen → Als fertig markiert / Nicht als fertig markiert** filtert sie. Fährt man mit der Maus über die Schaltfläche, sieht man, wer das Bild wann markiert hat; ein weiterer Klick nimmt die Markierung zurück. Annotatoren und Prüfer dürfen Bilder markieren. Die Markierungen liegen mit dem Projekt auf dem Server (auch in seinem Export) und ändern die Annotationsdateien nicht.

## Sort (sortieren)

|   |   |
| --- | --- |
| File name | Die Reihenfolge des Ordners. |
| Largest differences first | Beim Prüfen mit mehreren Annotatoren: zu prüfende Bilder zuerst, die mit den meisten Abweichungen oben. |
| Network least sure first | Nach der Bewertung: die Bilder, bei denen das Netz am unsichersten ist, oben, mit dem Prozentwert neben jedem Namen. |

## Rate with network: vom Netz bewerten lassen (aktives Lernen) {#rate-with-network}

Nicht jedes Bild hilft dem Training gleich viel. Bilder, die das Netz schon gut erkennt, bringen wenig; die, bei denen es unsicher ist, bringen ihm am meisten bei. **Mit Netz bewerten** lässt das trainierte Netz des Projekts jedes Bild des Ordners ansehen und sagen, wie sicher es ist.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/finding-and-rating-images.mp4)

1. Ordner wählen.
2. **Mit Netz bewerten** klicken. Standardmäßig werden nur Bilder ohne Rahmen bewertet; **Auch Bilder mit Rahmen** bewertet alle, **Die … schon bewerteten neu bewerten** bewertet nach einem neu trainierten Netz erneut.
3. Die Bewertung läuft auf dem Server; Sie können weiterarbeiten. Der Fortschritt steht neben der Schaltfläche.
4. Die Liste wechselt zu **Netz am unsichersten zuerst**. Annotieren Sie von oben.

Die Schaltfläche erscheint, wenn der Server [Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestions.html) bietet. Das Netz ist das in den [Projekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html#box-suggestions) gewählte.

So entsteht der Prozentwert: Das Netz sucht Objekte bis zu einer sehr geringen Konfidenz. Ein Fund genau bei der Mindestkonfidenz des Projekts (Standard 30 %) zählt als 100 % unsicher: Das Netz kann nicht entscheiden, ob dort etwas ist. Ein Fund nahe 0 % oder 100 % zählt als sicher. Das Bild erhält den Wert seines unsichersten Funds. Ein Bild ohne jeden Fund erhält 0 %.

> [!TIP]
> Bewerten, die 50 bis 100 unsichersten Bilder annotieren, trainieren, mit dem neuen Netz erneut bewerten. So finden Sie die schwierigen Fälle viel schneller als beim Annotieren in Dateireihenfolge.

# Bilder hinzufügen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html

Projekt-Admins fügen Bilddateien von ihrem Rechner zu einem Projekt hinzu, ohne Zugriff auf die Ordner des Servers. **+ Bilder hinzufügen** liegt über der Bildliste.

![Dialog Bilder hinzufügen: der Zielordner (hier ein neuer Ordner mit dem heutigen Datum), die Ablagefläche mit Dateien wählen und Ordner wählen und die Liste der gewählten Dateien mit ihrer Größe](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/add-images.png)

1. Klicken Sie auf **+ Bilder hinzufügen**.
2. Wählen Sie den Ordner: einen vorhandenen Ordner des Projekts oder **Neuer Ordner …** mit einem Namen (Vorgabe: das heutige Datum, z. B. `2026-11-08`). Wählen Sie einen Ordner auf Ihrem Rechner, wird sein Name vorgeschlagen.
3. Wählen Sie die Bilder: **Dateien wählen …**, **Ordner wählen …** (alle Bilder darin und in seinen Unterordnern) oder ziehen Sie Dateien oder einen Ordner auf den Dialog.
4. Klicken Sie auf **Bilder hinzufügen**. Ein Balken zeigt den Fortschritt. Danach zeigt die Liste den Ordner mit den neuen Bildern.

Angenommen werden PNG, JPEG (`.jpg`, `.jpeg`), BMP und TIFF (`.tif`, `.tiff`, auch mehrseitig), siehe [Bildformate](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html). Andere Dateien eines gewählten Ordners werden übergangen.

## Was übersprungen wird

- Ein Bild, dessen Name im Ordner schon vorkommt.
- Ein Bild, das sich die Annotationsdatei mit einem anderen teilen würde: `part_01.png` und `part_01.jpg` verwenden beide `part_01.csv`.
- Eine Datei, deren Inhalt nicht zur Endung passt (z. B. ein JPEG mit der Endung `.png`).

Übersprungene Bilder werden in der Meldung am Ende gezählt; Dateien, die nicht hinzugefügt werden konnten, bleiben mit dem Grund im Dialog.

## Gut zu wissen

- Die Dateien werden in den Projektordner auf dem Server kopiert bzw. in seinen S3-Bucket ([Projekte in S3-Buckets](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html)).
- Ein Projekt, dessen Bilder direkt in seinem Ordner liegen (ohne Unterordner), nimmt neue Bilder dort auf. Ein Unterordner würde diese Bilder verdecken, wie im Desktop-Werkzeug.
- Große Dateien werden in Stücken zu 8 MB übertragen. Der Server nimmt Dateien bis 2 GB an; `upload_max_mb` in der [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html) setzt eine andere Grenze.
- Bilder können auch direkt in den Projektordner gelegt werden (Datei-Explorer, Netzlaufwerk, S3-Werkzeug): Der Server findet sie innerhalb einer Minute.

# Rahmenvorschläge – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestions.html

**Rahmen vorschlagen** (`P`) fragt den Dienst für Rahmenvorschläge nach Rahmen für das offene Bild. Die Schaltfläche erscheint nur, wenn der Server einen Dienst hat (siehe [Dienst für Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html)) oder die Netze selbst ausführt, wie die [Einzelplatz-Installation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/single-pc-installation.html#box-suggestions-without-a-server).

Die Vorschläge kommen von:

- **Ihrem trainierten LumiScan-Netz** für das Projekt (gewählt in den [Projekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html#box-suggestions)) oder
- für Teile ohne Netz von einem **Detektor mit offenem Vokabular**, der nach den mit den Labels benannten Objekten sucht, z. B. „bracket" oder „hexagon nut".

![Vorgeschlagene Rahmen, gestrichelt, mit Label und Konfidenz, z. B. bracket 97 %, nut 93 %, washer 74 %](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/suggestions.jpg)

## Mit Vorschlägen arbeiten

Vorschläge sind **gestrichelt** mit Label und Konfidenz gezeichnet. Sie gehören erst zur Annotation, wenn Sie sie übernehmen.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/box-suggestions.mp4)

|   |   |
| --- | --- |
| Einen übernehmen | Korrigieren (verschieben, Größe ändern, drehen, Label ändern), oder auswählen und `Enter` drücken |
| Einen löschen | Rechtsklick darauf, oder auswählen und `Entf` drücken |
| Alle übrigen übernehmen | **Alle übernehmen** |
| Alle übrigen löschen | **Verwerfen** |
| Mit offenen Vorschlägen speichern | Sie werden gefragt, ob sie übernommen oder weggelassen werden |

Vorschläge werden nie von selbst in die Annotationsdatei geschrieben.

Nicht vorgeschlagen werden:

- Objekte, die schon einen Rahmen im Bild haben (Überlappung mit einem vorhandenen Rahmen),
- Objekte außerhalb des Interessensbereichs,
- Vorschläge unter der Mindestkonfidenz des Projekts und über seiner Höchstzahl an Rahmen.

## Gute Vorschläge

- **Mit einem Netz**: Je mehr annotierte Bilder es gelernt hat, desto besser. Trainieren Sie nach jeweils einigen Hundert korrigierten Bildern neu.
- **Mit dem Detektor**: Die Labelnamen sagen, wonach gesucht wird. Verwenden Sie sichtbare Eigenschaften („hexagon nut", „weld seam", „black rubber seal"), keine internen Teilenummern. Labels mit nichtssagendem Namen erhalten in den Projekteinstellungen eine Beschreibung, z. B. `part_a: hexagon nut`.
- Winzige oder kontrastarme Objekte: Mindestkonfidenz senken.
- Prüfen Sie immer jeden übernommenen Rahmen. Ein falscher Rahmen in den Trainingsdaten bringt dem Netz den Fehler bei.
- Lassen Sie das Netz sagen, wo es unsicher ist: [Rate with network](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#rate-with-network) sortiert die Bilder so, dass die nützlichsten zuerst annotiert werden.

# Überarbeitungshinweise – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/revision-notes.html

Ein Überarbeitungshinweis ist eine Anweisung an einem Bild für jemand anderen, typischerweise von einem Prüfer an einen Annotator: was zu ändern ist und warum. Zum Beispiel: „Der Rahmen dieses Halters ist links zu breit: bitte an die Kante anlegen."

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/revision-notes.mp4)

## Einen Hinweis hinterlassen

1. Öffnen Sie das Bild. Um den Hinweis an einen Rahmen zu heften, wählen Sie den Rahmen zuerst aus.
2. Klicken Sie im Bereich **Überarbeitungshinweise** auf **Hinweis hinzufügen**.
3. Schreiben Sie die Anweisung.
4. Wählen Sie unter **Für** die Person oder **Wer an diesem Bild arbeitet**.
5. Haken Sie **Den Hinweis an den gewählten Rahmen heften** an, wenn Sie einen Rahmen ausgewählt haben. Der Hinweis erscheint dann als rotes **!** im Bild.
6. Klicken Sie auf **Hinweis hinzufügen**.

![Dialog Überarbeitungshinweis zu part_002.png mit dem Anweisungstext, dem Empfänger Wer an diesem Bild arbeitet und der Option, den Hinweis an den ausgewählten Rahmen zu heften](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/note-dialog.png)

## Hinweise erhalten

- Die obere Leiste zeigt **✎ n notes for you**. Ein Klick öffnet das nächste Bild mit einem Hinweis für Sie.
- Die Bildliste markiert Bilder mit offenen Hinweisen (✎ und die Anzahl).
- **Anzeigen → Mit Hinweisen für mich** filtert die Liste.

![Schaltfläche 2 Hinweise für Sie in der oberen Leiste](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/notes-chip.png)

Am Bild steht der Hinweis im Bereich **Überarbeitungshinweise**, mit Verfasser, Empfänger und Zeit:

![Ein Überarbeitungshinweis von Clara Lenz an Anna Weber, markiert für Sie, mit den Schaltflächen Anzeigen, Fertig und Antworten](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/note-panel.png)

|   |   |
| --- | --- |
| **Anzeigen** | zoomt an die Stelle, an die der Hinweis geheftet ist |
| **Antworten** | beantwortet den Hinweis |
| **Fertig** | markiert den Hinweis als erledigt, auf Wunsch mit Antwort. Erledigte Hinweise bleiben sichtbar, mit Angabe, wer sie wann geschlossen hat. |

Der Verfasser und Projekt-Admins können einen Hinweis löschen.

# Verlauf und Rückgängig – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/history-and-undo.html

## Rückgängig und Wiederherstellen

Beim Bearbeiten eines Bildes ist jede Rahmenänderung ein Schritt: `Strg+Z` macht ihn rückgängig, `Strg+Shift+Z` oder `Strg+Y` stellt ihn wieder her, ebenso die Schaltflächen ↶ und ↷ in der Werkzeugleiste. Eine gedrückt gehaltene Pfeiltaste ist ein Schritt.

## Verlauf

Der Bereich **Verlauf** (rechts unten, zum Öffnen anklicken) listet jeden gespeicherten Stand des offenen Bildes, auch von früheren Tagen, mit Zeit, Benutzer und was geschah: gespeichert, in der Prüfung entschieden, Annotatoren stimmten überein, wiederhergestellt oder außerhalb der Web-App geändert.

![Bereich Verlauf geöffnet: Eine ältere Version von part_003.png wird pink über dem Bild gezeigt, mit nummerierten Markierungen, wo sie von den Rahmen im Editor abweicht](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/history.jpg)

- Klicken Sie eine Version an, um sie **pink** über dem Bild zu sehen. Nummerierte Markierungen zeigen, wo sie von den Rahmen im Editor abweicht.
- **Älter** und **Neuer** (oder die Tasten `,` und `.`) blättern durch die Versionen; **Schließen** blendet sie wieder aus.
- **Wiederherstellen** übernimmt die Version als ungespeicherte Änderung in den Editor. Speichern fügt eine neue Version hinzu; der Verlauf wird nie umgeschrieben.

![Bereich Verlauf: die ausgewählte Version von anna, verglichen mit dem Editor, Schaltflächen Älter, Neuer, Schließen und Wiederherstellen; darunter die Liste der Versionen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/history-panel.png)

Änderungen mit dem Desktop-Werkzeug im selben Ordner werden ebenfalls als Versionen festgehalten, mit dem Benutzer aus `<Bild>.json`. Der Verlauf hält den genauen Text jeder CSV-Datei fest; eine Wiederherstellung schreibt einen früheren Stand also byte-gleich zurück.

Bei mehreren Annotatoren je Bild sehen Annotatoren nur den Verlauf ihrer eigenen Version. Prüfer wählen unter **Anzeigen**, ob sie den Verlauf der Referenz oder eines Annotators sehen.

# Gleichzeitig arbeiten – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/working-at-the-same-time.html

Beliebig viele Personen können gleichzeitig im selben Projekt arbeiten. Zwei Regeln halten ihre Arbeit auseinander.

## Bearbeitungssperren

Wer ein Bild öffnet, erhält eine **Bearbeitungssperre**. Solange Sie das Bild offen haben, können andere es ansehen, aber nicht ändern: Deren Ansicht ist nur lesbar, mit einem Hinweisbalken, der Sie nennt, und die Bildliste zeigt Ihren Namen in Rot neben dem Bild.

![Nur lesbares Bild: Ein Balken meldet, dass anna an dem Bild arbeitet und es angesehen, aber nicht geändert werden kann; die Speichern-Schaltflächen sind gesperrt, und die Bildliste zeigt anna neben part_005.png](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/read-only.jpg)

- Die Sperre gilt 60 Sekunden und wird von Ihrem Browser erneuert, solange das Bild offen ist. Wird der Browser geschlossen oder fällt das Netz aus, endet die Sperre nach dieser Zeit von selbst.
- Öffnen Sie dasselbe Bild in einem zweiten eigenen Fenster, wird das andere Fenster nur lesbar.
- Ein nur lesbares Bild wird von selbst bearbeitbar, sobald es frei ist, etwa wenn die andere Person zum nächsten Bild geht. Die Statuszeile meldet dann **… ist wieder frei: Sie können es jetzt bearbeiten**.
- Bei mehreren Annotatoren je Bild hat jeder Annotator eine eigene Sperre auf seiner eigenen Version: Sie können dasselbe Bild gleichzeitig annotieren.

## Konflikte

Wurde die Annotationsdatei eines Bildes geändert, nachdem Sie es geöffnet haben, etwa vom Desktop-Werkzeug im selben Netzwerkordner oder von einem anderen Server in einem S3-Bucket, fragt das Speichern:

- **Deren Version laden**: Ihre Änderungen verwerfen und die andere Version zeigen,
- **Mit meiner überschreiben**: Ihre Rahmen trotzdem speichern (die andere Version bleibt im Verlauf),
- **Abbrechen**: weiter bearbeiten.

Der Server durchsucht die Projektordner regelmäßig (Standard alle 60 Sekunden) und übernimmt Änderungen außerhalb der Web-App in den Verlauf.

# Mehrere Annotatoren je Bild – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html

Mit **Annotatoren je Bild** auf 2 oder mehr in den [Projekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html) wird jedes Bild von entsprechend vielen Personen unabhängig annotiert. Der Server vergleicht ihre Rahmen. Eine Schritt-für-Schritt-Anleitung steht unter [Annotationen mit zwei Annotatoren prüfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/check-annotations-with-two-annotators.html).

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/two-annotators-and-review.mp4)

## Modi

Annotatoren sehen den Modus **Annotieren**, Prüfer den Modus **Prüfen** und die **Statistik**. Wer beide Rollen hat, wechselt oben.

## Annotieren (blind)

- Jeder zeichnet seine eigene Version, ohne die Rahmen der anderen zu sehen.
- Die Versionen liegen getrennt von der Referenz in `<Ordner>/.annotations/<Bild>/<Benutzer>.tsv` (gleiches Format wie die CSV; das Training ignoriert sie).
- Mehrere Personen können dasselbe Bild gleichzeitig annotieren.
- Die Bildliste zeigt **annotiert / benötigt** (`1/2`) und ob Sie es erledigt haben. Annotatoren sehen, wie viele annotiert haben, nicht wer.
- **Anzeigen → Nicht von mir annotiert** filtert die Liste.

## Automatischer Konsens

Wenn der letzte benötigte Annotator speichert, vergleicht der Server alle Versionen. Sie **stimmen überein**, wenn

- jedes Objekt von allen gezeichnet wurde (niemand hat einen Rahmen ausgelassen),
- zueinander gehörende Rahmen sich mindestens um den eingestellten Wert überlappen (**Übereinstimmung: Überlappung ≥ %**, Standard 85 %, gemessen als gedrehte Schnittmenge durch Vereinigung),
- ihre Winkel weniger als die Grenze abweichen (Standard 5°), mit der Unterkante auf derselben Seite,
- sie dasselbe Label haben.

Dann schreibt der Server die **gemittelten Rahmen** als Referenzannotation `<Bild>.csv`, die Datei, die das Training liest, mit `auto-consensus` als Benutzer im `.json`-Verlauf. Sonst geht das Bild in die Prüfung.

Die Rahmen verschiedener Annotatoren werden über die gedrehte Überlappung optimal einander zugeordnet (Ungarische Methode).

## Prüfen

![Modus Prüfen mit den Rahmen zweier Annotatoren in ihren Farben, roten nummerierten Markierungen an den Abweichungen und dem Bereich Unterschiede rechts](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/review.jpg)

- Die Bildliste zeigt den Stand jedes Bildes: offen, **zu prüfen**, **angenommen** (automatisch übereinstimmend), **erledigt** (geprüft). Sie ist nach den größten Abweichungen sortiert; **Sortieren** ändert das.
- Jeder Annotator hat eine Farbe; die Legende blendet einzelne Annotatoren ein und aus.
- Rote nummerierte Markierungen zeigen die Abweichungen: Rahmen fehlt bei jemandem, Überlappung zu gering, Winkel, Unterkante auf der anderen Seite, anderes Label.
- Je Abweichung: **Anzeigen** zoomt dorthin; die Schaltflächen übernehmen den Rahmen einer Person, den Mittelwert (**Mittelwert**) oder keinen (**Keiner**) in die Referenz.
- Die Rahmen im Editor lassen sich vor dem Speichern auch frei ändern.
- **Speichern** schreibt die Referenzannotation. `.annotations/<Bild>/consensus.json` hält fest, wer entschieden hat. Eine geprüfte Referenz wird nie automatisch überschrieben, auch nicht, wenn ein Annotator erneut speichert.

## Statistik

**Statistik** zeigt die Übereinstimmung für einen Ordner oder das ganze Projekt:

![Übereinstimmung zwischen Annotatoren: Kennzahlen, je Annotator, Annotatorenpaare, Abweichungen nach Art, größte Abweichungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/statistics.png)

|   |   |
| --- | --- |
| Übersicht | Bilder mit genug Annotatoren, Anteil vollständiger Bilder mit voller Übereinstimmung, mittlere Überlappung, Anteil übereinstimmender Objekte; Bilder offen, zu prüfen, automatisch übereinstimmend, geprüft |
| Per annotator | Überlappung mit dem Konsens; systematische Abweichung von Breite, Höhe und Winkel vom Mittelrahmen; Rahmen, die nur diese Person gezeichnet hat, ausgelassene Rahmen; andere Labels |
| Pairs of annotators | Übereinstimmung (F1) und mittlere Überlappung je Paar |
| Differences by kind | Wie oft jede Art von Abweichung vorkommt |
| Largest differences | Die Bilder mit den meisten und größten Abweichungen; anklicken zum Prüfen |

# Annotationen exportieren – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html

**Export** in der oberen Leiste lädt die annotierten Bilder herunter, in einem von drei Formaten (**Format**):

- **LumiScan-Training-Projekt (ZIP)**: ein vollständiges LumiScan-Training-Projekt. In den Projektordner von LumiScan Training entpacken, dort öffnen und das Training starten.
- **COCO: Bilder und Annotationen (ZIP)** und **COCO: nur Annotationen (JSON)**: für andere Werkzeuge, siehe [COCO](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html#coco).

Prüfer und Projekt-Admins sehen die Schaltfläche. Alle drei Formate verwenden dieselben Bilder, Klassen und dieselbe Aufteilung.

![Dialog Annotationen exportieren: Format, Projektname, Netztyp, Anteil für Validierung und Test, Ordner zusammenhalten, nur dieser Ordner, Labels ohne Ausrichtung und die Anzahlen je Menge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/training-export.png)

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/export-for-training.mp4)

## Einstellungen

|   |   |
| --- | --- |
| Format | LumiScan-Training-Projekt, COCO mit Bildern oder nur COCO-Annotationen (mit der Wahl: alle Bilder oder eine Menge). |
| Project name in LumiScan Training | Name des Projektordners und seiner Konfigurationsdatei (bei COCO: **Name des Exports**). Standard: der Projektname. |
| Network type | Das Netz, das LumiScan Training trainiert, z. B. `ORTMXS` (orientiert, extra klein, Standard des Trainings) oder `ORTMS`. Lässt sich in LumiScan Training später ändern. Bei COCO ohne Bedeutung. |
| Validation % | Anteil der Bilder, aus denen das Training nicht lernt, an denen es aber seinen Fortschritt misst. Standard 20. |
| Test % | Anteil für den abschließenden Test. Standard 0: LumiScan Training testet dann mit den Validierungsbildern. |
| Keep each folder together | Alle Bilder eines Ordners kommen in dieselbe Menge. Sinnvoll, wenn die Bilder eines Ordners eine Serie fast derselben Szene sind: Sonst landen fast gleiche Bilder in Training und Validierung, und die Validierungswerte sehen besser aus, als das Netz ist. |
| Only the folder … | Nur den offenen Ordner exportieren statt aller. |
| Labels without orientation | Labels, deren Objekte kein Vorne und Hinten haben (z. B. runde Unterlegscheiben): `nonRotables` in LumiScan Training. |

Unter den Einstellungen zeigt der Dialog, wie viele Bilder und Rahmen in jede Menge kommen, die Klassen und wie viele Bilder ohne Annotation wegfallen. Die Wahl von Projekt-Admins bleibt als Vorgabe für den nächsten Export beim Projekt.

## Was exportiert wird

```none
Line 5 – brackets.lumiscan-training.zip
  Line 5 – brackets/
    Line 5 – brackets.train.json        Projektkonfiguration für LumiScan Training
    training/2026-10-28/part_001.png    Bild
    training/2026-10-28/part_001.csv    seine Annotation, unverändert
    ...
    validation/2026-10-29/...
    test/...                            nur mit Testanteil
    lumiscan-annotation-export.json     wer wann exportiert hat, die Aufteilung, die Anzahlen
```

- Exportiert werden nur Bilder mit Annotation. Bei mehreren Annotatoren je Bild: die Referenzannotation (übereinstimmend oder von einem Prüfer entschieden).
- Die Annotationsdateien sind dieselben Dateien, die der Server speichert (siehe [Annotationsdateien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html)).
- JPEG- und BMP-Bilder und die Seiten von TIFF-Dateien werden als PNG geschrieben, weil LumiScan Training `<Name>.png` neben jeder `<Name>.csv` liest (siehe [Bildformate](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html)).
- Die Klassen sind die Labels des Projekts in ihrer Reihenfolge. Rahmen mit dem Label `UNKNOWN` und Rahmen mit einem Label, das keine Klasse ist, werden nicht gelernt; die Info-Datei zählt sie.
- Die Konfiguration nennt die Ordner relativ zum Projekt (`training`, `validation`, `test`). LumiScan Training richtet sie beim Öffnen auf den Projektordner aus.

## Die Aufteilung bleibt gleich

In welche Menge ein Bild kommt, entscheiden sein Ordner und sein Dateiname, nicht der Zufall. Wird dasselbe Projekt später nach weiterer Annotation erneut exportiert, bleibt jedes Bild in seiner Menge: Ein Bild, aus dem das Netz gelernt hat, wird nie nachträglich zum Validierungsbild, die Validierungswerte bleiben ehrlich. Ein höherer Validierungsanteil verschiebt nur Bilder vom Training in die Validierung. Die Bildliste zeigt die Menge jedes Bildes unter [Set](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#_set_menge).

## COCO {#coco}

**COCO: Bilder und Annotationen (ZIP)** und **COCO: nur Annotationen (JSON)** exportieren dieselben Bilder, Klassen und Mengen im COCO-Format für Objekterkennung (cocodataset.org), das CVAT, Label Studio, FiftyOne, Ultralytics, Detectron2 und viele andere Werkzeuge lesen.

```none
Line 5 – brackets.coco.zip
  Line 5 – brackets/
    images/2026-10-28/part_001.png
    ...
    annotations/instances_all.json      alle Bilder
    annotations/instances_train.json    bei mehr als einer Menge: eine Datei je Menge
    annotations/instances_val.json
    annotations/instances_test.json
```

Der JSON-Download ist eine solche Datei, für alle Bilder oder für eine Menge (**Bilder in der JSON-Datei**); ihre Einträge `file_name` benennen die Bilder wie in der ZIP-Datei.

| Feld | Inhalt |
| --- | --- |
| `images[]` | `id`, `file_name` (`<Ordner>/<Bild>`), `width`, `height`, `split` (`train`, `val`, `test`) |
| `annotations[].bbox` | Das achsenparallele Rechteck um den orientierten Rahmen `[x, y, Breite, Höhe]`, wie COCO-Werkzeuge es erwarten |
| `annotations[].segmentation` | Die vier Ecken des orientierten Rahmens (oben links, oben rechts, unten rechts, unten links des Rahmens), damit Werkzeuge ihn gedreht zeichnen |
| `annotations[].area` | Breite × Höhe des orientierten Rahmens |
| `annotations[].obb` | Der Rahmen wie in der CSV: `cx`, `cy`, `width`, `height`, `angle` (Bogenmaß, im Uhrzeigersinn, 0: Oberseite des Rahmens oben) |
| `annotations[].attributes.metadata` | Die Metadaten des Rahmens, falls vorhanden |
| `categories[]` | Die Klassen in Label-Reihenfolge, `rotatable: false` für Labels ohne Ausrichtung |

PNG- und JPEG-Dateien werden unverändert exportiert; BMP-Dateien und TIFF-Seiten werden als PNG geschrieben. Rahmen mit dem Label `UNKNOWN` fallen weg.

# Tastenkombinationen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/keyboard-shortcuts.html

Dieselbe Liste zeigt der Browser unter **Tasten**. Auf deutschen Tastaturen entspricht `Ctrl` der Taste `Strg`.

[Video](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/videos/keyboard-workflow.mp4)

| Tasten | Aktion |
| --- | --- |
| `A` / `D` | Voriges / nächstes Bild |
| `Shift+D` | [Bild als fertig markieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#marking-images-as-done) (seine Rahmen werden vorher gespeichert) und das nächste Bild öffnen |
| `S`, `Strg+S` | Speichern |
| `Alt+S` | Speichern, nächstes Bild öffnen und diese Rahmen hineinkopieren |
| `V` | [Die Rahmen des vorigen Bildes](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html) der Liste übernehmen (korrigieren, dann speichern) |
| `Strg+C` / `Strg+V` | Ausgewählten Rahmen (oder alle) kopieren / einfügen, auch in einem anderen Bild; Einfügen ohne ausgewählten Rahmen (`Cmd+V` am Mac) |
| `T` | Einen Rahmen der [Vorlage](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html#box-templates) des aktuellen Labels an den Mauszeiger setzen |
| `Strg+Z`, `Strg+Shift+Z` / `Strg+Y` | Rückgängig, wiederherstellen (jede Rahmenänderung ist ein Schritt) |
| `,` / `.` | Verlauf offen: nächstältere / nächstneuere gespeicherte Version zeigen |
| `N` | Neuer Rahmen als [Mittellinien-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-line-rectangle): unten klicken, oben klicken, dann für die Breite klicken |
| `E` | Neuer Rahmen als [Kanten-Rechteck](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#edge-rectangle): beide Enden der Unterkante klicken, dann für die Höhe klicken |
| Doppelklick | Neuer Rahmen in der zuletzt verwendeten Art |
| Rechtsklick, `Entf` | Ausgewählten Rahmen löschen (oder Zeichnen abbrechen) |
| `R` / `Shift+R` | [Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge) (0°) des ausgewählten Rahmens eine Seite weiter, im / gegen den Uhrzeigersinn; der Umriss bleibt |
| `P` | Rahmen vorschlagen (wenn der Server einen Dienst für Rahmenvorschläge hat) |
| `Enter` | Ausgewählten vorgeschlagenen Rahmen übernehmen |
| `1` – `9` | Label für den ausgewählten Rahmen setzen |
| Pfeiltasten | Ausgewählten Rahmen um 1 Pixel verschieben (`Shift`: 10 Pixel) |
| `Strg` / `Shift` + `I` `J` `K` `L` | 1 / 10 Pixel nach oben, links, unten, rechts verschieben |
| `Strg` / `Shift` + `U` `O` | 1° / 10° gegen bzw. im Uhrzeigersinn drehen |
| `Strg` / `Shift` + `V` `B` | Höhe − / + 1 / 10 Pixel |
| `Strg` / `Shift` + `N` `M` | Breite − / + 1 / 10 Pixel (der Browser behält `Strg+N` für sich: `Shift+N` verwenden) |
| `F`, `+` / `−`, `Z` | Bild einpassen, vergrößern / verkleinern (das Mausrad zoomt auch), 1:1 |
| `M` | Lupe mit Fadenkreuz am Mauszeiger ein / aus |
| `C` | [Mittellinien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotating-images.html#center-lines-and-bottom-edge) (längs und quer durch jeden Rahmen, durch den Mittelpunkt) ein / aus |
| Leere Fläche ziehen, `Alt` + Ziehen | Bild verschieben |
| `Esc` | Zeichnen abbrechen, Auswahl aufheben |

![Dialog Tastenkürzel mit der Liste der Tasten und Aktionen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/shortcuts.png)

# Projekte – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html

Ein Projekt ist ein unabhängiger Annotationsauftrag: ein Datenordner (oder ein Präfix in einem S3-Bucket), seine Einstellungen, seine Mitglieder mit ihren Rollen, sein Verlauf und seine Überarbeitungshinweise. Benutzer sehen nur die Projekte, an denen sie beteiligt sind.

Server-Admins verwalten alle Projekte unter ihrem Namen → **Projekte**. Projekt-Admins verwalten Mitglieder und Einstellungen ihres eigenen Projekts.

![Dialog Projekte: Schaltflächen Neues Projekt und Projekt importieren, eine Tabelle der Projekte mit Name, Beschreibung, Ordner, Anzahl der Bilder, Zugriff, Erstelldatum und den Schaltflächen Mitglieder & Zugriff, Export und Löschen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/projects.png)

## Ein Projekt anlegen

**Neues Projekt**, dann:

|   |   |
| --- | --- |
| Name, Description | Erscheinen in der Projektliste und der oberen Leiste |
| Existing folder on the server | Ein Ordner mit Bildern, z. B. `D:\Images\Line2` oder eine auf dem Server eingebundene Freigabe. Die Annotationsdateien werden neben die Bilder geschrieben. Leer: Der Server legt einen leeren Ordner unter `projects_root` an. |
| Store the files in | Nur mit konfigurierten S3-Buckets: ein Ordner auf dem Server oder **S3-Bucket …** mit einem Präfix, siehe [Projekte in S3-Buckets](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html) |
| Open to all signed-in users | Alle arbeiten mit ihren serverweiten Rollen im Projekt, ohne Mitglied zu sein |

Welche Ordner Admins verwenden dürfen, lässt sich mit `project_folders` in der [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html) begrenzen. Zwei Projekte dürfen sich keinen Ordner teilen.

### Aufbau eines Projektordners

Die Bilder liegen direkt im Ordner oder in einer Ebene von Unterordnern, meist einem je Tag:

```none
Line2\
    2026-10-28\
        part_001.png         das Bild
        part_001.csv         seine Rahmen
        part_001.json        sein Speicherverlauf
        .annotations\        Versionen der Annotatoren (mehrere Annotatoren je Bild)
    2026-10-29\ ...
    .lumiscan-annotation\
        settings.json        die gemeinsamen Einstellungen des Projekts (Labels, ROI, ...)
```

Das ist der Aufbau des Desktop-Werkzeugs; Ordner, die es verwendet hat, werden übernommen, wie sie sind. Siehe [Annotationsdateien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html).

## Mitglieder und Zugriff {#members-and-access}

**Mitglieder & Zugriff** neben einem Projekt:

![Mitglieder & Zugriff: Name, Beschreibung, offen für alle und die Mitgliedertabelle mit Benutzer oder Gruppe, Name und den Rollen Annotator, Prüfer, Projektadmin](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/members.png)

- **Benutzer**: ein Serverkonto über seinen Benutzernamen. **Gruppe**: eine Gruppe des Verzeichnisses oder Single Sign-on, erkannt über den Namen, den vollständigen DN oder den letzten Teil eines Keycloak-Gruppenpfads.
- Rollen je Mitglied: **Annotator**, **Prüfer**, **Projektadmin**. Wer in mehreren Einträgen steht, erhält alle ihre Rollen.
- Über eine Gruppe eingetragene Verzeichnis- und Single-Sign-on-Benutzer erhalten Zugriff bei ihrer ersten Anmeldung.
- Ihre eigene Rolle als Projekt-Admin können Sie nicht entfernen; so behält ein Projekt immer einen Admin.

## Exportieren und importieren {#exporting-and-importing}

**Export** lädt das Projekt als eine Datei `<Name>.lumiscan-project.tar` herunter, ein einfaches tar-Archiv (lesbar mit `tar.exe` von Windows, 7-Zip oder jedem Linux-System):

|   |   |
| --- | --- |
| `project.json` | Name, Beschreibung, Mitglieder (ohne Passwörter), Zeit und Benutzer des Exports |
| `settings.json` | die Einstellungen des Projekts |
| `data/…` | Bilder, CSV- und JSON-Dateien byte-gleich sowie die Versionen der Annotatoren |
| `notes.jsonl` | Überarbeitungshinweise |
| `history.jsonl` | jede gespeicherte Version (optional) |

**Projekt importieren** lädt eine solche Datei in Stücken von 8 MB mit Fortschrittsanzeige hoch, sodass auch Projekte von mehreren Gigabyte funktionieren. Er legt ein unabhängiges Projekt in einem neuen Ordner unter `projects_root` an (oder in einem Bucket). Die Mitglieder bleiben erhalten und gelten, wenn sich diese Benutzer an diesem Server anmelden. Die Pfade im Archiv werden geprüft: Nichts kann außerhalb des neuen Projektordners geschrieben werden.

![Dialog Ein Projekt importieren: Projektdatei, optionaler Name, Schaltflächen Abbrechen und Importieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/import-project.png)

Typischer Einsatz: Ein Kunde exportiert ein Projekt und schickt es HD Vision Systems zur Annotation durch Fachleute; das annotierte Projekt kommt auf demselben Weg zurück.

## Ein Projekt löschen

**Löschen** entfernt das Projekt vom Server: seine Einstellungen, Mitglieder, seinen Verlauf und seine Hinweise. Bild- und Annotationsdateien werden nur bei Ordnern gelöscht, die der Server selbst angelegt hat (auf Wunsch); vorhandene Ordner und Buckets werden nie gelöscht.

## Das Projekt `default`

Der in der Konfiguration als `data_root` angegebene Bildordner wird zum Projekt `default`, offen für alle Benutzer. So laufen Installationen aus der Zeit vor den Projekten unverändert weiter.

# Benutzer und Rollen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html

## Rollen

| Rolle | Darf |
| --- | --- |
| Annotator | Rahmen zeichnen und speichern; Labels hinzufügen. Bei mehreren Annotatoren je Bild: nur die eigene Version, blind. |
| Reviewer (Prüfer) | Die Annotatoren vergleichen, die Referenzannotation entscheiden, die Statistik sehen. |
| Project admin | Mitglieder und Einstellungen des Projekts verwalten; Bilder löschen. |
| Admin | Alles in jedem Projekt, dazu Benutzer, Gruppenzuordnungen, Projekte (anlegen, exportieren, importieren, löschen) und Sicherungen. |

Der Server setzt die Rollen durch; der Browser zeigt nur, was eine Rolle darf.

**Serverweite Rollen** (Annotator, Prüfer, Admin) werden je Benutzer oder je Gruppe vergeben, siehe unten. Sie gelten in Projekten, die **offen für alle angemeldeten Benutzer** sind. Andere Projekte vergeben Rollen an ihre Mitglieder, siehe [Mitglieder und Zugriff](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html#members-and-access).

## Benutzer verwalten

Admins: Ihr Name → **Benutzer und Anmeldung**.

![Reiter Benutzer: Suchfeld, Schaltfläche Lokalen Benutzer hinzufügen, Tabelle der Benutzer mit Kontoart, den Rollen Annotator, Prüfer, Admin, aktiv, letzte Anmeldung und den Schaltflächen Passwort zurücksetzen und Löschen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/users.png)

- **Lokalen Benutzer hinzufügen**: Benutzername, vollständiger Name, E-Mail, Rollen und ein erstes Passwort. Ohne Passwort wird eines erzeugt und einmal angezeigt. Der Benutzer muss es bei der ersten Anmeldung ändern.
- Haken Sie die Rollen direkt in der Tabelle an. **Aktiv** aus: Der Benutzer kann sich nicht mehr anmelden, seine Sitzungen enden sofort.
- **Passwort zurücksetzen**: ein neues Passwort für ein lokales Konto (einmal angezeigt); der Benutzer ändert es bei der nächsten Anmeldung.
- Verzeichnis- und Single-Sign-on-Benutzer erscheinen nach ihrer ersten Anmeldung in der Liste. Ein **G** markiert Rollen aus einer Gruppenmitgliedschaft.

## Gruppen und Rollen {#groups}

**Gruppen → Rollen** vergibt eine Rolle an jedes Mitglied einer Verzeichnis- oder Single-Sign-on-Gruppe:

![Reiter Gruppen → Rollen: Zuordnungen der Gruppe Annotation Team zur Rolle Annotator und Quality Assurance zur Rolle Prüfer](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/groups.png)

Eine Gruppe wird erkannt über ihren Namen (`Annotation Reviewers`), ihren vollständigen DN, den letzten Teil eines Keycloak-Gruppenpfads (`/hdvs/annotation-reviewers`) oder eine Client-Rolle. Gruppenrollen werden bei jeder Anmeldung aktualisiert.

## Anmeldeverfahren

Der Reiter **Anmeldeverfahren** zeigt, was konfiguriert ist, die beim Single-Sign-on-Anbieter einzutragende Rücksprungadresse und ein Formular, um **eine Verzeichnisanmeldung zu testen**: Es zeigt die gefundenen Gruppen und die Rollen, die sie geben, ohne sich anzumelden. Die Verfahren selbst werden in der Konfigurationsdatei des Servers eingestellt, siehe [Anmeldeverfahren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/sign-in-methods.html).

## Ihr eigenes Passwort

Lokale Benutzer ändern ihr Passwort unter ihrem Namen → **Passwort ändern**. Passwörter haben mindestens 10 Zeichen. Verzeichnis- und Single-Sign-on-Benutzer ändern ihr Passwort im Firmenverzeichnis.

![Dialog Passwort ändern: aktuelles Passwort, neues Passwort zweimal](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/change-password.png)

# Projekteinstellungen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/project-settings.html

Projekt-Admins öffnen die Einstellungen des aktuellen Projekts mit **Einstellungen** in der oberen Leiste. Sie gelten für alle im Projekt und liegen im Projektordner (`.lumiscan-annotation/settings.json`, die Schlüssel `labels` und `roiSettings` wie im Desktop-Werkzeug).

![Dialog Einstellungen: Labels, Interessensbereich, mehrere Annotatoren je Bild, Rahmenvorschläge mit Netz, Beschreibungen, Mindestkonfidenz und Höchstzahl an Rahmen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/settings.png)

## Labels

Ein Label je Zeile. Die Reihenfolge ergibt die Tasten 1 bis 9 und die Reihenfolge in der Liste. Ein hier umbenanntes Label ändert bereits mit dem alten Namen gespeicherte Rahmen nicht.

## Interessensbereich

**Ganzes Bild** oder ein Rechteck in Bildpixeln (**X**, **Y**, **Breite**, **Höhe**). Das Rechteck wird auf jedem Bild umrandet; Rahmenvorschläge außerhalb entfallen.

## Mehrere Annotatoren je Bild

|   |   |
| --- | --- |
| Annotators per image | `1`: Jedes Bild wird einmal annotiert. `2` oder mehr: Jeder Annotator zeichnet seine eigenen Rahmen, ohne die der anderen zu sehen, siehe [Mehrere Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html). |
| Agree: overlap ≥ % | Mindestüberlappung zueinander gehörender Rahmen (gedrehte Schnittmenge durch Vereinigung), Standard 85. |
| Agree: angle within ° | Größte Winkelabweichung, Standard 5. |
| Write the reference automatically when all annotators agree | Ein (Standard): Der Server schreibt die gemittelten Rahmen als Referenz. Aus: Jedes Bild geht in die Prüfung. |

## Rahmenvorschläge {#box-suggestions}

Erscheint, wenn der Server einen Dienst für Rahmenvorschläge hat.

|   |   |
| --- | --- |
| Network | Das trainierte Netz des Projekts, aus den Netzen des Dienstes (die Liste zeigt ihre Klassen). Leer bei nur einem Netz: dieses. |
| Descriptions | Für den Detektor mit offenem Vokabular: auf Englisch beschreiben, wie ein Label aussieht, wenn sein Name wenig sagt, eines je Zeile, z. B. `part_a: hexagon nut`. |
| Suggest from confidence % | Vorschläge darunter entfallen, Standard 30. |
| At most boxes per image | Standard 50. |

## Rahmenvorlagen {#box-templates}

**Rahmenvorlagen**: eine Zeile je Label, `label: width x height, angle°`, z. B. `nut: 42 x 18, 0°`. `T` setzt einen Rahmen dieser Größe und Ausrichtung, siehe [Rahmenvorlagen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html#box-templates). Einfacher als Tippen: einen Rahmen der richtigen Größe auswählen und **Als Vorlage speichern** klicken. Eine Zeile löschen entfernt die Vorlage.

## Export für LumiScan Training

Netztyp, Validierungs- und Testanteil und die Labels ohne Ausrichtung des letzten [Exports](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html) bleiben als Vorgabe für den nächsten beim Projekt.

## Linienstärke

**Linienstärke der Rahmen**: die Stärke der Rahmenlinien im Bild, für alle im Projekt. Ändert nur die Anzeige.

# Sicherung und Wiederherstellung – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html

## Was eine Sicherung enthält

Eine Sicherung ist eine tar-Datei mit allem, was der Server außer den Bildern verwaltet:

- die Datenbank: Konten, Gruppenzuordnungen, Projekte und Mitglieder, der Verlauf aller Annotationen, Überarbeitungshinweise,
- die Dateien des Konfigurationsordners: Konfiguration, Geheimnisdateien, Zertifikate,
- der Ordner `tls` neben der Konfiguration: das HTTPS-Zertifikat, damit die Clients ihm nach einer Wiederherstellung weiter vertrauen,
- die Einstellungen jedes Projekts.

Bilder und Annotationsdateien werden mit den Projektordnern selbst gesichert (Ihre übliche Dateisicherung) oder je Projekt mit dem [Export](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html#exporting-and-importing).

> [!WARNING]
> Sicherungen enthalten Passwort-Hashes und Geheimnisse. Bewahren Sie sie so sorgfältig auf wie den Server selbst.

## Automatische Sicherungen

Alle `backup.every_hours` Stunden (Standard 24) in `backup.dir` (Standard `backups` neben der Konfiguration). Die neuesten `backup.keep` (Standard 14) bleiben erhalten.

## Im Browser

Admins: Ihr Name → **Benutzer und Anmeldung** → **Sicherungen**. Die Liste zeigt die Sicherungen auf dem Server; **Jetzt sichern** erstellt eine, **Herunterladen** lädt sie herunter.

![Reiter Sicherungen: Inhalt einer Sicherung, Zeitplan und Ordner der automatischen Sicherung, die Liste der Sicherungen mit Herunterladen und die Schaltfläche Jetzt sichern](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/backups.png)

## Auf der Befehlszeile

Auch während der Server läuft:

```none
lumiscan-annotation-server --config <Konfiguration> --backup D:\Backups\annotation.tar
```

## Wiederherstellen

1. Stoppen Sie den Server.
2. Stellen Sie wieder her:
   ```none
   lumiscan-annotation-server --config <Konfiguration> --restore <Sicherung.tar>
   ```
3. Starten Sie den Server.

Die aktuelle Datenbank und jede Datei, die die Wiederherstellung ersetzt, bleiben daneben als `…before-restore-<Zeit>` erhalten. Sitzungen werden nicht wiederhergestellt: Alle melden sich neu an. Die Wiederherstellung verweigert den Start, solange der Server auf seinem Port antwortet (`--force` setzt sich darüber hinweg).

# Sprachen und Übersetzungen – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/languages-and-translations.html

LumiScan Annotation Web gibt es in diesen Sprachen:

| Sprache | Code |
| --- | --- |
| English (Englisch) | `en` |
| Deutsch | `de` |
| Español (Spanisch) | `es` |
| Français (Französisch) | `fr` |
| 中文（简体） (Chinesisch, vereinfacht) | `zh-CN` |

Die Texte werden auf Englisch geschrieben; die anderen Sprachen sind Übersetzungen davon.

## Sprache wählen

Beim ersten Besuch verwendet die App die Sprache des Browsers. Gibt es für diese keine, verwendet sie Englisch.

So wählen Sie eine andere Sprache:

- auf der Anmeldeseite: die Sprachauswahl unten auf der Anmeldekarte,
- nach der Anmeldung: **Ihr Name → Sprache** (in der englischen Oberfläche **Language**).

![Der Dialog Sprache: Wie im Browser, English, Chinesisch (vereinfacht), Français, Deutsch und Español als Schaltflächen; die gewählte Sprache ist gelb umrandet](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/_images/screens/language-dialog.png)

Die Wahl wird mit Ihrem Konto gespeichert. Sie gilt in jedem Browser und an jedem PC, an dem Sie sich anmelden, auch in der Einzelplatz-Installation. **Wie im Browser** entfernt die gespeicherte Wahl: Die App folgt wieder der Sprache des Browsers.

Datum und Uhrzeit erscheinen so, wie die gewählte Sprache sie schreibt. Labels, Ordner- und Dateinamen sowie Hinweise erscheinen so, wie sie geschrieben wurden.

## Texte ändern und Sprachen hinzufügen

Administratoren können jeden Text der Oberfläche ändern und Sprachen hinzufügen, ohne neue Version und ohne Neustart. Die Texte stehen in **Übersetzungstabellen**, einer JSON-Datei je Sprache:

```json
{
  "_meta": { "name": "Deutsch", "english": "German" },
  "messages": {
    "Save": "Speichern",
    "{n} images added": "{n} Bilder hinzugefügt"
  }
}
```

Der Schlüssel jedes Eintrags ist der englische Text, der Wert der angezeigte Text. `_meta.name` ist der Name in der Sprachliste, `_meta.english` der englische Name darunter.

Der Server liest zwei Orte und führt sie zusammen:

| Ordner | Inhalt |
| --- | --- |
| `www/i18n` im Installationsordner | Die Tabellen, die mit der App kommen. Jedes Update ersetzt sie: nicht ändern. |
| `translations` neben der Konfiguration | Ihre eigenen Tabellen. Ein Update rührt sie nie an. Einen anderen Ordner legt `translations_dir` fest (siehe [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html)). |

Ein Eintrag in Ihrer eigenen Tabelle hat Vorrang vor dem mitgelieferten. Ein leerer Eintrag wird ignoriert.

### Einen Text ändern

1. Kopieren Sie die Tabelle der Sprache aus `www/i18n`, etwa `de.json`, in den Ordner `translations` (legen Sie ihn bei Bedarf an).
2. Behalten Sie nur die Einträge, die Sie ändern möchten, oder alle. Ändern Sie die Texte auf der rechten Seite.
3. Speichern Sie die Datei als UTF-8.
4. Laden Sie die Seite im Browser neu. Die neuen Texte gelten sofort.

Beispiel: In Ihrem Unternehmen heißt ein Rahmen „Box“ und ein Annotator „Labeler“:

```json
{
  "messages": {
    "New box": "Neue Box",
    "Annotators per image": "Labeler je Bild"
  }
}
```

Als `translations/de.json` gespeichert, ändert das die deutsche Oberfläche; alle anderen Texte bleiben, wie sie mitgeliefert werden.

### Eine Sprache hinzufügen

Kopieren Sie `en.json` aus `www/i18n` nach `translations/<code>.json`, etwa `it.json` für Italienisch oder `pt-BR.json` für brasilianisches Portugiesisch, setzen Sie `_meta` und übersetzen Sie die Texte. Die Sprache erscheint beim nächsten Neuladen in der Sprachliste. Nicht übersetzte Einträge zeigen den englischen Text.

### Regeln für die Texte

- Lassen Sie Platzhalter in geschweiften Klammern genau so, wie sie sind: `{name}`, `{n}`, `{total}`. Sie werden durch Namen und Zahlen ersetzt. Ihre Reihenfolge im Satz darf sich ändern.
- Texte, die mit einem Leerzeichen enden oder beginnen, werden mit anderen Texten zusammengesetzt: Behalten Sie das Leerzeichen.
- Eine Tabelle, die kein gültiges JSON ist, wird ignoriert, und das Serverprotokoll nennt sie. Prüfen Sie die Datei mit einem JSON-Validator, wenn eine Änderung nicht erscheint.
- Nach einem Update erscheinen neue Texte der neuen Version auf Englisch, bis Ihre eigene Tabelle sie ebenfalls enthält. Die Tabellen in `www/i18n` der neuen Version zeigen, welche Texte es gibt.

> [!NOTE]
> Die spanische, französische und chinesische Tabelle wurden sorgfältig übersetzt, aber noch nicht von Muttersprachlern geprüft. Korrekturen sind willkommen: Senden Sie Ihre Tabelle an HD Vision Systems, damit die nächste Version sie enthält.

# Annotationsdateien – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html

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](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html)):

|   |   |
| --- | --- |
| `<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/backup-and-restore.html).

# Bildformate – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html

| Format | Hinweise |
| --- | --- |
| PNG (`.png`) | Das Format des Desktop-Werkzeugs und von LumiScan Training. Wird unverändert angezeigt und exportiert. |
| JPEG (`.jpg`, `.jpeg`) | Wird unverändert angezeigt; für LumiScan Training als PNG exportiert. |
| BMP (`.bmp`) | Wird unverändert angezeigt; als PNG exportiert. |
| TIFF (`.tif`, `.tiff`) | Auch mehrseitig. Der Browser kann TIFF nicht anzeigen, daher sendet der Server jede Seite als PNG. Als PNG exportiert. |

## Annotationsdateien und Namen

Die Rahmen eines Bildes stehen in `<Name>.csv` daneben, der Speicherverlauf in `<Name>.json` (siehe [Annotationsdateien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html)). Zwei Bilder eines Ordners dürfen deshalb ohne Endung nicht gleich heißen: Liegen `part_01.png` und `part_01.jpg` beide dort, wird nur das PNG gelistet (dann JPEG, BMP, TIFF). [Bilder hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html) im Browser überspringt ein solches Bild.

## Mehrseitiges TIFF

Jede Seite eines mehrseitigen TIFF ist ein eigenes Bild:

| In der Liste | Name in der REST-API | Annotationsdatei |
| --- | --- | --- |
| scan.tif · page 1 | `scan.tif#1` | `scan_page001.csv` |
| scan.tif · page 2 | `scan.tif#2` | `scan_page002.csv` |
| scan.tif · page 3 | `scan.tif#3` | `scan_page003.csv` |

Ein TIFF mit einer einzigen Seite erscheint als `scan.tif` mit `scan.csv`. Vorschaubilder und Kopien mit geringerer Auflösung in der Datei sind keine Seiten.

Eine einzelne Seite lässt sich in der App nicht löschen, weil die Datei die anderen Seiten enthält. Löschen oder ersetzen Sie stattdessen die Datei im Projektordner.

## Bittiefe

8-Bit-Grau- und Farbbilder behalten ihre Pixel. 16-Bit-TIFF-Seiten werden für Anzeige, Vorschläge und Export auf 8 Bit reduziert, und zwar nach der tatsächlich genutzten Bittiefe: Ist der hellste Wert höchstens 1023, gilt die Seite als 10 Bit, bis 4095 als 12 Bit, bis 16383 als 14 Bit, sonst als 16 Bit. Ein 12-Bit-Kamerabild in 16 Bit erscheint so mit seinem vollen Helligkeitsumfang statt fast schwarz.

## In den Exporten

LumiScan Training liest `<Name>.png` neben jeder `<Name>.csv`. Der [Export](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html) schreibt JPEG, BMP und TIFF-Seiten daher als PNG (verlustfrei): Aus `part_07.jpg` wird `part_07.png`, aus Seite 2 von `scan.tif` wird `scan_page002.png`. Der COCO-Export behält PNG- und JPEG-Dateien und schreibt BMP und TIFF-Seiten als PNG.

# REST-API – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/rest-api.html

Alles, was der Browser tut, läuft über die REST-API des Servers; andere Programme können sie ebenso nutzen, etwa um Annotationen zu importieren oder die Statistik zu lesen.

## Grundlagen

- Alle Routen liegen unter `/api`; Anfragen und Antworten sind JSON. `folder` und `name` sind Query-Parameter.
- Alles außer `GET /api/status` und den Anmelderouten braucht eine Sitzung: Melden Sie sich mit `POST /api/auth/login` an und senden Sie das Sitzungs-Cookie mit jeder Anfrage.
- Ändernde Anfragen (POST, PUT, DELETE) brauchen den Header `X-Requested-With: lsa`.
- Der Benutzer ist immer der angemeldete. Routen zu Bildern, Einstellungen, Verlauf und Hinweisen nehmen `project=<ID>` (Standard: das einzige Projekt des Benutzers, sonst `default`).
- Fehler: `{"error": "<Code>", "message": "<Text>"}` mit dem HTTP-Status (400 fehlerhafte Anfrage, 401 nicht angemeldet, 403 Rolle fehlt, 404 nicht gefunden, 409 Konflikt, 423 gesperrt).

```bash
curl -c cookies.txt -H "X-Requested-With: lsa" -H "Content-Type: application/json" \
     -d '{"username":"anna","password":"..."}' https://annotation.example.com/api/auth/login
curl -b cookies.txt "https://annotation.example.com/api/images?project=line-5&folder=2026-10-28"
```

## Routen

Rolle in Klammern: **Admin** ist der Server-Admin; die anderen Rollen sind die Rollen des Benutzers im Projekt.

### Anmeldung und Benutzer

| Methode und Pfad | Zweck |
| --- | --- |
| `GET /status` | Version, Lizenzstatus, angenommene Bildformate und die Grenze für hochgeladene Dateien (öffentlich) |
| `GET /auth/providers` | Angebotene Anmeldeverfahren (öffentlich) |
| `POST /auth/login` | `{username, password}`: lokales Konto, dann Verzeichnis → Sitzungs-Cookie |
| `GET /auth/oidc/start`, `/auth/oidc/callback` | Single Sign-on (Browser-Weiterleitungen) |
| `POST /auth/logout` | Sitzung beenden; liefert bei Single-Sign-on-Sitzungen die Abmeldeadresse des Anbieters |
| `GET /auth/me` | Der angemeldete Benutzer, seine Rollen und `settings` (persönliche Einstellungen wie `language`) |
| `PUT /auth/settings` | `{language: "de"}`: persönliche Einstellungen mit dem Konto speichern; `null` entfernt eine (dann gilt wieder die Sprache des Browsers) |
| `GET /i18n` | Sprachen der Oberfläche: `{languages: [{code, name, english}]}` (öffentlich) |
| `GET /i18n/<code>` | Die Übersetzungstabelle einer Sprache, zusammengeführt aus der mitinstallierten Tabelle und dem Ordner `translations` (öffentlich; ETag) |
| `POST /auth/password` | `{current, password}`: eigenes Passwort ändern (lokale Konten) |
| `GET/POST /admin/users`, `PUT/DELETE /admin/users/<Name>`, `POST /admin/users/<Name>/password` | Benutzerverwaltung (Admin) |
| `GET/PUT /admin/mappings` | Zuordnungen Gruppe → Rolle (Admin) |
| `GET /admin/auth`, `POST /admin/auth/test-ldap` | Konfigurierte Anmeldeverfahren, Verzeichnisanmeldung testen (Admin) |
| `GET/POST /admin/backups`, `GET /admin/backups/<Datei>` | Sicherungen auflisten, erstellen und herunterladen (Admin) |

### Projekte

| Methode und Pfad | Zweck |
| --- | --- |
| `GET /projects` | Projekte des Benutzers mit seinen Rollen; für Admins auch die S3-Ziele |
| `POST /projects` | `{name, description, folder?, storage?, prefix?, openToAll}`: neues Projekt (Admin) |
| `GET/PUT /projects/<ID>` | Details; Name, Beschreibung, offen für alle, Mitglieder (Project admin) |
| `DELETE /projects/<ID>` | `{deleteFiles}`: Projekt entfernen (Admin) |
| `GET /projects/<ID>/export[?history=0]` | Die Projektdatei (tar) (Admin) |
| `POST /projects/import`, `PUT /projects/import/<Upload>?offset=`, `POST /projects/import/<Upload>/finish` | Projektdatei in Stücken hochladen und als neues Projekt entpacken (Admin) |
| `GET /people` | Personen mit einer Rolle im Projekt (als Empfänger für Hinweise) |

### Bilder und Annotationen

| Methode und Pfad | Zweck |
| --- | --- |
| `GET /folders` | Unterordner des Projekts |
| `GET /images?folder=` | Bilder mit Annotations- und Sperrstatus, offenen Hinweisen, Rahmenanzahl und Labels der Referenzannotation, nach der Bewertung die Unsicherheit des Netzes, die Exportmenge (`set`), die Fertig-Markierung (`done`, `doneBy`, `doneAt`), bei TIFF-Seiten `file` und `page`; bei mehreren Annotatoren auch Anzahlen und Prüfstand |
| `GET /image?folder=&name=` | Das Bild: PNG, JPEG und BMP wie gespeichert, TIFF-Seiten als PNG (eine Seite heißt `scan.tif#2`, URL-kodiert `scan.tif%232`) |
| `PUT /image/done?folder=&name=` | `{"done": true}` oder `false`: Bild als fertig markieren oder die Markierung entfernen (Annotator, Reviewer) |
| `PUT /images/upload?folder=&name=` | Eine Bilddatei hinzufügen, gesendet als Inhalt (`application/octet-stream`); `newFolder=1` legt den Ordner an; größere Dateien in Stücken mit `offset` (bisherige Bytes) und `total` (Dateigröße). 409 `exists`, wenn der Name oder seine Annotationsdatei vergeben ist (Project admin) |
| `GET /annotations?folder=&name=[&layer=annotator]` | Rahmen, Bildgröße, Revision, Sperre. `layer=annotator`: Ihre eigene Version |
| `PUT /annotations?folder=&name=[&layer=annotator]` | Speichern `{session, baseRevision, boxes, force?}` → 409 bei Konflikt, 423 bei Sperre |
| `POST/DELETE /lock?folder=&name=[&layer=annotator]` | Bearbeitungssperre nehmen, erneuern oder freigeben (`{session}`) |
| `DELETE /image?folder=&name=` | Ein Bild mit Dateien, Versionen, Verlauf und Hinweisen löschen (Project admin) |
| `POST /geometry/fit-box` | Kleinster gedrehter Rahmen um `{points: [[x, y], …]}` |

Ein Rahmen ist `{"cx": 412.3, "cy": 267.8, "width": 188.0, "height": 71.4, "angle": -0.385, "label": "bracket", "metadata": null}` (Winkel in Radiant).

### Verlauf, Hinweise, Einstellungen

| Methode und Pfad | Zweck |
| --- | --- |
| `GET /history?folder=&name=[&layer=annotator&owner=]`, `GET /history/version?id=` | Gespeicherte Versionen einer Annotation; eine Version mit ihren Rahmen |
| `GET /notes?folder=&name=`, `GET /notes/open[?mine=1]` | Überarbeitungshinweise eines Bildes; offene Hinweise des Projekts |
| `POST /notes`, `PUT/DELETE /notes/<ID>` | `{folder, name, text, assignee, x?, y?}`; `{status, reply, text}`; löschen (Verfasser oder Project admin) |
| `GET /settings`, `PUT /settings` | Projekteinstellungen (ändern: Project admin) |
| `POST /labels` | Ein Label zur gemeinsamen Liste hinzufügen (Annotator, Reviewer) |

### Prüfung und Vorschläge

| Methode und Pfad | Zweck |
| --- | --- |
| `GET /compare?folder=&name=` | Die Rahmen aller Annotatoren, zugeordnete Objekte und Abweichungen (Reviewer) |
| `GET /statistics[?folder=]` | Übereinstimmungsstatistik für einen Ordner oder das Projekt (Reviewer) |
| `POST /preannotate?folder=&name=` | Rahmenvorschläge; Body `{boxes?, labels?}`; 501 ohne Dienst, 502, wenn keiner antwortet |
| `GET /preannotate/services` | Die Dienste für Rahmenvorschläge, ihre Backends und Netze |
| `POST /uncertainty/scan` | `{folder, includeAnnotated?, rescore?}`: Das Netz bewertet die Bilder des Ordners im Hintergrund (Annotator) |
| `GET /uncertainty/status`, `POST /uncertainty/cancel` | Fortschritt der Bewertung; abbrechen |
| `GET /training-export/preview` | Was ein Export für LumiScan Training enthielte; Parameter `name`, `network`, `validation`, `test`, `together=1`, `folder` (wiederholbar), `nonRotable` (wiederholbar) (Reviewer) |
| `GET /training-export` | Der Export als ZIP-Datei, gleiche Parameter (Reviewer) |
| `GET /coco-export` | Der COCO-Export, gleiche Parameter und dazu `format=zip` (Bilder und Annotationen) oder `format=json` mit `set=all`, `train`, `val` oder `test` (Reviewer) |

# Versionshinweise – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/release-notes.html

Diese Seite führt die Änderungen jeder Version von LumiScan Annotation Web auf, die neueste zuerst. Jeder Eintrag ist gegliedert in **Neue Funktionen**, **Verbesserungen**, **Fehlerbehebungen** und **Leistung**; **Hinweise zum Update** sagen, worauf Sie achten sollten, wenn Sie die Version über eine ältere installieren.

Zum Aktualisieren installieren Sie die neue Version über die alte ([Server](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/installing-the-server.html) oder [Einzelplatz-Setup](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/single-pc-installation.html)). Projekte, Annotationen, Konten und Einstellungen bleiben erhalten. Laden Sie zur Sicherheit vorher eine Sicherung herunter, unter **Ihr Name → Benutzer und Anmeldung → Sicherungen** (siehe [Sicherung und Wiederherstellung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html)).

Die Namen von Schaltflächen und Menüs stehen hier so, wie die deutsche Oberfläche sie zeigt (ab Version 2.4).

## Version 2.4.1.0 {#v2-4-1}

Alle Texte der Oberfläche erscheinen jetzt in der gewählten Sprache, und das deutsche Handbuch zeigt die deutsche Oberfläche.

### Verbesserungen

- Größen und Prozentwerte erscheinen so, wie die gewählte Sprache Zahlen schreibt, auf Deutsch etwa 2,0 GB und 96,6 %.
- Deutsches Handbuch: Alle Bildschirmfotos und Videos zeigen die deutsche Oberfläche, und Schaltflächen und Menüs heißen so wie in der deutschen Oberfläche.

### Fehlerbehebungen

- Einige Texte erschienen in jeder Sprache noch auf Englisch: die Gründe für Unterschiede im Prüfmodus (etwa „overlap only 74 %“), die Schaltflächen **Löschen**, die Anzahl offener Überarbeitungshinweise, der Hinweis in **Mitglieder & Zugriff**, Breite und Höhe des Interessensbereichs, Text und Status von **Mit Netz bewerten** sowie die Fehlermeldungen beim Hochladen und Laden von Bildern.

## Version 2.4.0.0 {#v2-4}

Die Oberfläche spricht jetzt fünf Sprachen. Bearbeitungssperren verhalten sich freundlicher, wenn mehrere Personen gleichzeitig arbeiten, und die App startet schneller.

### Neue Funktionen

- **Oberfläche in fünf Sprachen:** Englisch, Deutsch, Spanisch, Französisch und Chinesisch (vereinfacht). Die App startet in der Sprache des Browsers, auf Englisch, wenn es für diese keine gibt.
- **Sprache mit dem Konto gespeichert:** Wählen Sie die Sprache auf der Anmeldeseite oder unter **Ihr Name → Sprache**. Ihre Wahl gilt in jedem Browser und an jedem PC, an dem Sie sich anmelden. **Wie im Browser** kehrt zur Sprache des Browsers zurück.
- **Eigene Texte und Sprachen ohne neue Version:** Administratoren können Texte korrigieren, die Begriffe ihres Unternehmens verwenden oder eine Sprache hinzufügen, indem sie eine Übersetzungstabelle in den Ordner `translations` des Servers legen. Die Änderung gilt beim nächsten Neuladen der Seite, ohne Neustart. Siehe [Sprachen und Übersetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/languages-and-translations.html).

### Verbesserungen

- Datum und Uhrzeit erscheinen so, wie die gewählte Sprache sie schreibt.
- Die meisten Meldungen des Servers (etwa „Das aktuelle Passwort ist falsch.“) erscheinen ebenfalls in der gewählten Sprache.
- Bevor ein Update das Format der Datenbank ändert, behält der Server jetzt eine Kopie der alten Datenbank daneben (etwa `annotation-server.db.v3.bak`). Zurück zur vorigen Version heißt dann nur: diese installieren und die Kopie an die Stelle der Datenbank setzen.
- Neue Einstellung `translations_dir` in der Konfiguration (siehe [Konfiguration](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html)).

### Fehlerbehebungen

- Ein Bild, das nur lesbar war, weil jemand anderes oder ein anderes eigenes Fenster es offen hatte, blieb nur lesbar, bis es neu geöffnet wurde. Jetzt wird es von selbst bearbeitbar, sobald es frei ist, und die App meldet das.
- Ein Fenster, das seine Bearbeitungssperre an jemand anderen verloren hatte, konnte die Sperre im Hintergrund zurückholen, während es das Bild weiter nur lesbar zeigte. Das Bild war dann für alle gesperrt. Behoben.
- Downloads mit Umlauten, Akzenten oder chinesischen Zeichen im Namen (Exporte, Projektdateien, Sicherungen) kamen in manchen Browsern mit verstümmeltem Dateinamen an. Der genaue Name bleibt jetzt immer erhalten.

### Leistung

- Schnellerer Start: Die App wird geladen, während die Übersetzungen abgerufen werden, und die zuvor gewählte Sprache kommt zusammen mit der Liste der Sprachen.
- Unveränderte Übersetzungstabellen werden nicht erneut übertragen: Der Browser verwendet seine Kopie.
- Das Hinzufügen von Bildern im Browser braucht je Datei eine Auflistung des Ordners weniger; das spart in großen S3-Buckets viele Anfragen.

### Hinweise zum Update

- Das Format der Datenbank ändert sich (Version 4). Ältere Versionen können die aktualisierte Datenbank nicht öffnen. Der Server behält die alte als `annotation-server.db.v3.bak` daneben: Um zu 2.3 zurückzukehren, beenden Sie den Server, installieren 2.3 und ersetzen `annotation-server.db` durch diese Kopie (in der Zwischenzeit mit 2.4 Geändertes geht dann verloren).

## Version 2.3.0.0 {#v2-3}

Mehr Bildformate, Bilder direkt im Browser hinzufügen, Bilder als fertig markieren und ein Export für andere Annotations- und Trainingswerkzeuge.

### Neue Funktionen

- **JPEG, BMP und TIFF** neben PNG, auch **mehrseitiges TIFF**: Jede Seite ist ein eigenes Bild mit eigener Annotationsdatei (siehe [Bildformate](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html)). 16-Bit-Bilder erscheinen mit dem Helligkeitsumfang, den sie tatsächlich nutzen (10, 12, 14 oder 16 Bit).
- **Bilder im Browser hinzufügen** (Projekt-Admins): **+ Bilder hinzufügen** über der Bildliste nimmt Dateien, einen ganzen Ordner oder Drag-and-drop entgegen, in einen vorhandenen oder einen neuen Ordner. Große Dateien werden in Stücken übertragen. Funktioniert mit Ordnern auf dem Server und mit S3-Buckets (siehe [Bilder hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/adding-images.html)).
- **Als fertig markieren:** **Als fertig markieren** neben **Speichern** oder `Umschalt+D` (speichern, markieren, weiter) markiert ein Bild als abgeschlossen, auch ohne Rahmen. Die Bildliste zeigt ein ✓ und die Anzahl, **Anzeigen** filtert danach.
- **COCO-Export:** **Export** bietet das COCO-Format an, das CVAT, Label Studio, FiftyOne und viele Trainingsframeworks lesen: Bilder mit Annotationen als ZIP oder nur die Annotationen als JSON, für eine Menge oder alle (siehe [Annotationen exportieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html)).
- **Mengenfilter:** Die Bildliste zeigt, in welche Menge (Training, Validierung, Test) der Export jedes Bild legt, und filtert danach (**Menge**).

### Verbesserungen

- **Jeden Ordner zusammenhalten** wird mit den Exporteinstellungen des Projekts gespeichert.
- Die eingebauten Netze für Rahmenvorschläge lesen alle Bildformate.
- Fertig-Markierungen gehen in den Projektexport und -import mit.
- Neue Einstellung `upload_max_mb` für die größte Datei, die im Browser hinzugefügt werden kann.

### Leistung

- TIFF-Seiten werden einmal für den Browser umgewandelt und dann zwischengespeichert; die Seitenliste einer TIFF-Datei wird nur neu gelesen, wenn sich die Datei ändert.
- Hinzugefügte Bilder erscheinen sofort in der Liste, ohne auf den nächsten Durchlauf durch den Ordner zu warten.

### Hinweise zum Update

- Das Format der Datenbank ändert sich (Version 3). Ältere Versionen können die aktualisierte Datenbank nicht öffnen.

## Version 2.2.0.0 {#v2-2}

LumiScan Annotation auf einem einzelnen PC mit eigenem Fenster, schnelleres Annotieren von Serien, die richtigen Bilder finden und ein direkter Weg zu LumiScan Training.

### Neue Funktionen

- **Einzelplatz-Installation:** ein Windows-Installationsprogramm mit Verknüpfung im Startmenü und auf dem Desktop. LumiScan Annotation läuft in einem eigenen Fenster, ohne Anmeldung, und nimmt nur Verbindungen vom selben PC an (siehe [Einzelplatz-Installation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/single-pc-installation.html)).
- **Rahmen kopieren:** die Rahmen des vorigen Bildes übernehmen (`V`), Rahmen auf die nächsten Bilder einer Serie kopieren sowie einzelne oder alle Rahmen mit `Strg+C` / `Strg+V` kopieren und einfügen, auch zwischen Bildern (siehe [Rahmen kopieren und Vorlagen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/copying-boxes-and-templates.html)).
- **Rahmenvorlagen:** einen Rahmen als typische Größe und Ausrichtung seines Labels speichern; `T` setzt einen am Mauszeiger.
- **Bilder finden:** Suche nach Dateinamen, Filter nach Zustand, Label oder Unsicherheit des Netzes, Sortierung der Liste (siehe [Bilder finden und sortieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html)).
- **Active Learning:** **Mit Netz bewerten** lässt das Netz des Projekts die Bilder bewerten; **Netz am unsichersten zuerst** zeigt die Bilder, bei denen Annotieren am meisten bringt.
- **Export für LumiScan Training:** ein fertiges LumiScan-Training-Projekt als ZIP, mit stabiler Aufteilung in Trainings-, Validierungs- und Testmenge.
- **Eingebaute Rahmenvorschläge:** Trainierte LumiScan-Netze laufen im Server selbst, ohne eigenen Dienst und ohne Python.
- **Update-Prüfung:** Projekt-Admins sehen, wenn eine neuere Version verfügbar ist (Einzelplatz-Installation; auf Servern wahlweise).

### Verbesserungen

- Beim Schließen des Fensters wird auch unter macOS und Linux nach ungespeicherten Änderungen gefragt (zuvor nur unter Windows).

### Fehlerbehebungen

- Windows: Konfigurations- und Datenordner unterhalb von Benutzer- oder Ordnernamen mit Umlauten funktionierten nicht.

### Leistung

- Die Bildliste kennt Rahmenanzahl und Labels jedes Bildes aus dem Bildindex; der Filter nach Label liest die Annotationsdateien daher nicht erneut.
- Rahmenvorschläge der eingebauten Netze brauchen keinen Umweg über einen eigenen Dienst.

## Version 2.1.0.0 {#v2-1}

Der Schritt vom Einzelwerkzeug zur Teamanwendung: Anmeldung mit Rollen, Projekte, mehrere Annotatoren je Bild, Verlauf und Überarbeitungshinweise.

### Neue Funktionen

- **Anmeldung und Rollen:** lokale Konten, Active Directory / LDAP und Single Sign-on mit OpenID Connect (Keycloak, Microsoft Entra ID, Okta und andere); Rollen Annotator, Prüfer und Admin, vom Server geprüft (siehe [Benutzer und Rollen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html), [Anmeldeverfahren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/sign-in-methods.html)).
- **Projekte:** unabhängige Annotationsaufträge mit eigenem Ordner, eigenen Einstellungen, Mitgliedern, Verlauf und Hinweisen; Export und Import eines ganzen Projekts als eine Datei (siehe [Projekte](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html)).
- **Projekte in S3-Buckets:** AWS S3, MinIO, SeaweedFS und andere S3-kompatible Speicher (siehe [Projekte in S3-Buckets](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html)).
- **Mehrere Annotatoren je Bild:** blindes Annotieren, automatische Referenz, wenn alle übereinstimmen, ein Prüfmodus mit nummerierten Unterschieden und Statistiken zur Übereinstimmung (siehe [Mehrere Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html)).
- **Versionsverlauf und Rückgängig:** Jede gespeicherte Version einer Annotation lässt sich über dem Bild ansehen und wiederherstellen; Rückgängig und Wiederherstellen beim Bearbeiten (siehe [Verlauf und Rückgängig](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/history-and-undo.html)).
- **Überarbeitungshinweise:** Anweisungen zu einem Bild für eine Person, bei Bedarf an einen Rahmen geheftet, mit Antworten (siehe [Überarbeitungshinweise](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/revision-notes.html)).
- **Rahmenvorschläge:** Ein Dienst mit Grounding DINO und SAM 2 oder mit trainierten LumiScan-Netzen schlägt Rahmen vor (`P`) (siehe [Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestions.html)).
- **Genaues Zeichnen:** Lupe mit Fadenkreuz und Pixelraster, Mittellinien durch jeden Rahmen, ein zweiter Zeichenmodus (**Kantenrechteck**, `E`) und das Drehen der Unterkante eines Rahmens (`R`).
- **Sicherung und Wiederherstellung** von Datenbank und Konfiguration, automatisch und auf Abruf (siehe [Sicherung und Wiederherstellung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html)).

### Verbesserungen

- **HTTPS als Standard** mit einem selbstsignierten Zertifikat, das der Server selbst erstellt und erneuert.
- Antworten werden für Browser, die das unterstützen, komprimiert.
- Neue Anmeldeseite mit den LumiScan-Apps.
- `A` / `D` überspringen Bilder, die der Filter der Bildliste ausblendet.

### Fehlerbehebungen

- Ein zweiter Server auf demselben Port teilte sich unter Linux den Port stillschweigend; jetzt startet der Server nicht und nennt den Grund.
- Der Hinweisbalken für nur lesbare Bilder sagte „prüft“ auch in Projekten mit einem Annotator je Bild, in denen die andere Person annotiert; jetzt sagt er „bearbeitet“.

### Leistung

- Zeichnen, Verschieben von Rahmen, Verschieben der Ansicht und die Lupe laufen auch mit vielen Rahmen flüssig: etwa fünf- bis neunmal weniger Arbeit je Mausbewegung.
- Bildlisten und Statistiken kommen aus einem Index in der Datenbank, statt jede Datei neu zu lesen.
- Bilder aus S3-Buckets werden auf dem Server zwischengespeichert und nur bei Änderungen neu geladen.

### Hinweise zum Update

- Ein Server, der auf allen Adressen mit einfachem HTTP lauschte, antwortet jetzt auf demselben Port mit HTTPS. Setzen Sie `"https": "off"` in der Konfiguration, um bei HTTP zu bleiben.
- Der Zugangscode (`auth_token`) der Version 2.0 ist durch die Anmeldung ersetzt; eine Konfiguration, die ihn noch enthält, wird mit einem Hinweis abgelehnt.

## Version 2.0.0.0 {#v2-0}

Die erste Web-Version, Nachfolger des Desktop-Programms LumiScan Annotation 1.7.

### Neue Funktionen

- Annotieren im Browser, bereitgestellt von einem Server für Windows und Linux.
- Annotationsdateien Byte für Byte wie vom Desktop-Werkzeug geschrieben, sodass LumiScan Training sie unverändert liest.
- Dieselbe Art, orientierte Rahmen zu zeichnen, wie im Desktop-Werkzeug, mit dessen Tastenkombinationen, Helligkeit und Kontrast, Interessensbereich und Labels auf den Tasten 1 bis 9.
- Mehrere Personen gleichzeitig: Bearbeitungssperren je Bild, eine nur lesbare Ansicht für Bilder, die andere offen haben, und eine Warnung, wenn eine Datei von jemand anderem geändert wurde.

# FAQ – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/faq.html

Kurze Antworten auf häufige Fragen zu LumiScan Annotation Web. Jeder Eintrag verweist auf die Seite mit den Details.

> [!TIP]
> Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-browsers`). Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html) beschrieben.

## Voraussetzungen und Einrichtung

### Welche Browser funktionieren, und müssen Annotatoren etwas installieren? {#faq-browsers}

- **Antwort:** Aktuelle Versionen von Google Chrome, Microsoft Edge und Mozilla Firefox. Annotatoren installieren nichts: Sie öffnen die Adresse des Servers, z. B. `https://annotation-pc:8080/`, und melden sich an. Installiert wird nur der Server, auf einem Rechner in Ihrem Netzwerk.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/requirements.html), [Server installieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/installing-the-server.html)

### Verlassen Bilder das Firmennetz? {#faq-network}

- **Antwort:** Nein. Server, Projektordner oder S3-Buckets und der Dienst für Rahmenvorschläge laufen alle auf Ihren Rechnern. Nur die Browser Ihrer Benutzer greifen darauf zu.
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/description.html), [Vor der Installation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/before-installation.html)

### Warum warnt der Browser, die Verbindung sei nicht sicher? {#faq-certificate-warning}

- **Antwort:** Der Server spricht standardmäßig HTTPS. Ohne eigenes Zertifikat erzeugt er beim ersten Start ein selbstsigniertes, das die Browser noch nicht kennen.
  - Vergleichen Sie den SHA-256-Fingerabdruck in den Zertifikatsdetails der Warnung mit dem, den das Serverprotokoll beim Start zeigt (`HTTPS: SHA-256 fingerprint …`), und fahren Sie dann fort.
  - Um die Warnung loszuwerden, importieren Sie `tls/self-signed-cert.pem` vom Server auf den Clients als vertrauenswürdiges Zertifikat, oder geben Sie dem Server ein Zertifikat der Zertifizierungsstelle Ihres Unternehmens (`tls_cert`, `tls_key`).
  - Hinter einem Reverse Proxy, der TLS übernimmt, bleibt der Server bei unverschlüsseltem HTTP.
- **Mehr:** [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https)

## Desktop-Werkzeug und Dateien

### Können wir das Desktop-Werkzeug LumiScan Annotation weiter nutzen? {#faq-desktop-tool}

- **Antwort:** Ja. Beide schreiben dieselben Dateien, Desktop-Werkzeug und Web-App können also am selben Projektordner arbeiten. Der Server übernimmt Änderungen mit dem Desktop-Werkzeug in den Verlauf (er durchsucht die Ordner alle 60 Sekunden). Ändern beide gleichzeitig dasselbe Bild, meldet das Speichern im Browser einen Konflikt und bietet **Deren Version laden** oder **Mit meiner überschreiben** an; die andere Version bleibt im Verlauf.
- **Mehr:** [Gleichzeitig arbeiten](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/working-at-the-same-time.html), [Annotationsdateien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html)

### Liest LumiScan Training die Dateien unverändert? {#faq-training-files}

- **Antwort:** Ja. `<Bild>.csv` und `<Bild>.json` neben jedem Bild sind byte-gleich mit denen des Desktop-Werkzeugs. Bei mehreren Annotatoren je Bild wird die Referenzannotation genau in diese Dateien geschrieben; das Training liest also nur übereinstimmende oder geprüfte Rahmen.
- **Mehr:** [Annotationsdateien](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/annotation-files.html), [Mehrere Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html)

### Unsere Kameras speichern JPEG oder mehrseitiges TIFF. Müssen wir die Bilder umwandeln?

- **Antwort:** Nein. PNG, JPEG, BMP und TIFF werden gelesen, jede Seite eines mehrseitigen TIFF ist ein eigenes Bild. Der Export schreibt sie für LumiScan Training als PNG.
- **Mehr:** [Bildformate](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html)

## Gemeinsam annotieren

### Können mehrere Personen dasselbe Bild annotieren? {#faq-same-image}

- **Antwort:** Im normalen Modus nicht gleichzeitig: Wer das Bild zuerst öffnet, hat die Bearbeitungssperre; die anderen sehen es nur lesbar, mit einem Hinweisbalken, der nennt, wer es bearbeitet. Die Sperre endet 60 Sekunden, nachdem diese Person das Bild geschlossen hat. Bei mehreren Annotatoren je Bild hat jeder Annotator seine eigene Version, und alle können gleichzeitig am selben Bild arbeiten.
- **Mehr:** [Gleichzeitig arbeiten](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/working-at-the-same-time.html)

### Warum sieht ein Annotator die Rahmen der anderen nicht? {#faq-blind}

- **Antwort:** Bei mehreren Annotatoren je Bild wird absichtlich blind annotiert: Nur unabhängige Annotationen zeigen, wo Bilder mehrdeutig sind. Prüfer sehen alle Versionen nebeneinander und entscheiden.
- **Mehr:** [Mehrere Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html), [Anleitung: Annotationen mit zwei Annotatoren prüfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/check-annotations-with-two-annotators.html)

### Was passiert, wenn zwei Annotatoren übereinstimmen? {#faq-agreement}

- **Antwort:** Der Server schreibt den Mittelwert ihrer Rahmen als Referenzannotation. Das Training verwendet sie, und niemand muss das Bild prüfen. Andernfalls geht das Bild in die Prüfung, sortiert nach den größten Unterschieden zuerst.
- **Mehr:** [Mehrere Annotatoren je Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/several-annotators-per-image.html)

### Wo finde ich die Hinweise für mich? {#faq-notes}

- **Antwort:** **✎ n Hinweise für Sie** in der oberen Leiste öffnet das nächste Bild mit einem Hinweis für Sie. Mit **Antworten** antworten Sie, mit **Fertig** schließen Sie ihn, sobald Sie das Bild korrigiert haben; erledigte Hinweise bleiben sichtbar.
- **Mehr:** [Überarbeitungshinweise](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/revision-notes.html)

### Wie mache ich ein Speichern rückgängig? {#faq-undo}

- **Antwort:** Öffnen Sie **Verlauf**, klicken Sie die frühere Version an, wählen Sie **Wiederherstellen** und dann **Speichern**. Das Speichern fügt eine neue Version hinzu; der Verlauf wird nie umgeschrieben.
- **Mehr:** [Verlauf und Rückgängig](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/history-and-undo.html)

## Rahmenvorschläge

### Warum fehlt **Rahmen vorschlagen**? {#faq-suggest-missing}

- **Antwort:** Der Server hat keinen Dienst für Rahmenvorschläge konfiguriert (`pre_annotation` in der Konfiguration), oder Sie haben im Projekt keine Annotator-Rolle.
- **Mehr:** [Dienst für Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html), [Rahmenvorschläge](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestions.html)

### Werden die Vorschläge mit der Zeit besser? {#faq-suggestions-improve}

- **Antwort:** Ja, wenn Sie das Netz regelmäßig mit den korrigierten Annotationen neu trainieren und das neue Netz in den Dienst legen. Jeder korrigierte Vorschlag ist Trainingsmaterial für das nächste Netz.
- **Mehr:** [Anleitung: Schneller annotieren mit Rahmenvorschlägen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/how-tos/annotate-faster-with-box-suggestions.html)

### Welche Bilder sollten wir zuerst annotieren? {#faq-which-images-first}

- **Antwort:** Die, bei denen das Netz am unsichersten ist. **Mit Netz bewerten** über der Bildliste bewertet den Ordner; **Netz am unsichersten zuerst** sortiert danach.
- **Mehr:** [Rate with network](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/finding-and-sorting-images.html#rate-with-network)

### Wie kommen die Bilder in LumiScan Training? {#faq-training-split}

- **Antwort:** **Export** in der oberen Leiste lädt ein fertiges LumiScan-Training-Projekt mit Trainings- und Validierungsbildern herunter. In den Projektordner von LumiScan Training entpacken und dort öffnen.
- **Mehr:** [Annotationen exportieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html)

### Lassen sich die Annotationen in anderen Werkzeugen verwenden?

- **Antwort:** Ja. **Export** bietet auch das COCO-Format, mit oder ohne Bilder. Übliche Werkzeuge zeichnen jeden orientierten Rahmen aus seinen Ecken (`segmentation`); der genaue Rahmen steht in `obb`.
- **Mehr:** [COCO](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/export-for-lumiscan-training.html#coco)

## Projekte, Zugriff und Sicherungen

### Wie gebe ich einer ganzen Abteilung Zugriff? {#faq-department-access}

- **Antwort:** Tragen Sie ihre Verzeichnisgruppe als Mitglied des Projekts ein oder ordnen Sie die Gruppe unter **Gruppen → Rollen** einer Rolle zu. Mitglieder der Gruppe melden sich mit ihrem Verzeichnis- oder Single-Sign-on-Konto an und erhalten die Rolle ihrer Gruppe.
- **Mehr:** [Gruppen und Rollen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/users-and-roles.html#groups), [Anmeldeverfahren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/sign-in-methods.html)

### Wie schicke ich ein Projekt an HD Vision Systems? {#faq-send-project}

- **Antwort:** **Projekte** → **Export** ergibt eine Datei mit Bildern, Annotationen, Einstellungen und Hinweisen. HD Vision Systems importiert sie, annotiert und schickt sie auf demselben Weg zurück.
- **Mehr:** [Exportieren und importieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects.html#exporting-and-importing)

### Was wird gesichert, und wie oft? {#faq-backup}

- **Antwort:** Der Server sichert die Datenbank (Konten, Projekte, Verlauf, Hinweise), die Konfiguration und das HTTPS-Zertifikat automatisch, standardmäßig alle 24 Stunden, und bewahrt die letzten 14 Sicherungen auf. Bilder und Annotationsdateien werden mit Ihren Ordnern gesichert oder je Projekt mit dem Export.
- **Mehr:** [Sicherung und Wiederherstellung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/backup-and-restore.html)

## Fehlerbehebung {#troubleshooting}

Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html) beschrieben:

- [Die Seite öffnet sich nicht](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-page-does-not-open)
- [Eine Zertifikatswarnung im Browser](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-certificate-warning)
- [Die Anmeldung schlägt fehl](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-sign-in-fails)
- [Angemeldet, aber ohne Zugriff (keine Rolle)](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-no-role)
- [Niemand kann sich als Administrator anmelden](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-no-admin)
- [Das Projekt fehlt in der Liste](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-project-missing)
- [Das Bild ist nur lesbar](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-read-only)
- [„Changed by someone else" beim Speichern](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-changed-by-someone-else)
- [Neue Bilder erscheinen nicht](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-new-images-missing)
- [Keine Vorschläge oder ein Fehler nach **Rahmen vorschlagen**](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-no-suggestions)
- [S3-Projekt: Zugriffs- oder Signaturfehler](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-s3-errors)
- [Der Server startet nicht](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#ts-server-does-not-start)

## Lizenz und Support

### Welche Lizenz brauche ich? {#faq-licence}

- **Antwort:** Diese Version von LumiScan Annotation Web läuft ohne LumiScan Key. Bei Fragen zur Lizenzierung wenden Sie sich an HD Vision Systems.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/requirements.html#licence)

### Wo finde ich weitere Antworten oder Support? {#faq-support}

- **Antwort:** Siehe die [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) der gesamten Dokumentation. Wenden Sie sich an HD Vision Systems unter [info@hdvisionsystems.com](mailto:info@hdvisionsystems.com) oder +49 6221 67219-00, und senden Sie das Serverprotokoll und die Version (`lumiscan-annotation-server --version`).
- **Mehr:** [Protokolle](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html#logs)

# Fehlerbehebung – LumiScan Annotation Web

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/troubleshooting.html

| Problem | Lösung |
| --- | --- |
| Die Seite öffnet sich nicht | Prüfen Sie Adresse und Port (Standard `8080`) und ob die Adresse mit `https://` beginnt. Läuft der Server? Ist der Port in der Firewall des Servers freigegeben? Das Serverprotokoll meldet nach erfolgreichem Start `Listening on https://…`. |
| „Dies ist keine sichere Verbindung" oder eine ähnliche Zertifikatswarnung | Der Server verwendet sein selbstsigniertes Zertifikat. Vergleichen Sie den Fingerabdruck mit dem Serverprotokoll und fahren Sie fort, oder lassen Sie die Clients dem Zertifikat vertrauen, siehe [HTTPS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/configuration.html#https). |
| Der Server startet nicht: „HTTPS: cannot create the self-signed certificate" | Das Konto des Servers darf den Ordner `tls` neben der Konfiguration nicht beschreiben. Geben Sie ihm Schreibrechte oder setzen Sie `tls_cert` und `tls_key`. |
| „Server not reachable" im Status | Die Verbindung zum Server wurde unterbrochen. Ungespeicherte Änderungen bleiben im Browser; speichern Sie erneut, sobald der Server wieder erreichbar ist. |
| Die Anmeldung schlägt fehl | Prüfen Sie Benutzername und Passwort (die Meldung sagt nie, welches falsch ist). Nach 5 Fehlversuchen ist das Konto für 15 Minuten gesperrt. Verzeichnisbenutzer: Anmeldung unter **Benutzer und Anmeldung** → **Anmeldeverfahren** testen. |
| Angemeldet, aber ohne Zugriff (keine Rolle) | Neue Verzeichnis- oder Single-Sign-on-Benutzer ohne Gruppenzuordnung haben keine Rolle. Ein Admin vergibt eine Rolle unter **Benutzer und Anmeldung** oder ordnet die Gruppe zu. |
| Niemand kann sich als Administrator anmelden | Auf dem Server: `lumiscan-annotation-server --config <Konfiguration> --reset-password admin` gibt ein neues Passwort aus. |
| Das Projekt fehlt in der Liste | Sie sind kein Mitglied. Bitten Sie den Projekt-Admin oder einen Server-Admin, Sie oder Ihre Gruppe einzutragen. |
| Das Bild ist nur lesbar | Jemand anderes bearbeitet es (Hinweisbalken und Bildliste nennen die Person), oder Sie haben es in einem anderen Fenster offen. Die Sperre endet 60 Sekunden nachdem das andere Fenster geschlossen wurde. |
| „Changed by someone else" beim Speichern | Die Annotationsdatei wurde geändert, nachdem Sie das Bild geöffnet haben, etwa mit dem Desktop-Werkzeug. Wählen Sie **Deren Version laden** oder **Mit meiner überschreiben**; die andere Version bleibt im Verlauf. |
| Neue Bilder erscheinen nicht | Der Server durchsucht die Ordner alle 60 Sekunden (`index_refresh_seconds`). Warten Sie oder wechseln Sie den Ordner. Die Bilder müssen PNG-, JPEG-, BMP- oder TIFF-Dateien im Projektordner oder in einer Ebene von Unterordnern sein (siehe [Bildformate](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/image-formats.html)); ein Bild, das so heißt wie ein PNG daneben, wird nicht gelistet. |
| **Rahmen vorschlagen** fehlt | Kein Dienst für Rahmenvorschläge in der Konfiguration (`pre_annotation`), oder Sie haben keine Annotator-Rolle. |
| Keine Vorschläge oder ein Fehler nach **Rahmen vorschlagen** | Prüfen Sie den Dienst: `curl …/v1/health` (siehe [Dienst prüfen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/box-suggestion-service.html#checking-the-service)). Das Netz des Projekts muss auf dem Dienst vorhanden sein; seine Klassen müssen zu den Labels des Projekts passen. Bei mehreren Diensten führt einer, der nicht antwortet, nur zu einer Warnung. |
| S3-Projekt: „access denied" / „SignatureDoesNotMatch" / „RequestTimeTooSkewed" | Falsche Schlüssel, fehlende Rechte (siehe [Rechte bei AWS](https://docs.hdvisionsystems.com/de/lumiscan-annotation-web-de/projects-in-s3-buckets.html#aws-permissions)) oder eine Serveruhr, die mehr als 15 Minuten abweicht. |
| Der Server startet nicht: „database is locked" oder Dateifehler | Die Datenbank muss auf einer lokalen Festplatte liegen, nicht auf einer Netzwerkfreigabe. Läuft eine weitere Serverinstanz mit derselben Konfiguration? |
| Die Wiederherstellung startet nicht | Der Server läuft noch. Stoppen Sie ihn zuerst. |

## Protokolle {#logs}

- Der Server schreibt sein Protokoll auf die Konsole und, mit `log_dir`, in rotierende Dateien. Beim Start nennt er Konfiguration, Projekte, Anmeldeverfahren und Dienste für Rahmenvorschläge, und jeden Fehler mit seinem Grund.
- Dienst für Rahmenvorschläge: Ubuntu `journalctl -u lsa-preannotate -f`, Windows `C:\ProgramData\LumiScan\PreAnnotate\default.log`.

Kommen Sie nicht weiter? Wenden Sie sich an HD Vision Systems: [info@hdvisionsystems.com](mailto:info@hdvisionsystems.com), +49 6221 67219-00. Bitte senden Sie das Serverprotokoll und die Version mit (`lumiscan-annotation-server --version`).
