get_shape_model_3d_paramsT_get_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParams (Operator)

Name

get_shape_model_3d_paramsT_get_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParams — Auslesen der Parameter eines 3D-Formmodells.

Signatur

Beschreibung

Mit Hilfe des Operators get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParams lassen sich Parameter des 3D-Objektmodells abfragen.

Die Namen der Parameter, die abgefragt werden sollen, werden in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName übergeben, die korrespondierenden Werte werden in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue zurückgeliefert.

Im Einzelnen kann auf die folgenden Parameter zugegriffen werden:

'cam_param'"cam_param""cam_param""cam_param""cam_param":

Interne Parameter der für das Matching zu verwendenden Kamera.

'ref_rot_x'"ref_rot_x""ref_rot_x""ref_rot_x""ref_rot_x":

Referenzorientierung: Rotation um x-Achse bzw. x-Komponente des Rodriguez-Vektors (in Bogenmaß bzw. ohne Einheit).

'ref_rot_y'"ref_rot_y""ref_rot_y""ref_rot_y""ref_rot_y":

Referenzorientierung: Rotation um y-Achse bzw. y-Komponente des Rodriguez-Vektors (in Bogenmaß bzw. ohne Einheit).

'ref_rot_z'"ref_rot_z""ref_rot_z""ref_rot_z""ref_rot_z":

Referenzorientierung: Rotation um z-Achse bzw. z-Komponente des Rodriguez-Vektors (in Bogenmaß bzw. ohne Einheit).

'order_of_rotation'"order_of_rotation""order_of_rotation""order_of_rotation""order_of_rotation":

Bedeutung der Rotationswerte der Referenzorientierung.

'longitude_min'"longitude_min""longitude_min""longitude_min""longitude_min":

Kleinste geographische Länge der Modellansichten.

'longitude_max'"longitude_max""longitude_max""longitude_max""longitude_max":

Größte geographische Länge der Modellansichten.

'latitude_min'"latitude_min""latitude_min""latitude_min""latitude_min":

Kleinste geographische Breite der Modellansichten.

'latitude_max'"latitude_max""latitude_max""latitude_max""latitude_max":

Größte geographische Breite der Modellansichten.

'cam_roll_min'"cam_roll_min""cam_roll_min""cam_roll_min""cam_roll_min":

Kleinster Kamerarollwinkel der Modellansichten.

'cam_roll_max'"cam_roll_max""cam_roll_max""cam_roll_max""cam_roll_max":

Größter Kamerarollwinkel der Modellansichten.

'dist_min'"dist_min""dist_min""dist_min""dist_min":

Kleinster Kamera-Objekt-Abstand der Modellansichten.

'dist_max'"dist_max""dist_max""dist_max""dist_max":

Größter Kamera-Objekt-Abstand der Modellansichten.

'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast":

Minimaler Kontrast des Objektes in den Suchbildern.

'num_levels'"num_levels""num_levels""num_levels""num_levels":

Vom Benutzer vorgegebene Anzahl von Pyramidenebenen.

'num_levels_max'"num_levels_max""num_levels_max""num_levels_max""num_levels_max":

Maximale verwendete Anzahl von Pyramidenebenen über alle Modellansichten.

'optimization'"optimization""optimization""optimization""optimization":

Art der Optimierung durch Reduzierung der Modellpunkte.

'metric'"metric""metric""metric""metric":

Art der zum Matchen verwendeten Metrik.

'part_size'"part_size""part_size""part_size""part_size":

Größe der verwendeten Modellteile, wenn 'metric'"metric""metric""metric""metric" auf 'ignore_part_polarity'"ignore_part_polarity""ignore_part_polarity""ignore_part_polarity""ignore_part_polarity" gesetzt wurde.

'min_face_angle'"min_face_angle""min_face_angle""min_face_angle""min_face_angle":

Kleinster 3D-Flächenwinkel für den die 3D-Objektmodellkante ins 3D-Formmodell einfließt.

'min_size'"min_size""min_size""min_size""min_size":

Mindestgröße der projizierten 3D-Objektmodellkante (in Anzahl Pixel) damit sie ins 3D-Formmodell einfließt.

'model_tolerance'"model_tolerance""model_tolerance""model_tolerance""model_tolerance":

Größte zulässige Abweichung der projizierten Modellkanten (in Pixel).

'num_views_per_level'"num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level":

Anzahl der Modellansichten pro Pyramidenebene. Für jede Pyramidenebene wird die Anzahl der im Modell gespeicherten Ansichten zurückgegeben. Die Länge des zurückgelieferten Tupels entspricht somit der Anzahl der verwendeten Pyramidenebenen, die mit 'num_levels_max'"num_levels_max""num_levels_max""num_levels_max""num_levels_max" abgefragt werden kann. Für Pyramidenebenen unterhalb von 'lowest_model_level'"lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level" (siehe Dokumentation zu create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d) wird der Wert 0 zurückgegeben.

'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose":

Referenzlage und -orientierung des 3D-Formmodells. Die zurückgelieferte 3D-Lage ist in der Form . Dabei steht rcs für das Referenzkoordinatensystem und mcs für das Modellkoordinatensystem (ein 3D Weltkoordinatensystem), siehe auch Transformationen / Posen und „Solution Guide III-C - 3D Vision“. D.h., sie beschreibt die Lage des intern verwendeten Referenzkoordinatensystems des 3D-Formmodells bezüglich des im 3D-Objektmodell gespeicherten Koordinatensystems. Mit dieser 3D-Lage können Punkte aus dem Objektkoordinatensystem ins Referenzkoordinatensystem transformiert werden.

'reference_point'"reference_point""reference_point""reference_point""reference_point":

3D-Koordinaten des Referenzpunktes des zu Grunde liegenden 3D-Objektmodells.

'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1":

Kleinster umschließender achsenparalleler Quader des zu Grunde liegenden 3D-Objektmodells in der Form: [min_x, min_y, min_z, max_x, max_y, max_z].

'fast_pose_refinement'"fast_pose_refinement""fast_pose_refinement""fast_pose_refinement""fast_pose_refinement":

Beschreibt, ob die 3D-Lagen-Verfeinerung während der Suche im beschleunigten Modus ('true'"true""true""true""true") oder im herkömmlichen Modus ('false'"false""false""false""false") durchgeführt wird.

'lowest_model_level'"lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level":

Unterste Pyramidenebene, bis zu der Ansichten im Modell gespeichert sind.

'union_adjacent_contours'"union_adjacent_contours""union_adjacent_contours""union_adjacent_contours""union_adjacent_contours":

Beschreibt, ob in project_shape_model_3dproject_shape_model_3dProjectShapeModel3dProjectShapeModel3dProjectShapeModel3d benachbarte Konturen verbunden werden sollen.

Ausführlichere Informationen zu den einzelnen Parametern können beim Operator create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d nachgelesen werden.

Es ist möglich, in einem Operatoraufruf mehrere Parameter zu kombinieren und gemeinsam in einem Tupel an GenParamNameGenParamNameGenParamNameGenParamNamegenParamName zu übergeben. Als Ergebnis wird in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue ein Tupel gleicher Länge zurückgeliefert, dessen Werte mit den entsprechenden Parameternamen korrespondieren. Dies ist allerdings ausschließlich für solche Parameter möglich, die nur einen einzelnen Wert zurückliefern.

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.

Parameter

Ergebnis

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

Vorgänger

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dReadShapeModel3d

Nachfolger

find_shape_model_3dfind_shape_model_3dFindShapeModel3dFindShapeModel3dFindShapeModel3d

Siehe auch

convert_point_3d_cart_to_spherconvert_point_3d_cart_to_spherConvertPoint3dCartToSpherConvertPoint3dCartToSpherConvertPoint3dCartToSpher, convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCartConvertPoint3dSpherToCart, create_cam_pose_look_at_pointcreate_cam_pose_look_at_pointCreateCamPoseLookAtPointCreateCamPoseLookAtPointCreateCamPoseLookAtPoint, trans_pose_shape_model_3dtrans_pose_shape_model_3dTransPoseShapeModel3dTransPoseShapeModel3dTransPoseShapeModel3d

Modul

3D Metrology