--- title: "FAQ" description: "Häufig gestellte Fragen zu LumiScan Training - Voraussetzungen und Installation, Hailo PlugIn und Podman, JSON-Konfiguration, Training, Modellkonvertierung, gemeinsames Backend und Lizenzierung." product: "LumiScan Training" component: "lumiscan-training-de" version: "2.3.0" display_version: "2.3.0.2" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/faq.html" --- # FAQ – LumiScan Training Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan Training. 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-json-paths-null`). ## Voraussetzungen und Installation ### Welche Systemvoraussetzungen gelten? {#faq-system-requirements} - **Antwort:** - Windows 11 Professional oder Windows 11 Enterprise - NVIDIA-RTX-Grafikkarte - CUDA Toolkit 11.8 - CodeMeter 9.00 oder höher - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/requirements.html) ### Wie installiere ich LumiScan Training, und brauche ich Python? {#faq-installation} - **Antwort:** Starten Sie das Setup-Programm (der Dateiname beginnt mit `Installer_` und endet mit der Versionsnummer, zum Beispiel `Installer_LumiScanTrainingFramework_v2_1_0_0.exe`) und bestätigen Sie die Abfrage zu Administratorrechten; diese sind für den Standardspeicherort unter `C:\Program Files` erforderlich. Das Setup-Programm enthält eine eigene Python-Umgebung, eine separate Python- oder Anaconda-Installation ist nicht erforderlich. Als Installationssprache stehen Deutsch und Englisch zur Verfügung. - **Mehr:** [LumiScan Training Installation](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-lumiscan-training) ### In welcher Reihenfolge installiere ich die Komponenten für eine Hailo-TPU? {#faq-hailo-installation-order} - **Antwort:** Nur erforderlich, wenn eine Hailo-TPU verwendet wird. Halten Sie diese Reihenfolge ein: Das Hailo PlugIn prüft seine Voraussetzungen nacheinander und bricht bei der ersten fehlenden ab, eine andere Reihenfolge kann daher zusätzliche Installationsversuche erfordern. 1. Podman CLI 6.0.x für Windows mit **Windows Hyper-V** als Virtualisierungs-Provider (das Abbild des Hailo PlugIn ist für Podman 6.0 erstellt; neuere CLIs sind nicht getestet). 2. Das Hailo PlugIn (der Dateiname des Setup-Programms beginnt mit `Installer-LumiScanTraining-HailoPlugIn`). Die Installation kann 10 bis 20 Minuten oder länger dauern; unterbrechen Sie sie nicht. 3. LumiScan Training. - **Mehr:** [Podman installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-podman), [Hailo PlugIn installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-hailo-plugin) ### Was benötigt der Computer für das Hailo PlugIn? {#faq-hailo-requirements} - **Antwort:** Mindestens 24 GB Arbeitsspeicher (DRAM), da die Modellkonvertierung in einer virtuellen Maschine mit 18 GB Arbeitsspeicher läuft, sowie Hardware, die Hyper-V unterstützt. Hyper-V muss nicht vorab aktiviert werden; das Installationsprogramm des Hailo PlugIn bietet die Aktivierung an. Auf Windows-Home-Editionen steht Hyper-V nicht zur Verfügung, das Hailo PlugIn kann dort nicht verwendet werden. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/requirements.html), [Podman installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-podman) ### Die Windows-Firewall fragt, ob `podman.exe` auf das Netzwerk zugreifen darf. Was soll ich tun? {#faq-podman-firewall} - **Antwort:** Es wird empfohlen, die Anfrage mit **Cancel** abzulehnen. Die Modellkonvertierung läuft vollständig auf dem lokalen Computer und funktioniert auch ohne Netzwerkzugriff. - **Mehr:** [Hailo PlugIn installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-hailo-plugin) ## Fehlerbehebung {#troubleshooting} Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html) beschrieben: - [**Model Conversion** ist nicht verfügbar, oder `podman` bzw. das Konvertierungsabbild wird nicht gefunden](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#faq-model-conversion-unavailable) - [Das Training schlägt wegen unzureichenden GPU-Speichers fehl oder dauert ungewöhnlich lange](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#faq-gpu-memory) - [Die Modellkonvertierung bricht mit Exit-Code 137 ab](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#faq-exit-code-137) - [Die Modellkonvertierung dauert länger als erwartet](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#faq-conversion-slow) - [Ein Client kann keine Verbindung zum gemeinsamen Backend herstellen](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#faq-client-cannot-connect) ## Konfiguration und Training ### Wie schreibe ich Pfade und leere Werte in der JSON-Konfiguration? {#faq-json-paths-null} - **Antwort:** Verwenden Sie in Pfaden Schrägstriche (`/`) statt Backslashes (`\`), zum Beispiel `C:/Users/user_name/Desktop/recordings/raw`. Für einen Parameter, der einen leeren Wert unterstützt, schreiben Sie genau `null`, ohne Anführungszeichen und Großbuchstaben (zum Beispiel `"networkBase": null`, um ohne vorhandenes Netzwerk zu trainieren). - **Mehr:** [Beschreibung der JSON-Parameter](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/json-settings.html#json-parameters-description) ### Welchen Wert verwende ich für `networkType`? {#faq-network-type} - **Betrifft:** LumiScan VGR und AI Object Matching - **Antwort:** - LumiScan VGR: `ORTML`, `ORTMM`, `ORTMS` oder `ORTMXS` (orientierte Modelle), wenn das Objekt eine sinnvolle Ausrichtung hat, die identifiziert werden muss; `RRTML`, `RRTMM`, `RRTMS` oder `RRTMXS` (rotierte Modelle), wenn nur die Rotation benötigt wird. Das Suffix gibt die Größe an (L, M, S, XS); `ORTM` und `RRTM` ohne Suffix sind ungültig. - AI Object Matching: `OOD` für Objekte mit sinnvoller Ausrichtung, `ROD`, wenn nur die Rotation benötigt wird. - **Mehr:** [Beschreibung der JSON-Parameter](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/json-settings.html#json-parameters-description) ### Wo werden trainierte Modelle und Ergebnisse gespeichert? {#faq-results-location} - **Antwort:** Exportierte ONNX-Modelle und weitere Trainingsergebnisse werden unter `exportDirectory` gespeichert; ist kein Pfad angegeben, im Verzeichnis der Trainingsdaten (`trainingData`). **Start Testing** speichert seine Ergebnisse im Export-Ordner, **Start Inference** die Vorhersagen im Ordner `predictions` innerhalb des Exportverzeichnisses. - **Mehr:** [Beschreibung der JSON-Parameter](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/json-settings.html#json-parameters-description), [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/user-interface.html) ### Was bedeuten die Meldungen unter **Process Status**? {#faq-process-status} - **Antwort:** - `Waiting for configuration file!`: Es wurde noch keine Konfigurationsdatei ausgewählt (über **Select Config File/Browse**). - `Testing Network!`: Nach **Start Testing** wird ein vorhandenes Netzwerk mit dem Testdatensatz getestet. - `Waiting for deployment!`: Nach dem Training wird das Netzwerk für die Konvertierung und den Export in eine ONNX-Datei vorbereitet. - `Finished cleanup`: Der Vorgang ist abgeschlossen. - **Latest test scores**: Eine Metrik zum Vergleich von Netzwerken, die mit demselben Datensatz getestet wurden, kein absolutes Leistungsmaß. - **Mehr:** [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/user-interface.html) ## Modellkonvertierung (ONNX zu Hailo) ### Welche Kalibrierbilder benötige ich für die Modellkonvertierung? {#faq-calibration-images} - **Antwort:** Die Kalibrierbilder müssen dieselbe Auflösung wie die Trainingsbilder haben, sonst kann das Modell unbrauchbar werden. Nehmen Sie sie unter realen Produktionsbedingungen auf (dieselbe Kamera, Optik, Arbeitsdistanz und dieselben Objekte) und beziehen Sie repräsentative Beleuchtungsbedingungen ein. Legen Sie sie in einem einzigen Ordner ab; unterstützte Formate sind unter anderem `.png`, `.jpg`, `.jpeg`, `.bmp` und `.tiff`. - **Mehr:** [Modellkonvertierung: ONNX zu Hailo](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/model-conversion.html) ### Welche Dateien erzeugt die Konvertierung? {#faq-conversion-output} - **Antwort:** Nach `Conversion finished successfully.` enthält der Ausgabeordner `.hef` (Modell für die Hailo-TPU), `.har` (Zwischenarchiv), `_hailo.onnx` (für Hailo angepasstes ONNX-Modell) und `convert_parameters.json` (Konvertierungsparameter), wobei `` der Name der ONNX-Datei ist. Standardmäßig ist der Ausgabeordner der Ordner der ONNX-Datei. - **Mehr:** [Parameter der Modellkonvertierung](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/model-conversion.html#model-conversion-parameters) ## Gemeinsames Backend ### Wie können mehrere Computer ein gemeinsames Backend von LumiScan Training nutzen? {#faq-shared-backend} - **Antwort:** Öffnen Sie auf dem Server **App Settings**, lassen Sie **Start backend locally** aktiviert, setzen Sie **Backend bind address** auf die Netzwerk-IP-Adresse des Computers oder `0.0.0.0 (all interfaces)` (nicht `localhost (127.0.0.1)`), aktivieren Sie **Autostart backend as a service**, klicken Sie auf **Save** und starten Sie neu. Clients öffnen entweder `http://:8420` im Webbrowser, oder sie deaktivieren in ihrer eigenen Installation **Start backend locally** und tragen den Server unter **Remote backend address** ein. - **Mehr:** [Einrichten eines gemeinsamen Backend-Servers](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/app-settings.html#app-settings-server), [Verbindung von einem Client-Computer](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/app-settings.html#app-settings-client) ## Lizenzierung und Support ### Wie wird LumiScan Training lizenziert? {#faq-licence} - **Antwort:** LumiScan Training benötigt CodeMeter 9.00 oder höher. 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-training-de/2.3.0/requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html) ### 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).