# LumiScan VGR Engineering 1.0.0.3 – complete documentation

> All pages of the LumiScan VGR Engineering 1.0.0.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-vgr-engineering-de/1.0.0/

# LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/index.html

|   |   |   |
| --- | --- | --- |
| ![Kamera, Erkennung und Roboter als verbundene Elemente](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/_images/intro/step-1.svg)<br><br>**Die Zelle aus Elementen aufbauen.** Kameras, Objekterkennungen und Roboter, verbunden. | ![Punktwolken-Vorschau neben Schiebereglern mit markierten Vorschlagswerten](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/_images/intro/step-2.svg)<br><br>**Mit Live-Vorschau einstellen.** Nur die wichtigen Einstellungen, mit Vorschlagswerten. | ![ZIP-Datei, die an LumiScan VGR geht](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/_images/intro/step-3.svg)<br><br>**Für LumiScan VGR exportieren.** Eine Konfiguration, die VGR direkt liest. |

LumiScan VGR Engineering ist das geführte Konfigurationswerkzeug für LumiScan VGR, damit Sie die Einstellungsdatei nicht von Hand bearbeiten. Sie verbinden Kameras, Objekterkennungen und Roboter als Elemente; das Werkzeug zeigt die wichtigen Einstellungen, ihre Wirkung im Livebild und in der Punktwolke und schlägt sinnvolle Werte vor. Es exportiert die Konfiguration im Format, das LumiScan VGR liest. Für die Inbetriebnahme einer Zelle, den Wechsel von Kamera oder Greifer oder ein neues Objekt.

LumiScan VGR Engineering ist das Konfigurationswerkzeug für LumiScan VGR. Sie beschreiben Ihre Anwendung als Elemente - Kameras, Objekterkennungen, Roboter -, verbinden sie, prüfen jedes Element in einer Live-Vorschau und exportieren das Ergebnis als Einstellungsdatei, die LumiScan VGR direkt verwendet.

## Wo anfangen?

| Sie möchten | Lesen Sie |
| --- | --- |
| wissen, was das Werkzeug tut und wie es mit LumiScan VGR zusammenspielt | [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/description.html) |
| IPC und Kamera einrichten, die Software installieren | [Systemvoraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html), [Installation](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html) |
| Ihre erste Konfiguration aufbauen - von der Kamera bis zu den exportierten Einstellungen | [Erste Schritte](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/getting-started.html) |
| sich im Fenster zurechtfinden | [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html) |
| wissen, was ein Kamera-, Objekterkennungs- oder Roboterelement enthält | [Konfigurationselemente](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html) |
| eine kurze Antwort oder eine Fehlermeldung nachschlagen | [FAQ](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/faq.html) |

Zur Lizenzierung siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html#licence). Die Einstellungen, die LumiScan VGR Engineering erzeugt, sind im [Handbuch zu LumiScan VGR](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings.html) beschrieben.

# Beschreibung – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/description.html

LumiScan VGR Engineering führt Sie durch die Konfiguration anderer Software von HD Vision Systems, allen voran LumiScan VGR. Statt eine Einstellungsdatei von Hand zu bearbeiten, arbeiten Sie mit den Elementen Ihrer Anwendung: Das Werkzeug zeigt die Einstellungen, die für das jeweilige Element relevant sind, zeigt in der Vorschau, wie sich die aktuellen Werte auswirken, und schlägt sinnvolle Werte vor. Beim Konfigurieren einer Kamera listet es zum Beispiel die verfügbaren Kameras auf und zeigt deren Live-Bild und Punktwolke mit den gewählten Einstellungen - so ist sofort erkennbar, ob die Einstellungen passen. Die fertige Konfiguration wird in dem Format exportiert, das LumiScan VGR direkt einliest.

## Zusammenspiel mit LumiScan VGR

LumiScan VGR führt die Vision-Guided-Robotics-Anwendung auf dem Produktionssystem aus; ihr Verhalten ist in einer JSON-Einstellungsdatei festgelegt (siehe [JSON-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings.html) im Handbuch zu LumiScan VGR). LumiScan VGR Engineering ist das Werkzeug, mit dem diese Datei erstellt und gepflegt wird:

1. Sie bauen die Konfiguration aus drei Arten von [Elementen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html) auf - **Kameras**, **Objekterkennungen** und **Roboter** - und verbinden sie: Eine Kamera liefert ein Bild, eine Objekterkennung verarbeitet es, und mit dem Ergebnis wird ein Roboter gesteuert.
2. Die Vorschau zeigt für das ausgewählte Element, was LumiScan VGR mit den aktuellen Einstellungen sehen wird.
3. **Download** exportiert die Konfiguration als `.zip`-Datei, die die Einstellungen sowohl im Format von LumiScan VGR Engineering (zum späteren Weiterbearbeiten) als auch im Format von LumiScan VGR oder anderer kompatibler Software (zur Inbetriebnahme) enthält.

Eine Konfiguration kann jederzeit gespeichert und wieder geöffnet werden; Dateien, auf die die Einstellungen verweisen - etwa eine `.hdvcal`-Kamerakalibrierdatei -, werden in das Werkzeug hochgeladen.

## Für wen

LumiScan VGR Engineering richtet sich an Integratoren und Ingenieure, die eine LumiScan-VGR-Anwendung einrichten und pflegen: eine neue Zelle in Betrieb nehmen, eine Kamera oder einen Greifer austauschen, ein Objekt hinzufügen oder eine Konfiguration prüfen, bevor sie in die Produktion geht. Der laufende Betrieb der Anwendung findet in LumiScan VGR selbst statt.

# Systemvoraussetzungen – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html

## IPC

Der IPC, auf dem LumiScan VGR Engineering läuft, benötigt:

- Windows 11
- eine NVIDIA-GPU, die CUDA 11.8 unterstützt
- CUDA Toolkit 11.8
- cuDNN 8.8.1

Die benötigten CUDA- und cuDNN-Installationsprogramme stellt HD Vision Systems bereit. Installieren Sie sie vor LumiScan VGR Engineering (siehe [Installation](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html)).

> [!TIP]
> Das sind dieselben Voraussetzungen wie für LumiScan VGR. Eine Konfiguration kann also auf dem Produktions-IPC selbst oder auf einem separaten Engineering-PC erstellt werden, der sie erfüllt.

## Kamera {#camera}

Für die Kameravorschau benötigt LumiScan VGR Engineering eine LumiScanX oder eine andere kompatible Kamera, die per Ethernet mit dem IPC verbunden ist. Ohne Kamera lässt sich die Konfiguration bearbeiten, speichern und exportieren, die Bild- und Punktwolkenvorschau bleibt jedoch leer.

Stellen Sie vor Installation und Betrieb von LumiScan VGR Engineering sicher, dass das Kameranetzwerk korrekt konfiguriert ist, und prüfen Sie die Einstellungen der Windows-Firewall und des Virenschutzes. Die erforderlichen Netzwerk-, Firewall- und Virenschutzeinstellungen sind im [Handbuch zur LumiScan X](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/index.html) beschrieben, für andere Kameras im Handbuch des Kameraherstellers.

## Lizenz {#licence}

Wie LumiScan VGR Engineering 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 VGR Engineering 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).

# Installation – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html

Installieren Sie in dieser Reihenfolge:

1. CUDA Toolkit 11.8 und cuDNN 8.8.1 (Installationsprogramme von HD Vision Systems), siehe [Systemvoraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html).
2. CodeMeter Runtime und den LumiScan Key, siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html#installing-codemeter-runtime).
3. Die LumiScanX-Kamera, eingerichtet nach dem [Handbuch zur LumiScan X](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/index.html) - die Kamera wird für die Vorschau gebraucht, nicht für die Installation selbst.
4. LumiScan VGR Engineering, siehe [LumiScan VGR Engineering installieren](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html#installing-lumiscan-vgr-engineering).

## CodeMeter Runtime installieren {#installing-codemeter-runtime}

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

## LumiScan VGR Engineering installieren {#installing-lumiscan-vgr-engineering}

1. Schließen Sie alle geöffneten Anwendungen.
2. Wechseln Sie zum Speicherort des Installationsprogramms von LumiScan VGR Engineering und starten Sie es.
3. Warten Sie, bis das Fenster mit der Lizenzvereinbarung erscheint.
4. Akzeptieren Sie die Lizenzbedingungen mit **Accept**.
5. Um den vorgeschlagenen Installationsort zu ändern, klicken Sie auf **Browse**, wählen Sie den gewünschten Ordner und klicken Sie auf **OK**.
6. Klicken Sie auf **Next**.
7. Wählen Sie bei Bedarf einen Ordner im **Startmenü** für die Programmverknüpfungen. Sollen keine Verknüpfungen angelegt werden, wählen Sie **Do not create links**.
8. Klicken Sie auf **Install**.
9. Klicken Sie nach Abschluss der Installation auf **OK**.
10. Klicken Sie auf **Finish**.

> [!NOTE]
> Je nach Installationspaket entfällt die Auswahl des Startmenü-Ordners.

## Anwendung starten {#starting}

Starten Sie LumiScan VGR Engineering über das Startmenü oder aus dem Installationsordner, mit angeschlossenem LumiScan Key (siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html#licence)). Die ersten Schritte sind unter [Erste Schritte](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/getting-started.html) beschrieben.

# Erste Schritte – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/getting-started.html

Diese Seite führt durch eine erste Konfiguration: eine Kamera, eine Objekterkennung, ein Roboter, exportiert für LumiScan VGR. Das Fenster und seine Bereiche sind auf der Seite [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html) beschrieben, der Inhalt der einzelnen Elemente unter [Konfigurationselemente](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html).

## Bevor Sie beginnen

- LumiScan VGR Engineering ist installiert und gestartet ([Installation](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html)).
- Die Kamera ist angeschlossen, über das Netzwerk erreichbar und nach ihrem Handbuch eingerichtet - die Vorschau braucht sie.
- Die Dateien, auf die die Konfiguration verweist, liegen bereit, zum Beispiel die `.hdvcal`-Kalibrierdatei der Kamera und die Roboterbeschreibung (`.urdf`) mit der Hand-Auge-Kalibrierung.

## 1. Kamera anlegen

1. Geben Sie in der Graph-Übersicht am unteren Fensterrand in das Feld **id** der Spalte **Cameras** eine eindeutige ID ein - zum Beispiel `cam_main` - und klicken Sie auf **Add**. Die IDs benennen die Elemente in den exportierten Einstellungen; wählen Sie also Namen, die Sie später wiedererkennen.
2. Klicken Sie auf das neue Element. Der Editor rechts zeigt seine Einstellungen, die Vorschau links zeigt, was die Kamera sieht.
3. Tragen Sie die Einstellungen der Kamera ein. Verweisen die Einstellungen auf eine Datei, etwa die `.hdvcal`-Kalibrierdatei, laden Sie diese mit **Upload** im Konfigurationsbereich hoch (oder ziehen Sie sie auf die Schaltflächen) und wählen Sie sie im Editor aus.
4. Prüfen Sie die Vorschau. Mit den Schaltflächen oben rechts in der Vorschau wechseln Sie zwischen Bild und Punktwolke; die Punktwolke drehen, verschieben und zoomen Sie mit der Maus. Die Vorschau folgt jeder Änderung einer Einstellung, die die Kamera betrifft - passen Sie die Werte an, bis Bild und Punktwolke stimmen.

## 2. Objekterkennung anlegen und mit der Kamera verbinden

1. Geben Sie in das Feld **id** der Spalte **ObjectDetections** eine ID ein - zum Beispiel `detection_network` - und klicken Sie auf **Add**.
2. Ziehen Sie eine Verbindung vom Kameraelement zum neuen Objekterkennungselement. Die Verbindung legt fest, mit dem Bild welcher Kamera diese Erkennung arbeitet. Eine Kamera kann mehrere Erkennungen versorgen.
3. Wählen Sie die Objekterkennung aus und konfigurieren Sie sie im Editor: welches Netz und welche Objekte erkannt werden sollen, und wie. Die Vorschau zeigt das Element mit den aktuellen Einstellungen.

## 3. Roboter anlegen und mit der Erkennung verbinden

1. Geben Sie in das Feld **id** der Spalte **Robots** eine ID ein - zum Beispiel `robot_arm` - und klicken Sie auf **Add**.
2. Ziehen Sie eine Verbindung vom Objekterkennungselement zum Roboterelement: Mit dem Ergebnis der Erkennung wird dieser Roboter gesteuert.
3. Wählen Sie den Roboter aus und konfigurieren Sie ihn im Editor - seine Beschreibung, die Hand-Auge-Kalibrierung, die ihn relativ zur Kamera platziert, und den Greifer.

## 4. Speichern und exportieren

1. Klicken Sie im Konfigurationsbereich auf **Save**. **Save** behält den aktuellen Stand in LumiScan VGR Engineering; **Reload** holt den zuletzt gespeicherten Stand zurück und verwirft ungespeicherte Änderungen.
2. Klicken Sie auf **Download**. Sie erhalten eine `.zip`-Datei mit der Konfiguration in zwei Formaten: dem Format von LumiScan VGR Engineering, um später weiterzuarbeiten, und den Einstellungen für LumiScan VGR oder andere kompatible Software.
3. Spielen Sie die Einstellungen auf dem LumiScan-VGR-System ein, wie im [Handbuch zu LumiScan VGR](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings.html) beschrieben.

## Später weiterarbeiten

Laden Sie die heruntergeladene `.zip`-Datei hoch (**Upload** oder per Drag-and-drop auf den Konfigurationsbereich): Die Konfiguration wird wiederhergestellt und kann erneut bearbeitet, gespeichert und heruntergeladen werden.

## Tipps

- Geben Sie jedem Element eine ID, die sagt, was es ist (`cam_bags`, `network_bags`, `robot_arm`) - die IDs erscheinen in der Graph-Übersicht und in den exportierten Einstellungen.
- Ein Element entfernen Sie mit dem **X** oben rechts im Element (sichtbar, wenn es ausgewählt ist); eine Verbindung entfernen Sie per Doppelklick.
- Wenn Sie die Einstellungen lieber im Ganzen sehen, schalten Sie den Editor auf **Raw JSON** um. Formular- und JSON-Ansicht zeigen dieselben Daten; eine Änderung in der einen ist eine Änderung in der anderen.

# Benutzeroberfläche – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html

Das Fenster von LumiScan VGR Engineering hat vier Bereiche:

- Der **Konfigurationsbereich** oben enthält die Schaltflächen, die auf die gesamte Konfiguration wirken - speichern, neu laden, herunterladen, hochladen.
- Die **Graph-Übersicht** unten zeigt die Elemente der Konfiguration in ihren Kategorien und wie sie verbunden sind.
- Die **Vorschau** links zeigt das in der Graph-Übersicht ausgewählte Element und wie sich die aktuellen Einstellungen darauf auswirken.
- Der **Editor** rechts zeigt die Einstellungen des ausgewählten Elements; hier werden sie geändert.

![LumiScan VGR Engineering: Konfigurationsbereich oben, Vorschau (links) und Editor (rechts) in der Mitte, Graph-Übersicht mit den Spalten Cameras, ObjectDetections und Robots unten](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/_images/VGREngineeringOverview.png)

## Konfigurationsbereich {#configuration-panel}

Die vier Schaltflächen wirken auf die gesamte Konfiguration. Dateien können statt über **Upload** auch per Drag-and-drop auf die Schaltflächen gezogen werden.

**Tabelle 1. Schaltflächen des Konfigurationsbereichs**

| Schaltfläche | Funktion |
| --- | --- |
| **Save** | Speichert den aktuellen Stand der Einstellungen. |
| **Reload** | Lädt die zuletzt gespeicherten Einstellungen zurück in die Oberfläche. Damit machen Sie ungespeicherte Änderungen rückgängig. |
| **Download** | Lädt eine `.zip`-Datei herunter, die die Einstellungen im Format von LumiScan VGR Engineering und im Format von LumiScan VGR oder anderer kompatibler Software enthält. |
| **Upload** | Lädt eine Datei in die Konfiguration: entweder eine `.zip`-Datei, die aus LumiScan VGR Engineering heruntergeladen wurde - sie stellt diese Konfiguration wieder her -, oder eine Datei, auf die die Einstellungen verweisen, zum Beispiel eine `.hdvcal`-Kamerakalibrierdatei. |

## Graph-Übersicht {#graph-overview}

Die Graph-Übersicht zeigt die Elemente der Konfiguration als Spalten, eine je Kategorie, von links nach rechts verbunden: Eine konfigurierte Kamera liefert ein Bild, eine Objekterkennung verarbeitet es, und mit dem Ergebnis der Erkennung wird ein Roboter gesteuert. Jede Kategorie kann mehrere Elemente enthalten, und ein Element kann mit mehreren Elementen der nächsten Kategorie verbunden sein.

- **Auswählen:** Klicken Sie auf ein Element. Vorschau und Editor wechseln zu ihm.
- **Anlegen:** Geben Sie eine eindeutige ID in das Feld **id** am unteren Rand der Spalte ein und klicken Sie auf **Add**.
- **Entfernen:** Wählen Sie das Element aus und klicken Sie auf das **X**, das oben rechts im Element erscheint.
- **Verbinden:** Ziehen Sie vom Quellelement zum Zielelement.
- **Verbindung lösen:** Doppelklicken Sie auf die Verbindung. Der Mauszeiger ändert sich, wenn er über einer Verbindung steht.

Was die Elemente der einzelnen Kategorien enthalten, ist unter [Konfigurationselemente](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html) beschrieben.

## Editor {#editor-panel}

Der Editor zeigt die Einstellungen des in der Graph-Übersicht ausgewählten Elements; hier werden sie bearbeitet. Er hat zwei Ansichten, umgeschaltet mit den Schaltflächen oben rechts:

- **Form** - die Einstellungen als beschriftete Eingabefelder, nach Themen gruppiert.
- **Raw JSON** - dieselben Einstellungen als JSON-Text.

Beide Ansichten zeigen exakt dieselben Informationen und erlauben dieselben Änderungen; verwenden Sie die, die zur Aufgabe passt.

## Vorschau {#preview-panel}

Die Vorschau zeigt das in der Graph-Übersicht ausgewählte Element. Was sie zeigt, hängt vom Typ des Elements ab; sie wird aktualisiert, sobald eine Einstellung geändert wird, die das Element betrifft. Viele Elementtypen bieten zwei Ansichten, umgeschaltet mit den Schaltflächen oben rechts in der Vorschau:

- **Bild** - das Kamerabild.
- **Punktwolke** - die 3D-Daten; sie lassen sich mit der Maus navigieren:
  - Ziehen mit gedrückter linker Maustaste dreht die Ansicht,
  - Ziehen mit gedrückter rechter Maustaste verschiebt sie,
  - das Mausrad zoomt.

Die Punktwolkenansicht zeigt außerdem das Koordinatensystem: Eine rote, eine grüne und eine blaue Linie markieren die x-, y- und z-Achse. Sie beginnen im Koordinatenursprung und haben jeweils die Länge 1.

# Konfigurationselemente – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html

Eine Konfiguration besteht aus Elementen dreier Kategorien, die als die drei Spalten der [Graph-Übersicht](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#graph-overview) erscheinen. Jedes Element hat eine eindeutige ID, eigene Einstellungen im Editor und eine eigene Vorschau. Die Verbindungen zwischen den Elementen legen den Datenfluss der Anwendung fest: Kamera → Objekterkennung → Roboter.

## Kameras (Cameras) {#cameras}

Ein Kameraelement steht für eine physische Kamera - in der Regel eine LumiScanX - und die Art, wie sie Daten aufnimmt: Identifikation der Kamera, Belichtung, Tiefenschätzung und die Korrekturen, die auf die Kameradaten angewendet werden. Zu jeder Kamera gehört eine Kalibrierdatei (`.hdvcal`); laden Sie sie mit **Upload** hoch und wählen Sie sie im Editor aus.

- **Vorschau:** Das Live-Bild der Kamera und die daraus berechnete Punktwolke, beide mit den aktuellen Einstellungen. Prüfen Sie damit Belichtung, Tiefenbereich und Korrekturen, bevor Sie eine Erkennung konfigurieren.
- **Exportiert als:** die Abschnitte `cameras` und `recordings` der LumiScan-VGR-Einstellungen - siehe [Kameraeinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings/cameras.html) im Handbuch zu LumiScan VGR.
- **Verbindungen:** Eine Kamera ist die Quelle einer oder mehrerer Objekterkennungen.

Verwendet die Anwendung mehrere Kameras, etwa eine je Behälter (`cam_main`, `cam_bags`), legen Sie mehrere Kameraelemente an.

## Objekterkennungen (ObjectDetections) {#object-detections}

Ein Objekterkennungselement beschreibt, wie in den Daten der verbundenen Kamera Objekte gefunden werden: welches neuronale Netz verwendet wird, welche Objekte erkannt und lokalisiert werden sollen und wie - in 2D, in 3D oder kombiniert - und wie die Ergebnisse gefiltert und sortiert werden.

- **Vorschau:** Die ausgewählte Erkennung mit den aktuellen Einstellungen auf den aktuellen Kameradaten.
- **Exportiert als:** die Abschnitte `networks`, `objects` und `pipelines` der LumiScan-VGR-Einstellungen
  - siehe [Netzwerkeinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings/networks.html), [Objekteinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings/objects.html) und [Pipeline-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings/pipelines.html) im Handbuch zu LumiScan VGR.
- **Verbindungen:** Eingang von einer Kamera, Ausgang zu einem oder mehreren Robotern.

Neuronale Netze werden mit dem [LumiScan Training Framework](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/index.html) auf Bildern trainiert, die mit dem [LumiScan Annotation Framework](https://docs.hdvisionsystems.com/de/lumiscan-annotation-de/1.8.4/index.html) annotiert wurden.

## Roboter (Robots) {#robots}

Ein Roboterelement beschreibt einen Roboter - oder einen Roboter mit einem bestimmten Greifer -, der auf die Ergebnisse der verbundenen Objekterkennung reagiert: die Roboterbeschreibung (`.urdf`), die Hand-Auge-Kalibrierung, die den Roboter relativ zur Kamera platziert, den Greifer sowie die Positionen und Bewegungsabschnitte zum Anfahren und Ausführen eines Griffs. Wird Kollisionsvermeidung eingesetzt, werden hier auch die 3D-Daten von Roboter, Greifer und Behälter konfiguriert.

- **Vorschau:** Der Roboter in Bezug zu den Kameradaten mit den aktuellen Einstellungen.
- **Exportiert als:** der Abschnitt `robots` der LumiScan-VGR-Einstellungen - siehe [Robotereinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings/robots.html) im Handbuch zu LumiScan VGR.
- **Verbindungen:** Eingang von einer oder mehreren Objekterkennungen.

Ein physischer Roboter kann durch mehrere Roboterelemente dargestellt werden, zum Beispiel eines je Greifer.

## Element-IDs {#ids}

Die beim Anlegen eingegebene ID identifiziert das Element in der Graph-Übersicht und in den exportierten Einstellungen. IDs müssen innerhalb ihrer Kategorie eindeutig sein. Wählen Sie sprechende Namen - `cam_bags`, `network_bags`, `robot_arm` - statt Nummern; unter diesen Namen begegnen Ihnen die Elemente in LumiScan VGR wieder.

# FAQ – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/faq.html

Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan VGR Engineering. 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-export-settings`).

## Voraussetzungen, Installation und Lizenzierung

### Wofür wird LumiScan VGR Engineering verwendet? {#faq-what-is-vgr-engineering}

- **Antwort:** Es ist das Konfigurationswerkzeug für LumiScan VGR und andere Software von HD Vision Systems. Sie bauen die Konfiguration aus Kameras, Objekterkennungen und Robotern auf, prüfen jedes Element in einer Live-Vorschau und exportieren die Einstellungen in dem Format, das LumiScan VGR direkt einliest.
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/description.html)

### Was braucht der IPC, um LumiScan VGR Engineering auszuführen? {#faq-system-requirements}

- **Antwort:**
  - Windows 11
  - eine NVIDIA-GPU, die CUDA 11.8 unterstützt
  - CUDA Toolkit 11.8 und cuDNN 8.8.1 (die Installationsprogramme stellt HD Vision Systems bereit)
- **Mehr:** [Systemvoraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html)

### Brauche ich eine Kamera? {#faq-camera-required}

- **Antwort:** Nur für die Vorschau: eine LumiScanX oder eine andere kompatible Kamera, per Ethernet mit dem IPC verbunden. Ohne Kamera lässt sich die Konfiguration bearbeiten, speichern und exportieren, die Bild- und Punktwolkenvorschau bleibt jedoch leer. Stellen Sie vor Installation und Betrieb sicher, dass das Kameranetzwerk korrekt konfiguriert ist, und prüfen Sie Windows-Firewall und Virenschutz, wie im Handbuch zur LumiScan X beschrieben.
- **Mehr:** [Systemvoraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html#camera)

### Wie installiere ich LumiScan VGR Engineering? {#faq-installation}

- **Antwort:**
  1. Installieren Sie CUDA Toolkit 11.8 und cuDNN 8.8.1.
  2. Installieren Sie CodeMeter Runtime 9.00 oder neuer und schließen Sie den LumiScan Key an.
  3. Richten Sie die LumiScanX-Kamera nach ihrem Handbuch ein.
  4. Schließen Sie alle Anwendungen und starten Sie das Installationsprogramm von LumiScan VGR Engineering.
  5. Akzeptieren Sie die Lizenzbedingungen mit **Accept**, ändern Sie bei Bedarf den Ort mit **Browse** und klicken Sie dann auf **Next** und **Install**.
  6. Klicken Sie nach Abschluss auf **OK** und **Finish**.
- **Mehr:** [Installation](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html)

### Wie wird LumiScan VGR Engineering lizenziert? {#faq-licence}

- **Antwort:**
  - Bei HD Vision Systems gekauft: Die Lizenz liegt auf dem LumiScan Key und ist ein Jahresabonnement; die Verlängerung setzt ein gültiges Abonnement voraus. CodeMeter Runtime 9.00 oder neuer ist erforderlich.
  - Im ctrlX Store für Windows 11 gekauft: Sie benötigen ctrlX WORKS und einen LumiScan Key.
  - Pro Gerät, auf dem die Software gleichzeitig läuft, ist ein LumiScan Key nötig. Keys können zwischen Geräten getauscht werden.
- **Mehr:** [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)

## Eine Konfiguration aufbauen

### Wie baue ich meine erste Konfiguration auf? {#faq-first-configuration}

- **Antwort:** Kamera anlegen (Feld **id** in der Spalte **Cameras**, **Add**), ihre Vorschau prüfen, Objekterkennung anlegen und eine Verbindung von der Kamera zu ihr ziehen, Roboter anlegen und die Erkennung mit ihm verbinden, dann **Save** und **Download**.
- **Mehr:** [Erste Schritte](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/getting-started.html)

### Was sind Kameras, Objekterkennungen und Roboter? {#faq-elements}

- **Antwort:** Die drei Arten von Elementen einer Konfiguration. Ein Kameraelement ist eine physische Kamera mit ihren Aufnahmeeinstellungen, eine Objekterkennung beschreibt, welche Objekte in den Kameradaten wie gefunden werden, und ein Roboterelement beschreibt einen Roboter (und Greifer) mit Hand-Auge-Kalibrierung und Bewegungen. Von links nach rechts verbunden ergeben sie den Datenfluss: Kamera → Erkennung → Roboter.
- **Mehr:** [Konfigurationselemente](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html)

### Wie lege ich Elemente an, entferne oder verbinde sie? {#faq-graph-overview}

- **Antwort:**
  - Anlegen: eindeutige ID in das Feld **id** der Spalte eingeben und auf **Add** klicken.
  - Entfernen: Element auswählen und auf das **X** oben rechts im Element klicken.
  - Verbinden: vom Quellelement zum Zielelement ziehen. Eine Verbindung entfernen Sie per Doppelklick.
- **Mehr:** [Graph-Übersicht](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#graph-overview)

### Wozu dient die Element-ID, und kann ich sie ändern? {#faq-element-id}

- **Antwort:** Die ID identifiziert das Element in der Graph-Übersicht und in den exportierten Einstellungen; sie muss innerhalb ihrer Kategorie eindeutig sein. Wählen Sie beim Anlegen einen sprechenden Namen - die ID wird einmal eingegeben, beim Anlegen des Elements.
- **Mehr:** [Element-IDs](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/elements.html#ids)

### Kann ich die Einstellungen als JSON bearbeiten? {#faq-raw-json}

- **Antwort:** Ja. Der Editor lässt sich zwischen der Ansicht **Form** und der Ansicht **Raw JSON** umschalten. Beide zeigen dieselben Informationen und erlauben dieselben Änderungen.
- **Mehr:** [Editor](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#editor-panel)

### Wie navigiere ich in der Punktwolkenvorschau? {#faq-point-cloud-preview}

- **Antwort:** Ziehen mit der linken Maustaste dreht, Ziehen mit der rechten Maustaste verschiebt, das Mausrad zoomt. Die Schaltflächen oben rechts in der Vorschau wechseln zwischen Bild und Punktwolke. Die rote, grüne und blaue Linie zeigen die x-, y- und z-Achse im Koordinatenursprung.
- **Mehr:** [Vorschau](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#preview-panel)

## Fehlerbehebung {#troubleshooting}

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

- [Die Vorschau bleibt leer](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/troubleshooting.html#faq-preview-empty)

## Einstellungen speichern, exportieren und importieren

### Wie speichere ich meine Arbeit oder mache Änderungen rückgängig? {#faq-save-reload}

- **Antwort:** **Save** speichert den aktuellen Stand der Einstellungen. **Reload** lädt die zuletzt gespeicherten Einstellungen zurück in die Oberfläche und verwirft damit ungespeicherte Änderungen.
- **Mehr:** [Konfigurationsbereich](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#configuration-panel)

### Wie bekomme ich die konfigurierten Einstellungen in LumiScan VGR? {#faq-export-settings}

- **Antwort:** Klicken Sie im Konfigurationsbereich auf **Download**. Sie erhalten eine `.zip`-Datei mit den Einstellungen sowohl im Format von LumiScan VGR Engineering als auch im Format von LumiScan VGR oder anderer kompatibler Software. Spielen Sie die LumiScan-VGR-Einstellungen ein, wie im Handbuch zu LumiScan VGR beschrieben.
- **Mehr:** [Erste Schritte](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/getting-started.html), [LumiScan VGR: JSON-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings.html)

### Wie importiere ich vorhandene Einstellungen oder eine Kalibrierdatei? {#faq-upload}

- **Antwort:** Klicken Sie auf **Upload** oder ziehen Sie die Datei auf die Schaltflächen im Konfigurationsbereich. Sie können eine `.zip`-Datei hochladen, die aus LumiScan VGR Engineering heruntergeladen wurde - das stellt diese Konfiguration wieder her -, oder eine Datei, auf die die Einstellungen verweisen, zum Beispiel eine `.hdvcal`-Kamerakalibrierdatei.
- **Mehr:** [Konfigurationsbereich](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#configuration-panel)

## Support

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

- **Antwort:** Siehe die [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) der gesamten Dokumentation. Wenden Sie sich an Customer Success unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; bei Lizenzfragen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).

# Fehlerbehebung – LumiScan VGR Engineering

URL: https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/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-vgr-engineering-de/1.0.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support.

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

- Prüfen Sie, ob der IPC die [Systemvoraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html) erfüllt: Windows 11, eine NVIDIA-GPU, die CUDA 11.8 unterstützt, CUDA Toolkit 11.8 und cuDNN 8.8.1.
- Prüfen Sie, ob CodeMeter Runtime 9.00 oder neuer installiert und der LumiScan Key angeschlossen ist (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/installation.html#installing-codemeter-runtime)). 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.
- Prüfen Sie für die Vorschau, ob die Kamera per Ethernet mit dem IPC verbunden und nach ihrem Handbuch eingerichtet ist (siehe [Kamera](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/system-requirements.html#camera)). Meldungen und Punktwolkenprobleme der LumiScanX-Kamera selbst sind unter [LumiScan X: Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/troubleshooting.html) beschrieben.

## Problem: Die Vorschau bleibt leer {#faq-preview-empty}

**Symptome**

Die Vorschau zeigt für das Kameraelement weder ein Kamerabild noch eine Punktwolke.

**Mögliche Ursachen**

- Es ist keine Kamera angeschlossen. Ohne Kamera lässt sich die Konfiguration bearbeiten, speichern und exportieren, die Bild- und Punktwolkenvorschau bleibt jedoch leer.
- Das Kameranetzwerk ist nicht korrekt konfiguriert.
- Windows-Firewall oder Virenschutz blockieren die Verbindung zur Kamera.

**Diagnose**

1. Prüfen Sie, ob eine LumiScanX oder eine andere kompatible Kamera per Ethernet mit dem IPC verbunden ist - erwartet: Die Kamera ist angeschlossen und nach ihrem Handbuch eingerichtet.
2. Prüfen Sie die Netzwerkkonfiguration der Kamera, wie unter [LumiScan X: Netzwerkeinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-network-settings) beschrieben (für andere Kameras im Handbuch des Kameraherstellers) - erwartet: Die Einstellungen entsprechen dem Handbuch.
3. Prüfen Sie die Einstellungen der Windows-Firewall und des Virenschutzes, wie unter [LumiScan X: Windows-Firewall](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-windows-firewall) und [LumiScan X: Virenschutz](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-virus-protection) beschrieben - erwartet: Sie blockieren die Kamera nicht.
4. Wählen Sie das Kameraelement in der [Graph-Übersicht](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#graph-overview) erneut aus - erwartet: Die [Vorschau](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#preview-panel) zeigt das Kamerabild oder die Punktwolke. Die Vorschau wird aktualisiert, sobald sich eine Einstellung ändert, die das Element betrifft.

**Lösung**

- **Wenn keine Kamera angeschlossen ist:** Schließen Sie eine LumiScanX oder eine andere kompatible Kamera per Ethernet an den IPC an und richten Sie sie nach ihrem Handbuch ein. Wählen Sie dann das Kameraelement erneut aus.
- **Wenn das Kameranetzwerk nicht korrekt konfiguriert ist:** Konfigurieren Sie es wie im [Handbuch zur LumiScan X](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/index.html) beschrieben, für andere Kameras wie im Handbuch des Kameraherstellers. Wählen Sie dann das Kameraelement erneut aus.
- **Wenn Windows-Firewall oder Virenschutz die Verbindung blockieren:** Ändern Sie deren Einstellungen wie im Handbuch zur LumiScan X beschrieben (siehe Diagnose). Wählen Sie dann das Kameraelement erneut aus.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit Kameramodell und Seriennummer der Kamera und einem Screenshot der leeren Vorschau.

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

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

- Produkt und Version: LumiScan VGR Engineering und seine Softwareversion.
- Betriebssystem: Windows 11, mit den installierten Versionen von CUDA Toolkit und cuDNN.
- Bezugsquelle der Software: HD Vision Systems oder ctrlX Store.
- Die Seriennummer des LumiScan Key (`3-…`, auf dem Key aufgedruckt) und gegebenenfalls die Seriennummer der Kamera.
- Die genaue Fehlermeldung, ein Screenshot sowie Datum und Uhrzeit, zu der das Problem auftrat.
- Die Konfiguration: die `.zip`-Datei, die **Download** im [Konfigurationsbereich](https://docs.hdvisionsystems.com/de/lumiscan-vgr-engineering-de/1.0.0/user-interface.html#configuration-panel) erzeugt, und die Dateien, auf die die Einstellungen verweisen, zum Beispiel die `.hdvcal`-Kalibrierdatei und die Roboterbeschreibung (`.urdf`).

Wenden Sie sich an Customer Success unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder unter der Telefonnummer +49 6221 6721905. Bei Lizenzfragen wenden Sie sich an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).
