get_surface_model_paramT_get_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamget_surface_model_param (Operator)

Name

get_surface_model_paramT_get_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamget_surface_model_param — Auslesen von Einstellungen und Eigenschaften eines Oberflächenmodells.

Signatur

Beschreibung

get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParamget_surface_model_param liefert Einstellungen und Eigenschaften des Oberflächenmodells SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelIDsurface_model_id. Das Oberflächenmodell muss mittels create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model oder read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModelread_surface_model erstellt worden sein. Die Namen der abzurufenden Werte werden im generischen Parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name übergeben, die entsprechenden Werte werden in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value zurückgegeben.

Die folgenden Werte sind für GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name möglich:

'diameter'"diameter""diameter""diameter""diameter""diameter":

Durchmesser der Modellpunktwolke. Der Durchmesser ist die Länge der Diagonalen des umschließenden achsenparallelen Quaders (siehe 'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1""bounding_box1").

'center'"center""center""center""center""center":

Mittelpunkt des Modells. Der Mittelpunkt ist das Zentrum des umschließenden achsenparallelen Quaders (siehe 'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1""bounding_box1").

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

Kleinster umschließender achsenparalleler Quader, zurückgegeben als (min_x, min_y, min_z, max_x, max_y, max_z).

'sampled_model'"sampled_model""sampled_model""sampled_model""sampled_model""sampled_model":

Die für das Matching abgetasteten 3D-Punkte des Modells. Zurückgegeben wird das Handle eines 3D-Objektmodells, welches alle Punkte enthält, die für das näherungsweise Matching abgetastet wurden (siehe create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model).

'sampled_pose_refinement'"sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement":

Die für die Pose-Verfeinerung abgetasteten 3D-Punkte des Modells. Zurückgegeben wird das Handle eines 3D-Objektmodells, welches alle Punkte enthält die für die Pose-Verfeinerung abgetastet wurden (siehe create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model).

'3d_edges_trained'"3d_edges_trained""3d_edges_trained""3d_edges_trained""3d_edges_trained""3d_edges_trained":

Gibt zurück ob das Oberflächenmodell für kantenunterstützte Matching vorbereitet wurde, d.h., ob der Parameter 'train_3d_edges'"train_3d_edges""train_3d_edges""train_3d_edges""train_3d_edges""train_3d_edges" in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model für dieses Modell aktiviert wurde. Zurückgegeben wird der String 'true'"true""true""true""true""true" oder 'false'"false""false""false""false""false".

'view_based_trained'"view_based_trained""view_based_trained""view_based_trained""view_based_trained""view_based_trained":

Gibt zurück ob das Oberflächenmodell zur Berechnung einer ansichtsbasierten Bewertung während des Matchings vorbereitet wurde, d.h., ob der Parameter 'train_view_based'"train_view_based""train_view_based""train_view_based""train_view_based""train_view_based" in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model für dieses Modell aktiviert wurde. Zurückgegeben wird der String 'true'"true""true""true""true""true" oder 'false'"false""false""false""false""false".

'camera_parameter'"camera_parameter""camera_parameter""camera_parameter""camera_parameter""camera_parameter":

'camera_parameter X'"camera_parameter X""camera_parameter X""camera_parameter X""camera_parameter X""camera_parameter X":

Gibt die Kameraparameter der Kamera mit der Nummer X zurück, wobei X ein 0-basierter Index ist. Falls nicht angegeben, ist X standardmäßig 0 (erste Kamera). Die Kameraparameter müssen vorher mittels set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param gesetzt worden sein.

'camera_pose'"camera_pose""camera_pose""camera_pose""camera_pose""camera_pose":

'camera_pose X'"camera_pose X""camera_pose X""camera_pose X""camera_pose X""camera_pose X":

Gibt die Kamerapose der Kamera mit der Nummer X zurück, wobei X ein 0-basierter Index ist. Falls nicht angegeben, ist X standardmäßig 0 (erste Kamera).

'symmetry_axis_direction'"symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction":

'symmetry_axis_origin'"symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin":

Gibt die Richtung der vorher mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param gesetzten Symmetrieachse bzw. einen auf ihr liegenden Punkt zurück. Wenn keine Achse gesetzt wurde, wird ein leeres Tupel zurückgegeben.

'symmetry_poses'"symmetry_poses""symmetry_poses""symmetry_poses""symmetry_poses""symmetry_poses":

Gibt die mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param gesetzten Symmetrieposen zurück.

'symmetry_poses_all'"symmetry_poses_all""symmetry_poses_all""symmetry_poses_all""symmetry_poses_all""symmetry_poses_all":

Gibt alle Symmetrieposen zurück, die set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param auf Grundlage der gesetzten Symmetrieposen gefunden hat.

'pose_restriction_reference_pose'"pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose":

Gibt die mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param gesetzte Referenzpose des Modells zurück. Wenn keine Referenzpose gesetzt ist, wird ein leeres Tupel zurückgegeben.

'pose_restriction_max_angle_diff'"pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff":

Gibt die mittels set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param gesetzte maximale Winkeldifferenz zwischen der Referenzpose und einer gefundenen Pose zurück. Der Winkel wird im Bogenmaß zurückgegeben. Wenn keine Winkeldifferenz gesetzt ist, wird ein leeres Tupel zurückgegeben.

'pose_restriction_allowed_axis_direction'"pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction":

'pose_restriction_allowed_axis_origin'"pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin":

Gibt die Richtung der vorher mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param gesetzten zu ignorierenden Rotationsachse zurück. Wenn keine Achse gesetzt wurde, wird ein leeres Tupel zurückgegeben.

'pose_restriction_filter_final_poses_only'"pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only":

Gibt 'true'"true""true""true""true""true" zurück, wenn nur die finalen Posen gefiltert werden sollen, oder 'false'"false""false""false""false""false", wenn die Filterung bereits während des Matchingprozesses geschehen soll (Standardwert).

'self_similar_poses_trained'"self_similar_poses_trained""self_similar_poses_trained""self_similar_poses_trained""self_similar_poses_trained""self_similar_poses_trained":

Gibt zurück ob das Oberflächenmodell zur Optimierung bezüglich selbstähnlicher, fast-symmetrischer Lagen vorbereitet wurde, d.h. ob der Parameter 'train_self_similar_poses'"train_self_similar_poses""train_self_similar_poses""train_self_similar_poses""train_self_similar_poses""train_self_similar_poses" in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model für dieses Modell aktiviert wurde. Zurückgegeben wird der String 'true'"true""true""true""true""true" oder 'false'"false""false""false""false""false".

'sampled_self_similarity'"sampled_self_similarity""sampled_self_similarity""sampled_self_similarity""sampled_self_similarity""sampled_self_similarity":

Gibt das Handle eines 3D-Objektmodells zurück welches die 3D-Punkte des Modells enthält, die für Suche nach selbstähnlichen Posen abgetastet wurden.

'self_similar_poses'"self_similar_poses""self_similar_poses""self_similar_poses""self_similar_poses""self_similar_poses":

Gibt die Posen zurück, unter denen das Objekt selbstähnlich, d.h. fast-symmetrisch, ist. Diese stehen nur zur Verfügung, wenn das Oberflächenmodell in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model mit aktiviertem Parameter 'train_self_similar_poses'"train_self_similar_poses""train_self_similar_poses""train_self_similar_poses""train_self_similar_poses""train_self_similar_poses" trainiert wurde.

'self_similar_poses_models'"self_similar_poses_models""self_similar_poses_models""self_similar_poses_models""self_similar_poses_models""self_similar_poses_models":

Gibt das Handle von 3D-Objektmodellen zurück, welche das Originalmodell enthalten, das in die mit 'self_similar_poses'"self_similar_poses""self_similar_poses""self_similar_poses""self_similar_poses""self_similar_poses" abrufbaren Posen transformiert wurden. Dies erlaubt eine Untersuchung der gefundenen selbstähnlichen Lagen. Dieser Parameter steht nur zur Verfügung, wenn das Oberflächenmodell in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model mit aktiviertem Parameter 'train_self_similar_poses'"train_self_similar_poses""train_self_similar_poses""train_self_similar_poses""train_self_similar_poses""train_self_similar_poses" trainiert wurde.

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

Wenn alle Parameter korrekt sind liefert get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParamget_surface_model_param den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model, read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModelread_surface_model

Nachfolger

find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPoserefine_surface_model_pose, write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModelwrite_surface_model

Siehe auch

create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model, set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParamset_surface_model_param

Modul

3D Metrology