--- title: "FAQ" description: "Häufige Fragen zu LumiScan Calibration - TIFF-Kalibrierdaten, Konfigurationsdateien, 2D-zu-3D-Transformation, Statuscodes und Lizenzierung, mit Verweisen auf die Fehlerbehebung." product: "LumiScan Calibration" component: "lumiscan-calibration-de" version: "2.0.0" display_version: "2.0.0.8" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/faq.html" --- # FAQ – LumiScan Calibration Kurze Antworten auf häufige Fragen zu LumiScan Calibration. Jeder Eintrag verweist auf die Seite mit den Details. Probleme und Fehlermeldungen sind unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html) beschrieben. > [!TIP] > Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-status-codes`). Um eine Fehlermeldung zu finden, durchsuchen Sie die Seite [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html) danach. ## Erste Schritte ### Was macht LumiScan Calibration? {#faq-what-does-calibration-do} - **Antwort:** Es rechnet 2D-Bildkoordinaten in die zugehörigen 3D-Koordinaten auf einer kalibrierten Ebene um, zum Beispiel für das Bin Picking mit Robotern oder das Ablegen von Objekten. Die Umrechnung verwendet Kalibrierdaten aus einer TIFF-Datei. Die Anwendung läuft auf ctrlX OS (ctrlX CORE oder ctrlX IPC) und auf einem PC mit Windows 11 oder Ubuntu 24.04. Sie wird mit JSON-Einstellungsdateien konfiguriert und über den Data Layer gesteuert (Eingaben, Ausgaben und Status): den ctrlX Data Layer auf ctrlX OS, LumiScan Keryx auf einem PC. Ab v2.1.0 kann ein Modul auch einen Stream von Punkten transformieren, sobald sie eintreffen (experimentell). - **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/description.html), [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/requirements.html) ### Wie erhalte ich die TIFF-Kalibrierdatei? {#faq-get-tiff-file} - **Antwort:** Die TIFF-Datei wird aus Kalibrierbildern erzeugt und von HD Vision Systems bereitgestellt: - Wenden Sie sich an HD Vision Systems, um eine Kalibrierplatte zu erhalten. - Legen Sie die Platte auf die Ebene, die Sie kalibrieren möchten. - Nehmen Sie mit der Kamera mindestens ein Bild der Platte auf. - Senden Sie die Bilder an HD Vision Systems; Sie erhalten die zugehörige TIFF-Datei. - **Mehr:** [TIFF-Datei](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/tiff-file.html) ### Wie lade ich die TIFF-Datei und die Konfigurationsdateien hoch? {#faq-upload-files} - **Antwort:** Auf ctrlX OS können die meisten Daten direkt über die ctrlX Web UI hochgeladen werden. Alternativ verwenden Sie WebDAV, zum Beispiel mit WinSCP: Wählen Sie **WebDAV** als **File protocol** und **TLS/SSL** als **Encryption**, melden Sie sich an, navigieren Sie zu `/solutions/webdav/appdata` und ziehen Sie die Dateien in den Anwendungsordner von LumiScan Calibration. Auf einem PC sind die Dateien gewöhnliche Dateien: Kopieren Sie sie in den Einstellungsordner der Anwendung (unter Windows `%APP_RESOURCE_DIR%\etc\lumiscan-calibration`, oder ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-calib\etc\lumiscan-calibration`). Die TIFF-Datei ist erforderlich; Konfigurationsdateien sind optional. - **Mehr:** [Daten hochladen](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/uploading-data.html) ## Konfiguration ### Wo liegen die Konfigurationsdateien, und wie sind sie aufgebaut? {#faq-config-files} - **Antwort:** Auf ctrlX OS öffnen Sie **Home** > **Manage app data** in der Weboberfläche von ctrlX OS, wählen **File View** und öffnen den Ordner `lumiscan-calibration`. Auf einem PC liegen sie im Einstellungsordner `lumiscan-calibration` (unter Windows in `%APP_RESOURCE_DIR%\etc`, oder ohne `APP_RESOURCE_DIR` in `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-calib\etc`). Der Ordner enthält: - `lumiscan-calibration.json`: Anwendungseinstellungen; `modules` führt die zu ladenden Modul-Konfigurationsdateien auf. - `.json` (zum Beispiel `example.json`): Einstellungen eines Transformationsmoduls. - `.tiff`: Kalibrierdaten, bereitgestellt von HD Vision Systems. - `schemas`: die Schemata, die die Einstellungsdateien für einen Editor beschreiben. Starten Sie LumiScan Calibration nach einer Änderung von `lumiscan-calibration.json` neu. Nach einer Änderung einer Modul-Konfigurationsdatei oder ihrer TIFF-Datei genügt ein Reset des Moduls (`control/reset`). Die Einstellungen können auch auf dem Data Layer gelesen und geändert werden, auf `hdvisionsystems/lumiscan-calibration/system/settings`. - **Mehr:** [Ordnerstruktur von LumiScan Calibration](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/folder-structure.html#edit-with-built-in-website), [Anwendungs-Einstellungsdatei](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/application-settings-file.html), [Einstellungen auf dem Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/settings-on-the-data-layer.html) ### Wie füge ich ein neues Transformationsmodul hinzu? {#faq-add-module} - **Antwort:** Kopieren Sie eine vorhandene Moduldatei unter einem neuen Namen (auf ctrlX OS: drei Punkte > **Copy**, neuen Dateinamen eingeben und mit **Copy** bestätigen; auf einem PC: die Datei im Einstellungsordner kopieren). Fügen Sie dann den neuen Dateinamen der Liste `modules` in `lumiscan-calibration.json` hinzu und starten Sie die Anwendung neu. Der Name der Datei ohne `.json`, in Kleinbuchstaben, ist der Name des Moduls auf dem Data Layer: `hdvisionsystems/lumiscan-calibration/`. Der `name` im Block `transform` des Moduls ändert ihn nicht. Alternativ legen Sie das Modul über den Data Layer mit `system/control/create-module/execute` und `system/control/activate-module/execute` an und aktivieren es, und starten dann mit `system/control/restart/execute` neu. - **Mehr:** [Neues Modul hinzufügen](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/adding-new-module.html), [Module hinzufügen und entfernen](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/settings-on-the-data-layer.html#adding-and-removing-modules) ### Welche Transformationsparameter kann ich einstellen? {#faq-module-parameters} - **Antwort:** Im Block `transform` einer Moduldatei: - `type`: Nur `from2dTo3d` wird unterstützt; `subtype`: `lookUpTable`. - `relativePathToTiff`: Pfad zur TIFF-Kalibrierdatei, relativ zur Moduldatei. - `interpolationMethod`: `closestPixel`, `linear4Neighbors` oder `bilateralInterpolation`. - `offsetX`, `offsetY` (Standard `0.0`) und `scaleX`, `scaleY` (Standard `1.0`). Ein optionaler, experimenteller Abschnitt `stream` konfiguriert einen Stream von Punkten, die transformiert werden sollen. - **Mehr:** [Modul-Konfigurationsdatei](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/module-configuration-file.html#table-5-module-settings) ## Betrieb ### Wie rechne ich einen 2D-Bildpunkt in einen 3D-Punkt um? {#faq-convert-point} - **Antwort:** Mit `XXX` = `hdvisionsystems/lumiscan-calibration/`: - Prüfen Sie, ob `XXX/control/transform/ready` `true` ist. - Setzen Sie `XXX/input/x-coordinate` und `XXX/input/y-coordinate` auf die Pixelkoordinaten. Um mehrere Punkte auf einmal umzurechnen, schreiben Sie zusätzlich `XXX/input/x-coordinate-array` und `XXX/input/y-coordinate-array`; lassen Sie sie leer, um nur einen Punkt umzurechnen. - Setzen Sie `XXX/control/transform/request` auf `true`, warten Sie, bis `ready` `false` ist, und setzen Sie dann `request` auf `false`. Warten Sie, bis `ready` wieder `true` ist. Alternativ schreiben Sie einen beliebigen Wert auf `XXX/control/transform/execute`: Der Schreibzugriff kehrt zurück, wenn der Transform abgeschlossen ist. - Prüfen Sie, ob `XXX/control/status/code` `0` (`"ready"`) ist, und lesen Sie `XXX/output/x-coordinate`, `y-coordinate` und `z-coordinate` (und die Ausgabe-Arrays). - **Mehr:** [Punkte transformieren](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/functionalities.html#transform), [Execute-Methoden](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/functionalities.html#execute) ### Was bedeuten die Statuscodes? {#faq-status-codes} - **Antwort:** `hdvisionsystems/lumiscan-calibration//control/status/code` meldet den Ausgang der letzten Funktion: `0` `"ready"` (letzte Funktion erfolgreich), `1` `"settingUp"`, `2` `"running"`, `3` `"waitingForClient"`, `-1` `"undefinedError"`, `-2` `"invalidSetting"` (Modul-Konfigurationsdatei oder TIFF-Datei konnte nicht geladen werden), `-3` `"invalidInput"` (ein oder mehrere Eingabewerte sind ungültig), `-4` `"missingLicense"` (ctrlX OS: erforderliche Lizenz nicht verfügbar), `-5` `"restartRequired"` (Einstellungen auf dem Data Layer geändert: Anwendung neu starten), `-10001` `"inputXYSizeNotEqual"` (die Eingabe-Arrays sind unterschiedlich lang). Ein Fehlerstatus bleibt bis zum nächsten Request stehen. - **Mehr:** [Statuscodes](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/functionalities.html#status-code-values) ## Fehlerbehebung {#troubleshooting} Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html) beschrieben: - [Ein Calibration-Modul erscheint nicht im Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-module-not-in-data-layer) - [Data-Layer-Adressen unter lumiscan-cam-calibration funktionieren nicht mehr](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-data-layer-name) - [`transform/ready` bleibt `false`, und der Status ist -2](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-transform-not-ready) - [Die Anwendung reagiert nicht auf einen Request](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-request-not-detected) - [Die transformierten Koordinaten passen nicht zum Bild](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-coordinates-wrong) - [Der Stream startet nicht](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#ts-stream-does-not-start) - [Der Stream läuft, aber es kommen keine Punkte an](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#ts-stream-no-points) ## Lizenzierung und Support ### Welche Lizenz brauche ich, und was passiert ohne? {#faq-licence} - **Antwort:** Die ctrlX-Lizenz für LumiScan Calibration ist `SWL-W-XCx-CALIBRATExHDVSx-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 Lizenz, die verloren geht, während die Anwendung läuft, wird als Status `-4` `"missingLicense"` gemeldet, und das Modul führt keine Funktion aus, bis sie wieder vorhanden ist. Für einen PC siehe die Lizenzinformationen auf der Seite Voraussetzungen. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/lumiscan-calibration/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 Support? {#faq-support} - **Antwort:** Siehe die übergreifende [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html). 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), [Data-Layer-FAQ](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/faq.html)