--- title: "FAQ" description: "Häufige Fragen zu LumiScan AI Object Matching auf ctrlX OS und auf einem PC - Modelle und Konfiguration, Bildquelle, Inferenz ausführen, FlatBuffers-Ergebnisse in ctrlX PLC Engineering lesen und Lizenzierung." product: "LumiScan AI Object Matching" component: "lumiscan-ai-object-matching-de" version: "2.1.0" display_version: "2.1.0.9" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/faq.html" --- # FAQ – LumiScan AI Object Matching Kurze Antworten auf häufige Fragen zu LumiScan AI Object Matching. Jeder Eintrag verweist auf die Seite mit den Details. Probleme und Fehlermeldungen sind unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html) beschrieben. > [!TIP] > Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-run-inference`). Um eine Fehlermeldung zu finden, durchsuchen Sie die Seite [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html) danach. ## Erste Schritte ### Was macht LumiScan AI Object Matching, und was benötigt es? {#faq-what-it-does} - **Antwort:** Es erkennt mit einem trainierten neuronalen Netz Objekte in Bildern und meldet deren Position und Orientierung in Pixelkoordinaten. Es läuft auf ctrlX OS (ctrlX CORE oder ctrlX IPC) mit dem ctrlX Data Layer oder auf einem PC (Windows 11 oder Ubuntu 24.04) mit LumiScan Keryx und wird über den Data Layer gesteuert; die Knotenadressen sind auf beiden gleich. Es nimmt selbst keine Bilder auf; es liest Bilder, die eine andere Anwendung veröffentlicht, zum Beispiel der LumiScan Cam Driver (`hdvisionsystems/lumiscan-cam-driver/camera1/output/image`). Das Modell wird mit dem LumiScan Annotation Framework und dem LumiScan Training Framework erstellt. - **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/description.html), [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/requirements.html) ### Kann ich die TPU-Beschleunigung verwenden, und was sind die Voraussetzungen? {#faq-tpu-acceleration} - **Betrifft:** ctrlX OS - **Antwort:** Die TPU-Beschleunigung ist optional. Wird sie verwendet, muss die ctrlX CORE eine TPU enthalten, und es gelten die folgenden Versionen: ctrlX CORE X3 mit App-Version v1.2 oder neuer, ctrlX CORE X7 mit App-Version v1.1 oder neuer und App Hardware Support genau 2.6.2. Mit einer HAILO-TPU ist das Zurückstufen des Hardware Support auf v2.6.2 zwingend erforderlich. Setzen Sie in der JSON-Datei des Modells `provider` auf `HAILO`. Auf einem PC verwenden Sie stattdessen eine NVIDIA-GPU mit `provider` auf `CUDA`. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/requirements.html), [Release Notes: v1.2.0](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/release-notes/v1-2-0.html) ## Konfiguration ### Wo sind die Konfigurationsdateien? {#faq-config-files} - **Antwort:** Im Ordner `lumiscan-ai-object-matching`. Auf ctrlX OS öffnen Sie in der Weboberfläche von ctrlX OS **Home** > **Manage app data**, wählen **File View** und öffnen diesen Ordner. Auf einem PC ist es der Einstellungsordner der Anwendung: unter Windows `%APP_RESOURCE_DIR%\etc\lumiscan-ai-object-matching`, oder ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-ai-obj-mat\etc\lumiscan-ai-object-matching`. Starten Sie die Anwendung neu, nachdem Sie eine Datei geändert haben. Die Einstellungen können auch auf dem Data Layer unter `hdvisionsystems/lumiscan-ai-object-matching/system/settings` gelesen und geändert werden. Der Ordner enthält: - `ai-object-matching.json`: Konfiguration der Anwendung (`inputFileType` `LumiScan-CtrlX-AI-Object-Matching`); `modules` listet die Modulkonfigurationsdateien auf. - Eine Modulkonfigurationsdatei (zum Beispiel `ai-object-matching-module.json`, `inputFileType` `LumiScan-CtrlX-AI-Object-Matching-Module`). Ihr `name` ist der Netzname, der in der Data-Layer-Adresse verwendet wird, und `neuralNetworkConfig` verweist auf die JSON-Datei des Modells. - `models`: die Modelldateien. - **Mehr:** [Ordnerstruktur von LumiScan AI Object Matching](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/folder-structure.html), [Einstellungen auf dem Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/settings-on-the-data-layer.html) ### Was ist im Ordner models, und welche Modellparameter darf ich ändern? {#faq-model-files} - **Antwort:** Der Ordner models enthält zwei vom LumiScan Training Framework erzeugte Dateien, die zusammengehören: eine `.onnx`-Datei mit dem trainierten Netz und eine `.json`-Datei mit den Erkennungsparametern. Nur diese JSON-Parameter sollten von Hand geändert werden; starten Sie die Anwendung danach neu: - `thresholdList`: Mindestkonfidenz je Klasse, zwischen `0.0` und `1.0` (`1.0` = 100 %). - `pathToNetwork`: Pfad zur `.onnx`-Datei, relativ zur JSON-Datei. - `provider`: `CPU` oder `HAILO` auf ctrlX OS, `CPU` oder `CUDA` (eine NVIDIA-GPU) auf einem PC. - `deviceIndex`: muss derzeit `0` sein. - **Mehr:** [Ordner models](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/models-folder.html) ### Wie verwende ich ein neu trainiertes Modell? {#faq-new-model} - **Antwort:** Laden Sie das neue Modell zusammen mit seiner Beschreibungsdatei hoch (sie werden immer als eine Einheit behandelt); auf einem PC kopieren Sie beide in den Ordner `models` des Einstellungsordners. Stellen Sie sicher, dass die Modulkonfigurationsdatei in `modules` von `ai-object-matching.json` aufgeführt ist und dass ihr `neuralNetworkConfig` auf die JSON-Datei des neuen Modells verweist. Prüfen Sie die übrigen Moduleinstellungen, speichern Sie und starten Sie die Anwendung neu. - **Mehr:** [Neues Modul hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/adding-new-module.html), [Daten hochladen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/uploading-data.html) ### Welche Bildformate und Bildquellen werden unterstützt? {#faq-image-source} - **Antwort:** Eine im Modul konfigurierte externe Bildadresse muss `
/data` (Array von `uint8_t`), `
/height` und `
/width` (`uint32_t`) sowie `
/pixel-type` (`Mono8` oder `RGB8`) bereitstellen. Diese Schnittstelle ist für den LumiScan Cam Driver entworfen und getestet; für andere Quellen wird die Funktion nicht garantiert. Ist keine externe Bildadresse konfiguriert, legt das Modul `hdvisionsystems/lumiscan-ai-object-matching//input/image` an, wo Sie das Rohbild schreiben und seine Breite, Höhe und sein Pixelformat setzen. RGB-Daten sind als Höhe, Breite, Kanal angeordnet. Ab v2.2.0 kann ein Modul auch den Bild-Stream des Cam Driver inferieren (experimentell). - **Mehr:** [Konfigurationsdatei eines Moduls](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/module-configuration-file.html), [Inferenz auf einem Bild-Stream](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/inference-on-an-image-stream.html) ## Inferenz ausführen ### Wie starte ich eine Inferenz und erhalte das Ergebnis? {#faq-run-inference} - **Antwort:** Verwenden Sie den ready/request-Handshake auf `hdvisionsystems/lumiscan-ai-object-matching//control/inference/`: Warten Sie, bis `ready` `True` ist, merken Sie sich den Wert von `/output/package-identifier`, setzen Sie `request` auf `True`, warten Sie, bis `ready` `False` ist (die Inferenz läuft bereits), setzen Sie `request` auf `False` und warten Sie, bis `ready` wieder `True` ist. Ist `output/package-identifier` um eins gestiegen, war die Inferenz erfolgreich: Lesen Sie das Ergebnis unter `/output/result`. `status/code` ist am Ende jeder über den Handshake angeforderten Inferenz `3`, unabhängig davon, ob sie erfolgreich war. Ab v2.1.0 können Sie stattdessen einmal auf `/control/inference/execute` schreiben, was bis zum Abschluss der Operation blockiert; `status/code` behält dann den Ausgang: `0`, `100001` oder `-1`. Nur ein Prozess darf `request` zur Zeit schreiben. - **Mehr:** [Inferenz starten](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/initializing-the-inference.html), [Ausgang einer Inferenz](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/general-concept-of-handshake.html#outcome-of-an-inference), [Release Notes: v2.1.0](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/release-notes/v2-1-0.html) ### Wie beschränke ich das Ergebnis auf bestimmte Klassen? {#faq-class-filters} - **Antwort:** Schreiben Sie die Namen der aufzunehmenden Klassen auf `hdvisionsystems/lumiscan-ai-object-matching//input/class-filters`; lassen Sie das Array leer, um die Filterung zu deaktivieren. Mit der Standard-Klassenzuordnung ist `class_index` im Ergebnis die Position der Klasse im class-names-Array des Netzes. Das Array `instances` kann Objekte verschiedener Klassen enthalten, das SPS-Programm muss also die benötigte Klasse auswählen. - **Mehr:** [Klassennamen und Klassenfilter](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/accessing-flatbuffers-data.html#lumiscan-class-names-and-filters) ## Ergebnisse in ctrlX PLC Engineering lesen ### Wo bekomme ich das FlatBuffers-Schema für das Ergebnis? {#faq-flatbuffers-schema} - **Betrifft:** ctrlX OS - **Antwort:** Der Ergebnisknoten `/output/result` ist eine FlatBuffers-Nachricht, die durch `object_detection.fbs` beschrieben wird. Die Anwendung kopiert diese Datei bei jedem Start nach `lumiscan-ai-object-matching/schemas/flatbuffers`; laden Sie sie in **Manage app data** mit dem Download-Symbol in der Spalte **Actions** oder über WebDAV herunter. Bearbeiten Sie keine Dateien in `schemas`, da der Ordner bei jedem Start neu angelegt wird. Laden Sie das Schema nach einem Update der Anwendung erneut herunter und importieren Sie es erneut. - **Mehr:** [Zugriff auf Ergebnisdaten mit FlatBuffers](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/accessing-flatbuffers-data.html) ### Wie importiere ich das Schema in mein SPS-Projekt? {#faq-import-schema} - **Antwort:** Sie benötigen ctrlX PLC Engineering 2.6 oder neuer und die Bibliotheken `CXA_Datalayer` und `CXA_Flatbuffers` im **Library Manager**. Klicken Sie im Gerätebaum mit der rechten Maustaste auf **Application**, wählen Sie **Import from FlatBuffers file…** und wählen Sie `object_detection.fbs`. Fehlt **Import from FlatBuffers file…** im Kontextmenü, fehlt die ctrlX-Data-Layer-Bibliothek: Installieren Sie `CXA_Datalayer` über **Tools** > **Library Repository…** und wiederholen Sie den Import. - **Mehr:** [Die ctrlX-Data-Layer-Bibliothek installieren](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/accessing-flatbuffers-data.html#lumiscan-install-datalayer-library) ### Wie lese ich Position und Score der besten Erkennung? {#faq-read-position-score} - **Antwort:** Nachdem die Inferenz abgeschlossen und erfolgreich war (Handshake: `output/package-identifier` ist um eins gestiegen; `inference/execute`: `status/code` ist `0`), lesen Sie den Ergebnisknoten mit `DL_ReadNodeValue` und übergeben `GetData` und `GetSize` des `DL_NodeValue` an `getRootAsResult` von `hdv_object_detection2d_Result`. Die Instanzen sind nach Score sortiert (höchster zuerst); `getBestIndex()` liefert immer die beste. Von der Instanz liefert `GetScore()` den Score (0.0 bis 1.0) und `getOrientedBoundingBox()` die Box mit `GetCenterX()`/`GetCenterY()` in Pixeln; der Winkel ist in Grad und kann negativ sein. Die Funktionsbausteine lesen den Puffer an Ort und Stelle, verwenden oder kopieren Sie die Werte also vor dem nächsten Lesen. - **Mehr:** [Beispiel: Position und Score einer Instanz lesen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/accessing-flatbuffers-data.html#lumiscan-example-instance) ## Fehlerbehebung {#troubleshooting} Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html) beschrieben: - [inference/ready bleibt False, oder die Inferenz endet mit Status 100001](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-no-new-external-image) - [status/code ist nach jeder Inferenz 3](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-status-3-after-inference) - [Ein Schreibvorgang auf execute wird abgelehnt](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-execute-refused) - [Eine Inferenz-Anfrage wird mit Status 100002 (StreamActive) beantwortet](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-stream-active) - [Jedes Modul meldet Status -5 (restartRequired)](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-restart-required) - [Der Ordner schemas existiert nicht](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-schemas-folder-missing) - [Import from FlatBuffers file… fehlt im Kontextmenü](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#ts-import-command-missing) - [Nach dem Import erscheint die Meldung "Identifier 'VectorT' not defined"](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-vectort-not-defined) ## Lizenzierung und Support ### Welche Lizenz benötige ich, und was passiert ohne Lizenz? {#faq-licence} - **Antwort:** Die ctrlX-Lizenz für LumiScan AI Object Matching ist `SWL-W-XCx-OBJxMATCHxHDVSx-V2NN`. Im ctrlX Store für ctrlX OS gekauft, ist sie eine ctrlX-Lizenz und benötigt keinen LumiScan Key. Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start, wenn die Lizenz fehlt; der Grund steht im Systemprotokoll. Eine fehlende Lizenz wird als Status `-4` `"MissingLicense"` gemeldet. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html) ### Wo finde ich weitere Antworten oder erhalte Support? {#faq-support} - **Antwort:** Siehe die [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) der gesamten Dokumentation. Wenden Sie sich an den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; für Lizenzen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). - **Mehr:** [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)