get_sheet_of_light_param — Abfrage eines Modellparameters.
get_sheet_of_light_param( : : SheetOfLightModelID, GenParamName : GenParamValue)
Der Operator get_sheet_of_light_param erlaubt es, die Werte der
Modellparameter abzufragen. Der Name des gewünschten Parameters wird dem
generischen Parameter GenParamName übergeben und der entsprechende
Wert wird im Parameter GenParamValue zurückgegeben. Die aktuelle
Konfiguration können mit Hilfe von set_sheet_of_light_param
jederzeit verändert werden.
Die gleichzeitige Abfrage mehrerer Parameter ist nicht möglich. Um mehrere
Parameter abzufragen, muss der Operator get_sheet_of_light_param
mehrmals aufgerufen werden.
Die Werte der folgenden Modellparameter kann abgefragt werden:
Messung der Profile:
definiert die Methode anhand welcher die Position des Profils im Bild, d.h. die Disparität, bestimmt wird. Die Werte 'default' und 'center_of_gravity' verweisen beide auf dieselbe Methode, bei welcher die Position des Profils spaltenweise und mit Subpixelgenauigkeit ermittelt wird, indem der Schwerpunkt der Grauwerte berechnet wird, die folgende Bedingung erfüllen:
der kleinste Grauwert, der für die Berechnung der Disparität berücksichtigt wird (vgl. 'method' oben).
Anzahl der Profile für welche Speicher im Lichtschnitt-Modell reserviert wurde. Standardmäßig wird 'num_profiles' auf 512 gesetzt. Wird diese Anzahl während einer Messung überschritten, so wird zusätzlicher Speicher automatisch reserviert. Da dieser Prozess jedoch etwas Zeit in Anspruch nimmt, wird empfohlen 'num_profiles' vor dem Start der Messung auf einen geeigneten Wert zu setzen.
Dieser Parameter legt fest, welcher gemessene Wert zurückgeliefert wird, wenn die Bestimmung der Position des Profils nicht eindeutig ist.
'first': der erste gemessene Wert wird zurückgeliefert. Diese Methode ist die schnellste.
'last': der letzte gemessene Wert wird zurückgeliefert.
'brightest': die Helligkeit aller gemessenen Werte wird berechnet und die Position, die der höchsten Helligkeit entspricht, wird zurückgeliefert. Die Helligkeit wird wie folgt berechnet: wobei die Grauwerte und n die Anzahl der Pixel darstellen, die zur Berechnung der Position der Profils berücksichtigt werden.
Dieser Parameter legt fest, ob Bewertungsmerkmale ('score') des
Disparitätsbildes berechnet werden sollen, und wenn ja, nach welchem
Kriterium.
'none': es werden keine Bewertungsmerkmale berechnet.
'width': für jeden Pixel des Disparitätsbildes wird die lokale Breite des Profils als Bewertungsmerkmal zurückgeliefert.
'intensity': für jeden Pixel des Disparitätsbildes wird als Bewertungsmerkmal die lokale Intensität des Profils zurückgeliefert. Diese wird wie folgt berechnet: wobei die Grauwerte und n die Anzahl der Pixel darstellen, die zur Berechnung der Position der Profils berücksichtigt werden.
Kalibrierung der Messung:
gibt an, ob und wenn ja welche Kalibriertransformationen auf das Disparitätsbild angewendet werden sollen:
'none': es werden keine Kalibriertransformationen angewendet.
'xz': es werden Kalibriertransformationen angewendet, die die geometrischen Eigenschaften des Messsystems berücksichtigen (Kamera und Lichtlinienprojektor). Die Bewegung des Objekts während der Messung wird jedoch nicht berücksichtigt.
'xyz': es werden Kalibriertransformationen angewendet, die sowohl die geometrischen Eigenschaften des Messsystems (Kamera und Lichtlinienprojektor) als auch die Bewegung des Objekts während der Messung berücksichtigen.
'offset_scale': Ein vereinfachter Parametersatz um einen Aufbau zu beschreiben. Dieses Modell kann bereits mit Standardeinstellungen angewandt werden, bietet aber auch die Möglichkeit den Setup mit nur 6 Parameters zu konfigurieren. Drei der Parameter beschreiben eine anisotrope Skalierung: 'scale_x' beschreibt die Skalierung entlang der Spaltenrichtung des Bildes in die neue x-Achse, 'scale_y' beschreibt eine lineare Bewegung des Objekts zwischen zwei aufeinander folgenden Bildern und 'scale_z' beschreibt das Verhältnis der Disparität zur neuen z-Achse. Die übrigen drei Parameter beschreiben die Lage des neuen Zentrums relativ zum neuen Weltkoodinatensystem ('offset_x', 'offset_y', 'offset_z').
die internen Parameter der Kamera, die zur Durchführung der Messung benutzt wurden. Diese Parameter werden benötigt, wenn 'calibration' auf 'xz' oder 'xyz' gesetzt wurde.
die Pose des Weltkoordinatensystems relativ zum Kamerakoordinatesystem. Diese Pose wird benötigt, wenn 'calibration' auf 'xz' oder 'xyz' gesetzt wurde.
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. Diese Pose wird benötigt, wenn 'calibration' auf 'xz' oder 'xyz' gesetzt wurde.
die Pose, die die Bewegung des Objekts relativ zum Messsystem während der Messung beschreibt. Sie soll im Weltkoordinatensystem formuliert sein und wird benötigt, wenn 'calibration' auf 'xyz' gesetzt wurde.
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, und ist Meter, wenn Sie eine Standardkalibrierplatte benutzen. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale', 'xz' oder 'xyz' relevant.
Der Standardwert des Modellparameters 'scale' ist 1.0.
Dieser Wert definiert die Breite eines Pixels im 3D Raum. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale' relevant.
Der Standardwert für 'scale_x' ist 1.0.
Dieser Wert definiert die lineare Bewegung zwischen zwei Profilen. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale' relevant.
Der Standardwert für 'scale_y' ist 10.0.
Dieser Wert definiert die Höher von Disparitäten im 3D Raum. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale' relevant.
Der Standardwert für 'scale_z' ist 1.0.
Dieser Wert beschreibt die Verschiebung in x im 3D Raum. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale' relevant.
Der Standardwert für 'offset_x' ist 0.0.
Dieser Wert beschreibt die Verschiebung in y im 3D Raum. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale' relevant.
Der Standardwert für 'offset_y' ist 0.0.
Dieser Wert beschreibt die Verschiebung in z im 3D Raum. Dieser Wert ist nur im Falle der Kalibriertransformationen 'offset_scale' relevant.
Der Standardwert für 'offset_z' ist 0.0.
SheetOfLightModelID (input_control) sheet_of_light_model → (handle)
Handle des Lichtschnitt-Modells.
GenParamName (input_control) attribute.name → (string)
Name des Modellparameters, der abgefragt werden soll.
Defaultwert: 'method'
Werteliste: 'ambiguity_solving', 'calibration', 'camera_parameter', 'camera_pose', 'lightplane_pose', 'method', 'min_gray', 'movement_pose', 'num_profiles', 'offset_x', 'offset_y', 'offset_z', 'scale', 'scale_x', 'scale_y', 'scale_z', 'score_type'
GenParamValue (output_control) attribute.value(-array) → (string / integer / real)
Wert des abgefragten Modellparameters.
get_sheet_of_light_param liefert den Wert 2 (H_MSG_TRUE), falls die
übergebenen Parameter korrekt sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
query_sheet_of_light_params,
set_sheet_of_light_param
measure_profile_sheet_of_light,
set_sheet_of_light_param,
apply_sheet_of_light_calibration
3D Metrology