FAQ

Kurze Antworten auf häufige Fragen zu LumiScan Calibration. Jeder Eintrag verweist auf die Seite mit den Details. Probleme und Fehlermeldungen sind unter Fehlerbehebung beschrieben.

Jeder Eintrag hat einen festen Anker (zum Beispiel #faq-status-codes). Um eine Fehlermeldung zu finden, durchsuchen Sie die Seite Fehlerbehebung danach.

Erste Schritte

Was macht LumiScan Calibration?

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, Voraussetzungen

Wie erhalte ich die TIFF-Kalibrierdatei?

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

Wie lade ich die TIFF-Datei und die Konfigurationsdateien hoch?

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

Konfiguration

Wo liegen die Konfigurationsdateien, und wie sind sie aufgebaut?

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.

  • <module name>.json (zum Beispiel example.json): Einstellungen eines Transformationsmoduls.

  • <file name>.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, Anwendungs-Einstellungsdatei, Einstellungen auf dem Data Layer

Wie füge ich ein neues Transformationsmodul hinzu?

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/<module name>. 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, Module hinzufügen und entfernen

Welche Transformationsparameter kann ich einstellen?

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

Betrieb

Wie rechne ich einen 2D-Bildpunkt in einen 3D-Punkt um?

Antwort

Mit XXX = hdvisionsystems/lumiscan-calibration/<module name>:

  • 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, Execute-Methoden

Was bedeuten die Statuscodes?

Antwort

hdvisionsystems/lumiscan-calibration/<module name>/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

Fehlerbehebung

Probleme und Fehlermeldungen sind Schritt für Schritt unter Fehlerbehebung beschrieben:

Lizenzierung und Support

Welche Lizenz brauche ich, und was passiert ohne?

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, FAQ zur Lizenzierung

Wo finde ich weitere Antworten oder Support?

Antwort

Siehe die übergreifende LumiScan-FAQ. Wenden Sie sich an den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; für Lizenzen an licenses@hdvisionsystems.com.

Mehr

FAQ zur Lizenzierung, Data-Layer-FAQ