set_metrology_model_paramT_set_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParamset_metrology_model_param (Operator)

Name

set_metrology_model_paramT_set_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParamset_metrology_model_param — Setzen von Parametern, die für das gesamte Messmodell gelten.

Signatur

Beschreibung

set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParamSetMetrologyModelParamset_metrology_model_param setzt Parameter des Messmodells MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle, die für das gesamte Modell, d.h. für alle Objekte, gültig sind.

Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel 2D-Messtechnik beschrieben.

Die folgenden Werte können für GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt werden:

Kalibrierung

Um mit apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModelapply_metrology_model kalibrierte Messungen in metrischen Koordinaten durchführen zu können, müssen sowohl die Werte der internen Kameraparameter als auch die 3D-Lage der Messebene gesetzt werden.

'camera_param'"camera_param""camera_param""camera_param""camera_param""camera_param":

In vielen Fällen sind die internen Kameraparameter das Ergebnis einer vorherigen Kamerakalibrierung mit dem Operator calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras (siehe Kalibrierung für die Reihenfolge der internen Kameraparameter und das zu Grunde liegende Kameramodell). Falls 'camera_param'"camera_param""camera_param""camera_param""camera_param""camera_param" auf [] gesetzt wird, werden die Werte der internen Kameraparameter gelöscht.

Defaultwert: [].

'plane_pose'"plane_pose""plane_pose""plane_pose""plane_pose""plane_pose":

Die 3D-Lage der Messebene in Kamerakoordinaten. Falls 'plane_pose'"plane_pose""plane_pose""plane_pose""plane_pose""plane_pose" auf [] gesetzt wird, wird die Messebene gelöscht.

Defaultwert: [].

Definition des Referenzkoordinatensystems

Wenn Metrology-Messobjekte z.B. mit add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGenericAddMetrologyObjectGenericadd_metrology_object_generic, add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measure etc. zum Messmodell hinzugefügt werden, werden Positionen und Orientierungen bzgl. des Bildkoordinatensystems angegeben, welches seinen Ursprung in der linken oberen Bildecke hat. In manchen Fällen ist es nötig, das Referenzsystem bzgl. dem die Metrology-Messobjekte angegeben sind zu ändern. Dies ist z.B. der Fall, wenn ein Formmodell genutzt wird um das Messmodell im aktuellen Bild auszurichten. Die Ergebnisse von find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model können nur direkt in align_metrology_modelalign_metrology_modelAlignMetrologyModelAlignMetrologyModelAlignMetrologyModelalign_metrology_model genutzt werden, wenn das Referenzsystem, in dem das Messmodel gegeben ist, mit dem Referenzsystems des Formmodells übereinstimmt (siehe align_metrology_modelalign_metrology_modelAlignMetrologyModelAlignMetrologyModelAlignMetrologyModelalign_metrology_model für ausführlichere Informationen)

'reference_system'"reference_system""reference_system""reference_system""reference_system""reference_system":

Das in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value angegebene Tupel hat die Form [row, column, angle]. Per Default ist das Referenzsystem das Bildkoordinatensystem, das sich in der linken oberen Ecke des Bildes befindet. Wird das Referenzkoordinatensystem neu gesetzt, so gibt das Tupel [row, column, angle] die Translation und Rotation des neuen Referenzkoordinatensystems bezüglich des Bildkoordinatensystems an. Alle Bestandteile (Objekte) des Messmodells werden in das neu gesetzte Koordinatensystem umgerechnet. Im folgenden Bild wird eine neues Referenzsystem auf den Mittelpunkt des Bildes gesetzt.

set_metrology_model_param(MetrologyHandle, 'reference_system', [Height/2,Width/2,0])set_metrology_model_param(MetrologyHandle, "reference_system", [Height/2,Width/2,0])SetMetrologyModelParam(MetrologyHandle, "reference_system", [Height/2,Width/2,0])SetMetrologyModelParam(MetrologyHandle, "reference_system", [Height/2,Width/2,0])SetMetrologyModelParam(MetrologyHandle, "reference_system", [Height/2,Width/2,0])set_metrology_model_param(MetrologyHandle, "reference_system", [Height/2,Width/2,0])

(1)	(2)

(1) Mehrere Metrology-Messobjekte und ihre Konturen sind in blau gezeigt. (2) Das neue Referenzsystem des Messmodells wird im Mittelpunkt des Bildes platziert. Als Folge davon, werden die Posen der Metrology-Messobjekte in die entgegen gesetzte Richtung bewegt. Die resultierenden Konturen der Metrology-Messobjekte sind in blau dargestellt.

Defaultwert: [0, 0, 0]

Skalierung der Ergebnisse

Die Ergebnisse der Messung, die mit get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResultGetMetrologyObjectResultget_metrology_object_result abgerufen werden, können mit einem Faktor skaliert werden.

'scale'"scale""scale""scale""scale""scale":

Der Parameter legt die Skalierung oder die Einheit der Ergebnisse der Messungen fest. Der Parameter 'scale'"scale""scale""scale""scale""scale" entspricht dem Verhältnis der gewünschten Einheit zur ursprünglichen Einheit.

Sind keine Kameraparameter gegeben, so ist die Standardeinheit Pixel.

Wurden 'camera_param'"camera_param""camera_param""camera_param""camera_param""camera_param" und 'plane_pose'"plane_pose""plane_pose""plane_pose""plane_pose""plane_pose" gesetzt, so wird die Einheit durch die Koordinaten des Kalibrierungobjektes bestimmt. Die standard HALCON Kalibrierplatte ist in metrischen Koordinaten definiert. Wird sie für die Kalibrierung verwendet, kann die gewünschte Einheit direkt gesetzt werden. Die Zuordnung von Einheiten zu Faktoren ergibt sich aus der folgenden Tabelle:

Einheit	Skalierungsfaktor
m	1
dm	10
cm	100
mm	1000
um, microns	1e6

Wertevorschläge: 1.0, 0.1, 'm'"m""m""m""m""m", 'cm'"cm""cm""cm""cm""cm", 'mm'"mm""mm""mm""mm""mm", 'microns'"microns""microns""microns""microns""microns", 'um'"um""um""um""um""um"

Defaultwert: 1.0

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

• MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle

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.

Parameter

Ergebnis

Sind die Parameterwerte korrekt, dann liefert set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParamSetMetrologyModelParamset_metrology_model_param den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_metrology_modelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModelCreateMetrologyModelcreate_metrology_model, set_metrology_model_image_sizeset_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSizeSetMetrologyModelImageSizeset_metrology_model_image_size

Nachfolger

add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGenericAddMetrologyObjectGenericadd_metrology_object_generic, get_metrology_object_model_contourget_metrology_object_model_contourGetMetrologyObjectModelContourGetMetrologyObjectModelContourGetMetrologyObjectModelContourget_metrology_object_model_contour

Siehe auch

set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParamSetMetrologyObjectParamset_metrology_object_param, align_metrology_modelalign_metrology_modelAlignMetrologyModelAlignMetrologyModelAlignMetrologyModelalign_metrology_model, get_metrology_model_paramget_metrology_model_paramGetMetrologyModelParamGetMetrologyModelParamGetMetrologyModelParamget_metrology_model_param

Modul

2D Metrology