FAQ

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. Ein Referenzbild ist nicht nötig.

Voraussetzungen, Beschreibung

Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, BayerGR8, BayerGR12, BayerRG8 und BayerRG12. Bayer-Bilder werden vor der Erkennung in Farbe umgewandelt und 12-Bit-Bilder auf 8 Bit herunterskaliert; ein Schwellwert, der auf einem Format eingestellt wurde, gilt also auch für ein anderes. Jedes andere Pixelformat wird mit Statuscode -3 abgelehnt.

Voraussetzungen

Setzen Sie <module>/detect-area/input/input-image-address, schreiben Sie auf <module>/detect-area/execute (ein blockierender Aufruf) und prüfen Sie, dass output/status-code 1 ist. Lesen Sie dann output/result: blobs ist nach Fläche sortiert, blobs[0] ist also die größte Region; jeder Blob hat seinen Mittelpunkt x, y, seine area in Pixeln (gezählt, nie aus einer angepassten Form abgeleitet), sein label und ein umschließendes Rechteck. blob_count gibt die Anzahl der Regionen an und total_area die Summe, die bei Bedeckungs-, Verunreinigungs- und Füllstandsprüfungen meist die Zahl ist, auf die Sie reagieren.

Flächen erkennen, Anleitung: Teilefläche aus einem Kamerabild messen

Messen Sie das Bild, statt zu raten. FIXED ist in dieser Version das einzige input/method; alles andere wird abgelehnt.

Eine Szene analysieren, Die Erkennung abstimmen

input/preprocess/method wendet vor der Erkennung einen Filter an: NONE (Standard), LOG (Laplacian of Gaussian), DOG (Difference of Gaussians; sigma-first muss sich von sigma-second unterscheiden) oder DOH (Determinant of Hessian; kernel-size muss 1, 3, 5 oder 7 sein). Nur die Parameter der gewählten Methode werden gelesen und geprüft. Alle drei normalisieren ihre Ausgabe, der Schwellwert muss nach dem Einschalten eines Filters also eventuell neu gesetzt werden.

Flächen erkennen, Die Erkennung abstimmen

Jeder Durchlauf veröffentlicht output/blob-labels, einen gewöhnlichen Bildknoten (data, width, height, pixel-type) in Mono16, mit einer Regionsnummer pro Pixel und 0 für Hintergrund. Die Nummern sind die blobs[].label-Werte in output/result; alle Pixel, die das Label eines Blobs enthalten, sind also diese Region; eine Binärmaske ist labels > 0. Das Bild umfasst den ganzen Frame in der Größe des Eingabebildes, und Labels werden nicht neu nummeriert. Es wird geleert, wenn der nächste Durchlauf beginnt.

Das Label-Bild

Setzen Sie input/crop/ (startX, startY, width, height); eine Breite oder Höhe von null reicht bis zum rechten bzw. unteren Rand, lauter Nullen durchsuchen also das ganze Bild. Eine Region, die über einen Rand hinausreicht, wird abgelehnt und nicht beschnitten; die Meldung nennt die Eingabe und die Grenze, die sie verletzt hat. Für mehr Geschwindigkeit schränken Sie zuerst den Bereich ein und erhöhen dann den Schwellwert, damit Rauschen und Staub den Schwellwert nicht mehr überschreiten.

Flächen erkennen, Die Erkennung abstimmen

Lassen Sie ein Modul den Stream des Cam Driver abonnieren (experimentell): Schreiben Sie den Stream-Ordner der Kamera, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream, auf <module>/control/subscribe/input/address, setzen Sie control/subscribe/input/enable auf true und schreiben Sie auf control/subscribe/execute. Jeder Frame wird mit den Eingaben von detect-area durchsucht, und ein Ergebnis pro Frame wird auf control/subscribe/output/stream/result veröffentlicht. Das Label-Bild wird nicht gestreamt. Um das neueste Ergebnis als einfaches detect-area/output/result zu lesen, setzen Sie control/subscribe/input/keep-latest-output auf true.

Flächen auf einem Bild-Stream erkennen, Streams

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 ausgeführt wurde, kleiner als 0 bedeutet, dass sie fehlgeschlagen ist und nichts erzeugt hat; verwenden Sie das Ergebnis dann nicht. Der Grund steht auf output/status-text. Ein fehlgeschlagener Schreibvorgang auf execute antwortet nur mit einem Statuscode (über REST mit einem bloßen 400), lesen Sie also anschließend output/status-text; der Text steht auch im Protokoll der Anwendung: auf ctrlX OS im ctrlX Logbook oder journalctl, auf einem PC in der Konsolenausgabe der Anwendung.

Eine Methode ausführen, Ausführungsstatus

Im Konfigurationsverzeichnis der Anwendung, lumiscan-area-detector/: die Anwendungs-Einstellungsdatei lumiscan-area-detector.json und eine <module-id>.json pro gespeichertem Modul.

Data-Layer-Referenz, Wo die Dateien liegen

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 LumiScan-FAQ der gesamten Dokumentation. 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