FAQ

Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) verwendet er den ctrlX Data Layer; auf einem PC mit Windows 11 oder Ubuntu 24.04 verwendet er LumiScan Keryx, den Data Layer von HD Vision Systems für PCs. Die Knotenadressen, Typen und die Art, wie die Methoden aufgerufen werden, sind auf beiden gleich, sodass ein für den einen geschriebenes Programm auch mit dem anderen funktioniert. Nur die Namen der Ergebnisse eines Methodenaufrufs unterscheiden sich, zum Beispiel DL_TOO_MANY_OPERATIONS auf dem ctrlX Data Layer und TooManyOperations bei LumiScan Keryx.

Data-Layer-Referenz, ctrlX Data Layer und LumiScan Keryx

Die Anwendung kommuniziert nicht selbst mit einer Kamera. Sie liest den Bildknoten einer anderen Anwendung, die auf demselben Gerät läuft - demselben ctrlX CORE oder ctrlX IPC oder demselben PC (ein Zugriff auf einen entfernten Data Layer wird nicht unterstützt), normalerweise LumiScan Cam Driver, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/output/image. Jede Anwendung funktioniert, wenn ihr Bildknoten data (rohe, unkomprimierte uint8-Pixeldaten), width, height und pixel-type (Name des GenICam-Pixelformats) bereitstellt.

Voraussetzungen

Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, BayerGR8, BayerGR12, BayerRG8 und BayerRG12. Bayer-Bilder werden vor dem Matching in Farbe umgewandelt und 12-Bit-Bilder auf 8 Bit herunterskaliert. Jedes andere Pixelformat wird mit Statuscode -3 abgelehnt.

Voraussetzungen

Verwenden Sie system/create-object; es ist anwendungsweit, sodass ein einmal eingelerntes Objekt von jedem Modul gefunden werden kann:

Ein Objekt anlegen, Anleitung: Ein Teil in einem Kamerabild finden

Lassen Sie etwa 5 Pixel Hintergrund um das Teil; mehr bringt nichts. Ein Ausschnitt, der an der Silhouette endet, verbirgt die Kontur vor dem Detektor: Das Objekt wird entweder als fehlgeschlagener Durchlauf abgelehnt, der es benennt, oder angenommen, aber nur auf die inneren Details des Teils gestützt. Ein zu weiter Ausschnitt, der eine Werkbankkante oder ein benachbartes Teil einschließt, macht das Matching weniger zuverlässig, denn Hintergrund im Bild ist Hintergrund, den der Detektor dann zu sehen erwartet.

Ein Objekt anlegen

Schreiben Sie system/set-object-dir/input/object-dir und schreiben Sie auf system/set-object-dir/execute. Schreiben Sie nicht direkt auf system/object-dir: Das ändert den angezeigten Wert, aber nicht das Verzeichnis, das die Anwendung liest. Das Verzeichnis muss im Konfigurationsverzeichnis bereits existieren; absolute Pfade und Pfade, die mit .. hinausführen, werden mit Status -2 abgelehnt. Ein abgelehnter Aufruf ändert nichts, und die Wahl wird gespeichert.

Objektspeicher

Setzen Sie <module>/find-object/input/input-image-address und input/object-id, schreiben Sie auf <module>/find-object/execute (ein blockierender Aufruf) und lesen Sie output/status-code. input/object-id ist erforderlich: Ein leerer Wert wird mit -2 abgelehnt. Jeder Durchlauf sucht nach einem Objekt; um gemischte Teile zu sortieren, führen Sie ihn einmal pro Objekt aus und vergleichen die Scores. Bei 1 lesen Sie output/result: matches ist nach Score sortiert, sodass matches[0] der beste ist. Jeder Treffer liefert die linke obere Ecke x, y, width und height der Vorlage, die übereingestimmt hat, den score (0 bis 1) und die object_id. Das Rechteck ist achsenparallel; das Ergebnis enthält keine Rotation.

Ein Objekt finden

Messen statt raten. Setzen Sie input/confidence-threshold niedrig (0.4), führen Sie die Suche mit echten Teilen aus, notieren Sie die Scores in output/result und setzen Sie den Schwellwert etwas unter den schlechtesten Score, den ein echtes Teil erzeugt. Der Standardwert ist 0.6; ein Schwellwert ab 0.9 lehnt in der Regel alles ab. Liegen die echten Scores nahe am Schwellwert oder sind die Bilder verrauscht, setzen Sie input/preprocess/blur-sigma-x auf 1.0 (die Glättung ist standardmäßig aus) und messen Sie erneut.

Die Suche abstimmen

Die Suche abstimmen: Geschwindigkeit

Ja, als experimentelle Funktion. Ein Modul abonniert den Stream einer Kamera und durchsucht jedes Bild mit den Eingaben von find-object (alle außer input/input-image-address); es veröffentlicht ein Ergebnis pro Bild auf <module-id>/control/subscribe/output/stream/result:

Objekte auf einem Bild-Stream finden (experimentell), Streams (experimentell)

Prüfen Sie das Vorzeichen von output/status-code: größer als 0 ist Erfolg, 0 bedeutet, dass die Operation seit dem Start der Anwendung nicht gelaufen ist, kleiner als 0 bedeutet, dass sie fehlgeschlagen ist und nichts erzeugt hat. Der Grund steht auf output/status-text, der mit ok: oder error: beginnt; ungültige Eingaben werden gemeinsam gemeldet, jede mit Nennung der Eingabe und ihres Werts. Ein fehlgeschlagener Schreibvorgang auf execute antwortet nur mit einem Statuscode (über REST ein bloßes 400), lesen Sie also anschließend output/status-text; der Text steht auch im Anwendungsprotokoll: auf ctrlX OS im ctrlX Logbook oder mit journalctl, auf einem PC in der Konsolenausgabe der Anwendung. -1 (busy) bedeutet, dass eine andere Operation desselben Moduls noch lief; es wurde nichts getan.

Eine Methode ausführen, Ausführungsstatus

Eine Lizenz deckt zehn Module ab; das elfte Modul belegt eine zweite Lizenz desselben Schlüssels, und ein Modul wird mit Status -11 abgelehnt, wenn keine Lizenz auf dem Gerät es abdeckt. Bezugswege:

Voraussetzungen, Modulverwaltung, FAQ zur Lizenzierung

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.

FAQ zur Lizenzierung