# LumiScan Annotation 1.8.4.3 – complete documentation

> All pages of the LumiScan Annotation 1.8.4.3 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-de/1.8.4/

# LumiScan Annotation

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

|   |   |   |
| --- | --- | --- |
| ![Ein Stapel Kamerabilder von Teilen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/intro/step-1.svg)<br><br>**Bilder Ihrer Teile sammeln.** PNG-Bilder, ein Ordner je Satz. | ![Annotationsfenster mit zwei Teilen in gedrehten Rahmen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/intro/step-2.svg)<br><br>**Jedes Objekt umrahmen.** Gedrehte Rahmen mit drei Klicks, ein Label je Klasse. | ![PNG-, CSV- und JSON-Datei zu einem Bild](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/intro/step-3.svg)<br><br>**Trainingsdaten speichern.** Rahmen als CSV neben jedem Bild, bereit für LumiScan Training. |

LumiScan Annotation ist die Software zum Annotieren von Objekten in Bildern, um Trainingsdaten für neuronale Netze zu erzeugen, etwa für die Objekterkennung mit LumiScan AI Object Matching. Sie zeichnen mit drei Klicks einen gedrehten Rahmen um jedes Objekt und vergeben ein Label je Klasse; die Rahmen werden als CSV-Datei neben jedem Bild gespeichert. Beliebig viele Benutzer und unbegrenzte Annotationen, unter Windows 11.

Zur Lizenzierung siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/requirements.html#licence). Fragen oder eine Fehlermeldung? Siehe [FAQ](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/faq.html).

# Beschreibung – LumiScan Annotation

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

LumiScan Annotation ist die Software, mit der Sie Objekte in einem Bild annotieren können. Sie liefert Daten für das Training und Nachtraining von neuronalen Netzwerken, die später in Aufgaben wie Objekterkennung oder Qualitätsprüfung eingesetzt werden.\
\
Die Software unterstützt eine beliebige Anzahl von Benutzern, die Anpassung der Annotationseinstellungen und eine unbegrenzte Anzahl von Annotationen.\
\

# Voraussetzungen – LumiScan Annotation

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

- Windows 11

## Lizenz {#licence}

Wie LumiScan Annotation lizenziert wird, hängt davon ab, wo Sie es gekauft haben und wo es läuft:

| Gekauft bei | Läuft auf | Lizenzierung |
| --- | --- | --- |
| HD Vision Systems | Windows 11 | Die Lizenz liegt auf Ihrem LumiScan Key. Sie ist ein Jahresabonnement und muss jedes Jahr verlängert werden; die Verlängerung setzt ein gültiges Abonnement voraus.<br><br>[Lizenzierungsweg: gekauft bei HD Vision Systems](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-hdvs.html) |
| ctrlX Store | Windows 11 | Die Lizenz liegt in ctrlX WORKS. Zusätzlich ist der LumiScan Key erforderlich; er schützt die Software vor Reverse Engineering.<br><br>[Lizenzierungsweg: ctrlX Store, Windows](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html) |

Jedes Gerät, auf dem LumiScan Annotation gleichzeitig läuft, benötigt einen eigenen LumiScan Key. Keys können zwischen Geräten ausgetauscht werden.

Wie Sie die CodeMeter Runtime installieren und Lizenzen anfordern, verlängern und an einem anderen PC verwenden, steht in [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/index.html).

# Anleitung: Bilder mit gedrehten Begrenzungsrahmen annotieren – LumiScan Annotation

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/how-tos/annotate-images-with-oriented-bounding-boxes.html

Diese Anleitung führt von der Installation von LumiScan Annotation bis zu einem Satz Bilder, die mit gedrehten Begrenzungsrahmen (Oriented Bounding Boxes) annotiert sind. Die Annotationen sind die Trainingsdaten für neuronale Netze, zum Beispiel für LumiScan AI Object Matching, trainiert mit LumiScan Training.

Am Ende gilt:

- LumiScan Annotation ist installiert und lizenziert.
- Ihre Bilder sind geladen.
- Die Objektklassen sind als Labels angelegt.
- Die Objekte in den Bildern sind mit gedrehten Begrenzungsrahmen markiert, und die Annotationen sind neben den Bildern gespeichert.

Diese Anleitung beschreibt die Bedienung der Software. Wie man gut annotiert - was ein Rahmen umfassen soll, wie mit teilweise verdeckten Objekten umzugehen ist - hängt von der Anwendung ab und wird mit dem Team abgestimmt, das das Netz trainiert.

## Bevor Sie beginnen {#prerequisites}

- Windows-11-PC mit Maus und Tastatur
- LumiScan Key mit einer Lizenz für LumiScan Annotation, siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/requirements.html)
- Das Installationsprogramm `Installer_LumiScan_Annotation_va_b_c_d.exe`, wobei `a.b.c.d` die Version ist
- Die zu annotierenden Bilder als PNG-Dateien

## Wie es zusammenhängt {#overview}

LumiScan Annotation zeigt jeweils ein Bild. Sie zeichnen um jedes Objekt einen Rahmen und geben ihm ein Label, den Namen seiner Klasse. Rahmen lassen sich drehen und passen so zu Objekten, die in beliebigem Winkel liegen.

Beim Speichern werden die Annotationen des Bildes als CSV-Datei neben das Bild geschrieben. Eine JSON-Datei hält fest, wer wann gespeichert hat und welches Bild und welche Datei betroffen sind. Mehrere Benutzer können in denselben Ordnern annotieren: Jedes Speichern wird mit dem in der Anwendung gewählten Benutzer festgehalten.

## Schritt 1 - CodeMeter Runtime installieren {#step-1-codemeter}

LumiScan Annotation wird mit dem LumiScan Key lizenziert und benötigt die CodeMeter Runtime 9.00 oder neuer.

1. Prüfen Sie, ob die CodeMeter Runtime installiert ist, zum Beispiel im Windows-Startmenü.
2. Falls nicht, installieren Sie sie und stecken Sie den LumiScan Key in einen freien USB-Anschluss, wie unter [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html) beschrieben.

## Schritt 2 - LumiScan Annotation installieren {#step-2-install}

1. Schließen Sie alle offenen Anwendungen.
2. Doppelklicken Sie auf `Installer_LumiScan_Annotation_va_b_c_d.exe`.
3. Akzeptieren Sie die Lizenzbedingungen.
4. Behalten Sie den vorgeschlagenen Installationsordner bei oder wählen Sie mit **Browse** einen anderen, dann klicken Sie auf **Next**.
5. Klicken Sie auf **Install**, dann auf **OK** und **Finish**.

LumiScan Annotation lässt sich nun über das Windows-Startmenü starten. Die einzelnen Schritte stehen in [Installation unter Windows](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/installing-lumiscan-annotation-on-windows.html).

## Schritt 3 - Die Bilder vorbereiten {#step-3-images}

Legen Sie die zu annotierenden PNG-Bilder in einen Ordner. Um an mehreren Bildsätzen zu arbeiten, geben Sie jedem Satz einen eigenen Ordner unterhalb eines gemeinsamen Ordners:

```
<Datenordner>
├── <Satz A>
│   ├── image_001.png
│   └── image_002.png
└── <Satz B>
    ├── image_003.png
    └── image_004.png
```

Sie wählen dann einmal den gemeinsamen Ordner und wechseln in der Anwendung zwischen den Sätzen. Siehe [Ordnerstruktur](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/folder-structure.html).

## Schritt 4 - Die Anwendung starten und die Bilder auswählen {#step-4-start}

1. Starten Sie LumiScan Annotation. Beim ersten Start ist das Fenster leer.

2. Klicken Sie auf **Menu > Settings**.

3. Klicken Sie auf **Set Folder** und wählen Sie den Ordner mit den Bildern oder den gemeinsamen Ordner mehrerer Sätze.

   ![Einstellungsfenster von LumiScan Annotation mit den Feldern Data Directory](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/howto-obb-settings.png)

   *Abbildung 1. Einstellungsfenster mit dem Datenverzeichnis*

4. Optional: Klicken Sie auf **User Management**, legen Sie Ihren Benutzernamen an und wählen Sie ihn im Feld **User** des Hauptfensters. Jedes Speichern wird mit diesem Namen festgehalten.

5. Schließen Sie das Einstellungsfenster.

Erwartet: Die Bilder stehen unter **List of Pictures**. Bei mehreren Sätzen wählt das Feld **Folder** oben den Satz.

![Hauptfenster von LumiScan Annotation mit zwei annotierten Packungen in der Mitte](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/howto-obb-main.jpg)

*Abbildung 2. Hauptfenster mit einem annotierten Bild*

Das Hauptfenster zeigt von links nach rechts das Bild mit seinen Rahmen, die Bildliste, die Label-Liste, das Feld zum Hinzufügen von Labels und Regler für Helligkeit und Kontrast. Die Schaltflächen unter dem Bild wechseln zum vorherigen Bild, speichern und wechseln zum nächsten Bild. Alle Elemente sind in [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html) beschrieben.

## Schritt 5 - Die Labels anlegen {#step-5-labels}

Ein Label ist der Name einer Objektklasse, zum Beispiel `back` oder `foliert`. Legen Sie für jede Klasse, die das Netz unterscheiden soll, ein Label an.

1. Geben Sie den Namen in das Feld unter **Add Label** ein.
2. Klicken Sie auf **Add Label**.

Das Label erscheint mit einer Nummer in der Label-Liste. Das ausgewählte Label erhält jeder neue Rahmen.

![Label-Liste mit den Einträgen 1: back und 2: foliert](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/howto-obb-labels.png)

*Abbildung 3. Label-Liste und das Feld Add Label*

## Schritt 6 - Einen gedrehten Begrenzungsrahmen zeichnen {#step-6-draw}

1. Wählen Sie in der Label-Liste das Label des Objekts.
2. Doppelklicken Sie auf das Bild an der Stelle, an der die **Unterkante** des Rahmens liegen soll. Diese Kante wird immer grün gezeichnet.
3. Klicken Sie auf die **Oberkante** des Objekts, ohne die Maustaste gedrückt zu halten. Damit legen Sie die Höhe fest.
4. Klicken Sie auf eine **Seite** des Objekts, wieder ohne die Taste zu halten. Damit legen Sie die Breite fest.

Der Rahmen wird mit dem ausgewählten Label gezeichnet. Seine grüne Kante markiert die Unterseite des Objekts; der Rahmen hält also auch fest, in welche Richtung das Objekt zeigt.

![Gedrehter Begrenzungsrahmen um eine Packung mit grüner Unterkante](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/howto-obb-box.jpg)

*Abbildung 4. Gedrehter Begrenzungsrahmen um eine Packung; die grüne Kante markiert ihre Unterseite*

## Schritt 7 - Rahmen korrigieren und löschen {#step-7-correct}

Klicken Sie auf einen Rahmen, um ihn auszuwählen. Ein ausgewählter Rahmen zeigt vier gelbe Eckpunkte. Dann:

- innerhalb des Rahmens ziehen, um ihn zu verschieben,
- an einer Kante ziehen, um seine Größe in diese Richtung zu ändern,
- an einer Ecke ziehen, um ihn um seinen Mittelpunkt zu drehen,
- ein anderes Label wählen oder dessen Nummer `1` bis `9` drücken, um das Label zu ändern,
- mit der rechten Maustaste auf den Rahmen klicken, um ihn zu löschen.

Für Feinkorrekturen verwenden Sie die Tastatur: `Strg`/`Umschalt` mit `i`, `j`, `k`, `l` verschiebt den Rahmen um ein oder zehn Pixel, mit `u` und `o` dreht er sich um ein oder zehn Grad. Alle Tastenkombinationen stehen in [Bildannotation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/image-annotation.html) und [Tastenkombinationen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/shortcuts-for-common-operations.html).

## Schritt 8 - Speichern und zum nächsten Bild wechseln {#step-8-save}

1. Klicken Sie unter dem Bild auf **save** oder drücken Sie `s`.
2. Klicken Sie auf **next** oder drücken Sie `d`, um zum nächsten Bild zu wechseln. **previous** oder `a` geht zurück.

![Schaltflächen previous (a)](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/howto-obb-navigation.png)

*Abbildung 5. Navigationsschaltflächen unter dem Bild*

Erwartet: Neben dem Bild liegen eine CSV-Datei mit seinen Rahmen und eine JSON-Datei mit Benutzername, Zeitpunkt, Bildname und dem Namen der CSV-Datei. Das Bild ist in der Bildliste hervorgehoben.

> [!TIP]
> Unterscheiden sich aufeinanderfolgende Bilder nur wenig, drücken Sie `Alt` + `s`, um zu speichern und die Rahmen in das nächste Bild zu übernehmen. Dann korrigieren Sie nur, was sich geändert hat.

## Ergebnis {#result}

- LumiScan Annotation ist installiert und lizenziert.
- Die Bilder sind geladen, und die Objektklassen sind als Labels angelegt.
- Die Objekte sind mit gedrehten Begrenzungsrahmen markiert, und die Annotationen sind neben den Bildern gespeichert.

Die Ordner mit den Bildern und ihren Annotationsdateien sind die Eingabe für das Training. Antworten auf häufige Fragen stehen in der [FAQ](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/faq.html), Probleme in [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/troubleshooting.html).

# Vor der Installation – LumiScan Annotation

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

## CodeMeter Runtime installieren {#installing-the-codemeter-runtime-environment-2}

LumiScan Annotation wird mit dem LumiScan Key lizenziert und benötigt die CodeMeter Runtime 9.00 oder neuer. Installieren Sie die CodeMeter Runtime und stecken Sie den LumiScan Key ein, wie unter [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html) beschrieben.

# Installieren von LumiScan Annotation unter Windows

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/installing-lumiscan-annotation-on-windows.html

1. Schließen Sie alle geöffneten Anwendungen auf Ihrem Computer.
2. Navigieren Sie zum Speicherort des LumiScan-Installers.
3. Doppelklicken Sie auf die Datei: `Installer_LumiScan_Annotation_va_b_c_d.exe`\*.
4. Die Installation wird vorbereitet und das Fenster der Lizenzvereinbarung öffnet sich.
5. Akzeptieren Sie die Lizenzbedingungen, indem Sie auf **Accept** klicken.
6. Möchten Sie den Standard-Installationsort ändern, klicken Sie auf **Browse**.
7. Navigieren Sie zum gewünschten Speicherort.
8. Bestätigen Sie Ihre Auswahl mit **OK**.
9. Andernfalls klicken Sie auf die Schaltfläche **Next**, um fortzufahren.
10. Wählen Sie bei Bedarf den **Startmenü**-Ordner für die Programmverknüpfungen.
11. Möchten Sie keine Verknüpfungen erstellen, wählen Sie die Option **Do not create links**.
12. Klicken Sie anschließend auf **Install**.
13. Nach Abschluss der Installation sehen Sie ein Dialogfenster.
14. Klicken Sie auf **OK**.
15. Klicken Sie auf **Finish**.
    - wobei **a**, **b**, **c**, **d** Variablen sind, die von der Version der Software abhängen.

> [!NOTE]
> Beim ersten Start des Programms wird automatisch eine JSON-Einstellungsdatei mit dem Namen **settings.json** (siehe JSON-Einstellungsbeispiel) erzeugt unter:\
> `C:\Users\<USER>\AppData\Local\HD Vision Systems GmbH\LumiScan Annotation`

# Benutzeroberfläche – LumiScan Annotation

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

Wenn Sie LumiScan Annotation zum ersten Mal starten, öffnet sich ein leeres Fenster (Abb. 12).

So starten Sie das Programm:

1. Klicken Sie auf die Schaltfläche **Menü**.
2. Wählen Sie **Einstellungen**.
3. Geben Sie im Fenster **Einstellungen** das **Datenverzeichnis** an.

Die verschiedenen Elemente der Benutzeroberfläche sind in [Abb. 13](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example) beschriftet und in [Tabelle 8](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example) erläutert.

## JSON-Einstellungsbeispiel {#json-settings-example}

Diese JSON-Einstellungsdatei wird beim ersten Start der Anwendung automatisch unter `C:\Users\<USER>\AppData\Local\HD Vision Systems GmbH\LumiScan Annotation` erstellt. Der Abschnitt `labels` ist anfangs leer. Sie können dort Labels eintragen, die automatisch hinzugefügt werden.\
Bei Bedarf können hier auch ROI-Werte angegeben und automatisch geladen werden.

Nachfolgend ein Beispiel der Standard-JSON-Einstellungen.

```json
{
    "meta": {
        "inputFileType": "LumiScan Annotation Settings",
        "inputFileVersion": "1.6.0.0",
        "targetMachine": "TargetMachine",
        "programName": "LumiScan Annotation",
        "programVersion": "1.6.0.0"
    },
    "labels": ["stuff", "labelB", "somethingElse"],
    "roiSettings": {
        "x": 1.0,
        "y": 1.0,
        "width": 1.0,
        "height": 1.0
    }
}
```

**Tabelle 1. Tabelle 8: LumiScan Annotation: Beschreibung der Benutzeroberfläche**

| Nr. | Beschreibung |
| --- | --- |
| 1 | Menü: Zugang zu ROI-Einstellungen, Programmeinstellungen und Hilfe. |
| 2 | Ordner: Combobox zur Ordnerauswahl. |
| 3 | Benutzer: Combobox zur Benutzerauswahl.<br><br>- Der ausgewählte Benutzer wird beim Vornehmen von Änderungen gespeichert. |
| 4 | Liste der Bilder aus dem ausgewählten Ordner.<br><br>- Wird eine neue Klasse gespeichert, wird das geänderte Bild hervorgehoben.<br>- Die Hervorhebung verschwindet, wenn Sie den Ordner wechseln (siehe **2** in dieser Tabelle) oder das Programm neu laden. |
| 5 | Liste aller verfügbaren Labels im ausgewählten Ordner. |
| 6 | Zentralansicht mit Anzeige des aktuell ausgewählten Bildes und der Labels.<br> Das Bild kann per Rechtsklick gelöscht werden. **HINWEIS: Dabei wird das gelöschte Bild auch aus dem Datensatz entfernt.** |
| 7 | Zeigt die ausgewählten Labels. |
| 8 | Fügt ein neues Label hinzu. |
| 9 | Anpassen der Helligkeit und des Kontrasts des Bildes. |
| 10 | Navigationsmenü (siehe auch Navigation). |

![Eine Draufsicht zeigt die Hand einer Person in der Nähe von Tastatur und Maus neben einer Ablage mit mehreren rechteckigen Objekten, die mit grünen Textbeschriftungen versehen sind](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/example2.png)

# Navigation – LumiScan Annotation

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/navigation.html

Um das vorherige oder nächste Bild anzuzeigen oder Ihre Änderungen zu speichern, können Sie die Schaltflächen im Navigationsmenü verwenden (10 in [Abb. 13](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)) oder die Tastenkombinationen.\

Tabelle 10: Navigationstasten

Diese Tabelle ist zusammen mit den Tastenkombinationen für häufige Operationen auch über **Menü > Hilfe** zugänglich (Abb. 19).

![Ein Software-Hilfefenster zeigt Tastenkombinationen in deutscher Sprache zum Navigieren und Klassifizieren von Bildern sowie eine Option zum Schließen des Fensters](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/helpinfo.png)

# Menü – LumiScan Annotation

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/menu.html

Im Menü können Sie ROI-Einstellungen, Einstellungen und Hilfe auswählen.

![Eine dunkle, texturierte Stoffoberfläche wird in einer Software-Oberfläche namens LumScan Annotation angezeigt, mit Optionen zur Ordnerauswahl, Benutzereingabe, Bildliste, Labels sowie Helligkeits- und Kontrastregelung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/windowsettings.png)

## ROI-Einstellungen {#roi-settings}

In diesem Einstellungsfenster können Sie die Region of Interest (ROI) für das Training des neuronalen Netzwerks festlegen. Die ROI definiert den Teil des aufgenommenen Bildes, in dem das Netzwerk nach Markern suchen wird. Standardmäßig ist die ROI auf die gesamte Bildgröße eingestellt. In der Zentralansicht sind die Ränder der ROI blau eingefärbt.

![Ein Softwarefenster mit dem Titel ROI S zeigt Eingabefelder für xmin, ymin, width und height mit den Werten 0, 0, 1280 und 960 sowie eine Schaltfläche Close darunter](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/roi.png)

## Einstellungen {#settings}

![Ein Software-Einstellungsfenster zeigt Optionen zur Auswahl eines Datenverzeichnisses mit der Bezeichnung Input_Images, einen Schieberegler für die Dicke mit dem Wert 1,00 sowie die Versionsnummer 1.3.1.0 mit Schaltflächen zum Festlegen des Ordners und zum Schließen des Fensters](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/menusettings.png)

In diesem Einstellungsfenster können Sie:

1. das Verzeichnis angeben, aus dem das Programm Bilder laden soll.
2. das Fenster der Benutzerverwaltung öffnen.
3. den Schieberegler Thickness anpassen, um die Dicke des Bounding-Box-Rahmens festzulegen.

Um einen Eingabeordner festzulegen, klicken Sie auf **Set Folder** und wählen Sie den Ordner, der die Bilder enthält.

### Benutzerverwaltung {#user-management}

Nachdem Sie auf die Schaltfläche User Management geklickt haben, öffnet sich das Fenster Users, in dem Sie neue Benutzer hinzufügen oder vorhandene löschen können.

Um einen neuen Benutzer hinzuzufügen, geben Sie den gewünschten Namen im unteren Eingabefeld ein und klicken Sie auf **+**. Um einen vorhandenen Benutzer zu löschen, wählen Sie den Benutzer in der Liste aus und klicken Sie auf **-**.

![Ein dunkel gestaltetes Fenster einer Benutzeroberfläche mit dem Titel Users, mit einem leeren Hauptbereich, einem Texteingabefeld darunter und deaktivierten Plus- und Minus-Schaltflächen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/_images/users.png)

# Bildannotation – LumiScan Annotation

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

Orientierte Bounding-Boxen können in der Zentralansicht manuell geändert oder hinzugefügt werden (6 in [Abb. 13](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)):

\*Hinzufügen neuer Boxen: \*Das Hinzufügen neuer Boxen erfolgt in drei Schritten:

1. Doppelklicken Sie zunächst mit der linken Maustaste auf die Position, an der sich die Unterkante der Bounding-Box befinden soll. Dieser Rahmen ist stets grün ([Abb. 14](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)).
2. Klicken Sie ohne gedrückte Maustaste mit der linken Maustaste auf die Oberkante des Objekts, um die Höhe der Bounding-Box festzulegen.
3. Um die Breite der Bounding-Box zu bestimmen, klicken Sie erneut ohne gedrückte Maustaste mit der linken Maustaste auf einen beliebigen Seitenpunkt des Objekts.

Das Label der Box entspricht der aktiven Klasse in der Liste (**5** in [Abb. 13](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)).

**Auswählen einer Bounding-Box: \*Vorhandene Boxen können mit einem einfachen Linksklick ausgewählt werden. Eine ausgewählte Box wird durch eine leicht abweichende Farbe und vier gelbe, kreisförmige Eckgriffe hervorgehoben ([Abb. 14](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)).** \*

**Ändern vorhandener Boxen:** Solange eine Bounding-Box ausgewählt ist, können Sie ihr Label ändern, indem Sie in der Label-Übersicht ein anderes Label wählen oder ein neues Label eingeben.

**Korrigieren der Bounding-Box**: Eine ausgewählte Box lässt sich auf mehrere Arten bearbeiten:

- Ziehen Sie das Innere einer aktiven Box, um sie zu verschieben.
- Durch Ziehen der Kanten einer aktiven Box wird ihre Größe in dieser Richtung geändert.
- Ziehen Sie die Ecken einer aktiven Box, um sie um ihren Mittelpunkt zu drehen.

**Löschen der Bounding-Box**: Klicken Sie mit der rechten Maustaste auf eine aktive Box, um sie zu entfernen.

| Tastenkombination | Operation |
| --- | --- |
| Ctrl/Shift + i/j/k/l | Aktuelle Box um einen/zehn Pixel in die entsprechende Richtung verschieben |
| Ctrl/Shift + u/o | Aktuelle Box um ein/zehn Grad gegen/im Uhrzeigersinn drehen. |
| Ctrl/Shift + v/b | Höhe der aktuellen Box um einen/zehn Pixel vergrößern/verkleinern |
| Ctrl/Shift + n/m | Breite der aktuellen Box um einen/zehn Pixel vergrößern/verkleinern |

Nach jeder gespeicherten Annotation schreibt das LumiScan Annotation Framework zusätzlich die folgenden Informationen in eine JSON-Datei:

- Benutzername
- Unix-Zeitstempel
- Bildname (PNG)
- Name der Speicherdatei (CSV)

Die JSON-Datei wird im Raw-Verzeichnis unter dem Namen des gespeicherten Bildes abgelegt. Aufeinanderfolgende Kommentare werden angehängt, sodass Sie nachvollziehen können, wer wann eine Änderung vorgenommen hat.

# Ordnerstruktur – LumiScan Annotation

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/folder-structure.html

Um einen einzelnen Bildordner zu annotieren, wählen Sie einfach den Ordner mit den PNG-Bildern aus und beginnen Sie mit der Annotation.\
Um mehrere Bildordner zu laden, sollten die Bilder auf Ihrer Festplatte in der folgenden Ordnerstruktur abgelegt sein:

\<Any Folder Name>

\|-----\<Any Folder Name>

```
|
```

```
|---- .png
```

```
|---- *.csv
```

```
|----.json
```

\|-----\<some other folders>

In diesem Fall können Sie einen Ordner auswählen, der einen oder mehrere Ordner mit PNG-Bildern enthält, und dann über das Ordner-Dropdown-Menü oben den richtigen Ordner auswählen, den Sie annotieren möchten.

# Tastenkombinationen für häufige Operationen – LumiScan Annotation

URL: https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/shortcuts-for-common-operations.html

Für typische Manipulationen von Bounding-Boxen wie Drehen, Verschieben, Vergrößern oder Extrudieren können Sie die Tastenkombinationen aus der folgenden Tabelle verwenden.

**Tabelle 1. Tabelle 9: Tastenkombinationen für häufige Operationen**

| Schaltfläche | Tastenkombination | Operation |
| --- | --- | --- |
| previous | a | Zum vorherigen Bild wechseln. |
| save | s | Bild speichern. |
| next | d | Zum nächsten Bild wechseln. |
|   | alt + s | Speichern und Labels auf das nächste Bild übernehmen.<br> Nützlich, wenn sich der Inhalt zwischen Bildern kaum ändert. |
|   | 1-9 | Label für die ausgewählte Region setzen.<br> Diese Option kann auch zum Ändern des Labels der Bounding-Box verwendet werden. Nach der Auswahl der gewünschten Box (linke Maustaste) kann der Name durch Eingabe der gewünschten Label-Nummer (1 - 9) geändert werden. |

# FAQ – LumiScan Annotation

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

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

> [!TIP]
> Durchsuchen Sie diese Seite nach der genauen Fehlermeldung. Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-settings-file`).

## Voraussetzungen, Installation und Lizenzierung

### Welches Betriebssystem benötigt LumiScan Annotation? {#faq-system-requirements}

- **Antwort:** Windows 11.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/requirements.html)

### Wie installiere ich LumiScan Annotation? {#faq-installation}

- **Antwort:** Installieren Sie zuerst die CodeMeter Runtime 9.00 oder neuer und stecken Sie den LumiScan Key ein. Schließen Sie dann alle geöffneten Anwendungen, doppelklicken Sie auf `Installer_LumiScan_Annotation_va_b_c_d.exe` (a, b, c, d hängen von der Softwareversion ab), akzeptieren Sie die Lizenzbedingungen mit **Accept** und folgen Sie dem Installationsassistenten bis **Finish**.
- **Mehr:** [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/before-installation.html#installing-the-codemeter-runtime-environment-2), [Installieren von LumiScan Annotation unter Windows](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/installing-lumiscan-annotation-on-windows.html)

### Wie wird LumiScan Annotation lizenziert? {#faq-licence}

- **Antwort:** LumiScan Annotation wird mit dem LumiScan Key lizenziert und benötigt die CodeMeter Runtime 9.00 oder neuer. Bei Kauf über HD Vision Systems liegt die Lizenz auf dem LumiScan Key und ist ein Jahresabonnement. Bei Kauf im ctrlX Store für Windows 11 werden ctrlX WORKS und der LumiScan Key verwendet. Pro Gerät, auf dem die Software gleichzeitig läuft, wird ein LumiScan Key benötigt; Keys können zwischen Geräten getauscht werden.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/requirements.html#licence), [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)

## Erste Schritte

### Wie müssen die Bilder organisiert sein? {#faq-folder-structure}

- **Antwort:** Um einen einzelnen Ordner zu annotieren, wählen Sie den Ordner mit den PNG-Bildern. Für mehrere Ordner wählen Sie einen übergeordneten Ordner, der einen oder mehrere Ordner mit PNG-Bildern (mit den zugehörigen CSV- und JSON-Dateien) enthält, und wählen den zu annotierenden Ordner im Ordner-Dropdown-Menü oben aus.
- **Mehr:** [Ordnerstruktur](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/folder-structure.html)

### Wo liegt die Einstellungsdatei und was kann ich darin festlegen? {#faq-settings-file}

- **Antwort:** `settings.json` wird beim ersten Start automatisch unter `C:\Users\<USER>\AppData\Local\HD Vision Systems GmbH\LumiScan Annotation` erstellt. Der Abschnitt `labels` ist anfangs leer; dort eingetragene Labels werden automatisch hinzugefügt. Im Abschnitt `roiSettings` können auch ROI-Werte angegeben werden, die automatisch geladen werden.
- **Mehr:** [JSON-Einstellungsbeispiel](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)

### Wie füge ich Benutzer hinzu oder lösche sie? {#faq-users}

- **Antwort:** Öffnen Sie **Menü** > **Einstellungen** und klicken Sie auf **User Management**. Geben Sie im Fenster **Users** einen Namen im unteren Eingabefeld ein und klicken Sie auf **+**, um einen Benutzer hinzuzufügen; wählen Sie einen Benutzer in der Liste und klicken Sie auf **-**, um ihn zu löschen. Der in der Benutzer-Combobox ausgewählte Benutzer wird beim Vornehmen von Änderungen gespeichert.
- **Mehr:** [Benutzerverwaltung](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/menu.html#user-management)

### Was ist die ROI und wie lege ich sie fest? {#faq-roi}

- **Antwort:** Die Region of Interest (ROI) legt den Teil des aufgenommenen Bildes fest, in dem das trainierte Netzwerk sucht. Standardmäßig umfasst sie das gesamte Bild. Legen Sie sie unter **Menü** > **ROI-Einstellungen** oder im Abschnitt `roiSettings` der Datei `settings.json` fest; in der Zentralansicht sind die Ränder der ROI blau dargestellt.
- **Mehr:** [ROI-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/menu.html#roi-settings)

## Bilder annotieren

### Wie füge ich eine orientierte Bounding-Box hinzu? {#faq-add-bounding-box}

- **Antwort:** In der Zentralansicht (die Box erhält das Label der aktiven Klasse in der Label-Liste):
  1. Doppelklicken Sie mit der linken Maustaste auf die Position der Unterkante der Box (diese Kante ist stets grün).
  2. Klicken Sie ohne gedrückte Maustaste mit der linken Maustaste auf die Oberkante des Objekts, um die Höhe festzulegen.
  3. Klicken Sie mit der linken Maustaste auf einen beliebigen Seitenpunkt des Objekts, um die Breite festzulegen.
- **Mehr:** [Bildannotation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/image-annotation.html)

### Wie verschiebe, skaliere oder drehe ich eine Bounding-Box? {#faq-edit-bounding-box}

- **Antwort:** Wählen Sie die Box mit einem Linksklick aus (sie zeigt vier gelbe Eckgriffe). Ziehen Sie das Innere, um sie zu verschieben, die Kanten, um ihre Größe zu ändern, und die Ecken, um sie um ihren Mittelpunkt zu drehen. Per Tastatur verschiebt Ctrl/Shift + i/j/k/l die Box um einen/zehn Pixel, Ctrl/Shift + u/o dreht sie um ein/zehn Grad, Ctrl/Shift + v/b ändert die Höhe und Ctrl/Shift + n/m die Breite um einen/zehn Pixel.
- **Mehr:** [Bildannotation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/image-annotation.html)

### Wie ändere ich das Label einer Bounding-Box? {#faq-change-label}

- **Antwort:** Wählen Sie die Box mit einem Linksklick aus und wählen Sie dann in der Label-Übersicht ein anderes Label, geben Sie ein neues Label ein oder drücken Sie die Label-Nummer 1-9.
- **Mehr:** [Bildannotation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/image-annotation.html), [Tastenkombinationen für häufige Operationen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/shortcuts-for-common-operations.html)

### Mit welchen Tasten wechsle ich Bilder und speichere Annotationen? {#faq-navigation-shortcuts}

- **Antwort:** `a` wechselt zum vorherigen Bild, `s` speichert das Bild, `d` wechselt zum nächsten Bild, und `alt + s` speichert und übernimmt die Labels auf das nächste Bild (nützlich, wenn sich der Inhalt zwischen Bildern kaum ändert). Die Tabelle der Tastenkombinationen ist auch über **Menü > Hilfe** erreichbar.
- **Mehr:** [Tastenkombinationen für häufige Operationen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/shortcuts-for-common-operations.html), [Navigation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/navigation.html)

### Kann ich nachvollziehen, wer eine Annotation wann geändert hat? {#faq-change-history}

- **Antwort:** Ja. Nach jeder gespeicherten Annotation schreibt LumiScan Annotation Benutzername, Unix-Zeitstempel, Bildname (PNG) und Namen der Speicherdatei (CSV) in eine JSON-Datei. Diese wird im Raw-Verzeichnis unter dem Namen des gespeicherten Bildes abgelegt; spätere Einträge werden angehängt.
- **Mehr:** [Bildannotation](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/image-annotation.html)

## Fehlerbehebung {#troubleshooting}

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

- [Das Fenster ist leer](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/troubleshooting.html#faq-first-start-empty-window)

## Support

### Wo erhalte ich weitere Hilfe? {#faq-support}

- **Antwort:** Siehe die seitenübergreifende [LumiScan FAQ](https://docs.hdvisionsystems.com/de/faq.html). Den Kundensupport erreichen Sie unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905. Bei Fragen zu Lizenzen schreiben Sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).

# Fehlerbehebung – LumiScan Annotation

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

Diese Seite beginnt mit allgemeinen Prüfungen, die Sie zuerst durchführen. Suchen Sie danach Ihr Symptom und arbeiten Sie Diagnose und Lösung durch. Besteht das Problem weiterhin, senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/troubleshooting.html#support-information) aufgeführten Informationen an den Support.

## Allgemeine Prüfungen {#general-checks}

- Prüfen Sie, ob auf dem Computer Windows 11 läuft (siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/requirements.html)).
- Prüfen Sie, ob die CodeMeter Runtime 9.00 oder neuer installiert und der LumiScan Key eingesteckt ist (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/before-installation.html#installing-the-codemeter-runtime-environment-2)). Lizenzprobleme - ein Key, der nicht erkannt wird, die Meldung `User maximum reached!`, eine Engineering-App, die nicht mehr startet, weil das Jahresabonnement abgelaufen ist - sind unter [Lizenzierung: Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html) beschrieben.
- Die Einstellungsdatei `settings.json` wird beim ersten Start automatisch unter `C:\Users\<USER>\AppData\Local\HD Vision Systems GmbH\LumiScan Annotation` erstellt. Dort eingetragene Labels und ROI-Werte werden automatisch geladen (siehe [JSON-Einstellungsbeispiel](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/user-interface.html#json-settings-example)).

## Problem: Das Fenster ist leer {#faq-first-start-empty-window}

**Symptome**

Wenn Sie LumiScan Annotation starten, öffnet sich ein leeres Fenster. Die Liste der Bilder bleibt leer.

**Mögliche Ursachen**

- Es wurde noch kein Datenverzeichnis angegeben. Beim ersten Start ist das Fenster leer, bis ein Datenverzeichnis angegeben ist.
- Der ausgewählte Ordner enthält die PNG-Bilder nicht in der unter [Ordnerstruktur](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/folder-structure.html) beschriebenen Struktur.

**Diagnose**

1. Klicken Sie auf **Menü** und wählen Sie **Einstellungen** - erwartet: Das Fenster **Einstellungen** zeigt das Datenverzeichnis, aus dem die Bilder geladen werden.
2. Prüfen Sie den ausgewählten Ordner - erwartet: Er enthält die PNG-Bilder oder, wenn Sie mit mehreren Ordnern arbeiten, einen oder mehrere Ordner mit PNG-Bildern (mit den zugehörigen CSV- und JSON-Dateien).
3. Haben Sie einen Ordner mit mehreren Ordnern ausgewählt, prüfen Sie das Ordner-Dropdown-Menü oben - erwartet: Der zu annotierende Ordner ist ausgewählt und seine Bilder werden aufgelistet.

**Lösung**

- **Wenn kein Datenverzeichnis angegeben ist:**
  1. Klicken Sie auf **Menü** und wählen Sie **Einstellungen**.

  2. Klicken Sie auf **Set Folder** und wählen Sie den Ordner, der die Bilder enthält.

     Die Bilder des Ordners werden im Fenster aufgelistet.

- **Wenn die Ordnerstruktur nicht passt:** Wählen Sie den Ordner mit den PNG-Bildern oder, bei mehreren Ordnern, einen übergeordneten Ordner wie unter [Ordnerstruktur](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/folder-structure.html) beschrieben. Wählen Sie dann den zu annotierenden Ordner im Ordner-Dropdown-Menü oben aus.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Pfad des ausgewählten Datenverzeichnisses und einem Screenshot des Fensters **Einstellungen**.

## Informationen für den Support {#support-information}

Halten Sie diese Informationen bereit, wenn Sie den Support kontaktieren:

- Produkt und Version: LumiScan Annotation und seine Versionsnummer. Das Fenster **Einstellungen** (**Menü** > **Einstellungen**) zeigt die Versionsnummer; die Version ist außerdem Teil des Dateinamens des Installationsprogramms `Installer_LumiScan_Annotation_va_b_c_d.exe`.
- Betriebssystem: Windows 11.
- Bezugsquelle der Software: HD Vision Systems oder ctrlX Store.
- Die Seriennummer des LumiScan Key (`3-…`, auf dem Key aufgedruckt).
- Die genaue Fehlermeldung, ein Screenshot sowie Datum und Uhrzeit, zu der das Problem auftrat.
- Die Einstellungsdatei `settings.json` aus `C:\Users\<USER>\AppData\Local\HD Vision Systems GmbH\LumiScan Annotation`.

Den Kundensupport erreichen Sie unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder telefonisch unter +49 6221 6721905. Bei Fragen zu Lizenzen schreiben Sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).
