apply_sheet_of_light_calibration
— Wendet die Kalibriertransformationen auf das Eingabe-Disparitätsbild an.
apply_sheet_of_light_calibration(Disparity : : SheetOfLightModelID : )
Der Operator apply_sheet_of_light_calibration
liest das
Disparitätsbild Disparity
und speichert es in das von
SheetOfLightModelID
referenzierte Lichtschnitt-Modell. Anschließend
werden die Kalibriertransformationen auf dieses Disparitätsbild angewendet
und somit die kalibrierten 3D-Punktkoordinaten der rekonstruierten Oberfläche
berechnet. Diese 3D-Koordinaten können mit dem Operator
get_sheet_of_light_result
abgerufen werden. Das entsprechende
3D-Objektmodell kann mit dem Operator
get_sheet_of_light_result_object_model_3d
abgerufen werden.
Vor dem nächsten Aufruf von apply_sheet_of_light_calibration
für
ein Disparitätsbild kleinerer Höhe sollte reset_sheet_of_light_model
aufgerufen werden.
Das Disparitätsbild Disparity
kann mit dem Operator
measure_profile_sheet_of_light
gemessen werden oder auch mit Hilfe
einer speziellen Kamera akquiriert werden, welche Disparitätsbilder direkt
nach dem Lichtschnittverfahren liefert.
Um die kalibrierten 3D-Koordinaten mit apply_sheet_of_light_calibration
berechnen zu können, müssen vorher die folgenden Parameter in das
Lichtschnitt-Modell gesetzt worden sein. Dies kann mit dem Operator
set_sheet_of_light_param
erfolgen.
gibt an, welche Kalibriertransformationen auf das Disparitätsbild angewendet werden sollen und muss auf 'xz' , 'xyz' oder 'offset_scale' gesetzt worden sein.
die internen Parameter der Kamera des Messsystems.
die Pose des Weltkoordinatensystems relativ zum Kamerakoordinatesystem.
die Pose des Koordinatensystems der Lichtebene relativ zum Weltkoordinatensystem. Mit dem Koordinatensystem der Lichtebene ist ein Koordinatensystem gemeint, dessen Ebene definiert durch z=0 mit der Lichtebene übereinstimmt, die der Lichtlinienprojektor im Raum erzeugt.
die Pose, die die Bewegung des Objekts relativ zum Messsystem während der Messung beschreibt. Diese Pose soll im Weltkoordinatensystem formuliert sein.
dieser Parameter legt fest mit welchem Faktor die kalibrierten 3D-Koordinaten X, Y und Z skaliert werden. 'scale' muss als der Quotient Zieleinheit/Originaleinheit eingegeben werden. Die Originaleinheit wird durch das Kalibrierobjekt bestimmt, sie ist Meter wenn Sie eine Standardkalibrierplatte benutzen.
Die Referenzdokumentation des Operators set_sheet_of_light_param
liefert weitere Details über die Bedeutung aller Modell-Parameter.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Disparity
(input_object) singlechannelimage →
object (real)
Zu kalibrierende Entfernungs- oder Höhenmessung.
SheetOfLightModelID
(input_control, Zustand wird modifiziert) sheet_of_light_model →
(handle)
Handle des Lichtschnitt-Modells.
* ... * Read an already acquired disparity map from file read_image (Disparity, 'sheet_of_light/connection_rod_disparity.tif') * * Create a model and set the required parameters gen_rectangle1 (ProfileRegion, 120, 75, 195, 710) create_sheet_of_light_model (ProfileRegion, ['min_gray','num_profiles', \ 'ambiguity_solving'], [70,290,'first'], \ SheetOfLightModelID) set_sheet_of_light_param (SheetOfLightModelID, 'calibration', 'xyz') set_sheet_of_light_param (SheetOfLightModelID, 'scale', 'mm') set_sheet_of_light_param (SheetOfLightModelID, 'camera_parameter', \ CameraParameter) set_sheet_of_light_param (SheetOfLightModelID, 'camera_pose', CameraPose) set_sheet_of_light_param (SheetOfLightModelID, 'lightplane_pose', \ LightPlanePose) set_sheet_of_light_param (SheetOfLightModelID, 'movement_pose', \ MovementPose) * * Apply the calibration transforms and * get the resulting calibrated coordinates apply_sheet_of_light_calibration (Disparity, SheetOfLightModelID) get_sheet_of_light_result (X, SheetOfLightModelID, 'x') get_sheet_of_light_result (Y, SheetOfLightModelID, 'y') get_sheet_of_light_result (Z, SheetOfLightModelID, 'z') *
apply_sheet_of_light_calibration
liefert den Wert 2 (H_MSG_TRUE), falls die
übergebenen Parameter korrekt sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
get_sheet_of_light_result
,
get_sheet_of_light_result_object_model_3d
3D Metrology