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
SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelIDsurface_model_id (input_control) surface_model → HSurfaceModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Oberflächenmodells.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name der abzurufenden Eigenschaft.
Defaultwert:
'diameter'
"diameter"
"diameter"
"diameter"
"diameter"
"diameter"
Werteliste: '3d_edges_trained'"3d_edges_trained""3d_edges_trained""3d_edges_trained""3d_edges_trained""3d_edges_trained", 'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1""bounding_box1", 'camera_parameter'"camera_parameter""camera_parameter""camera_parameter""camera_parameter""camera_parameter", 'camera_pose'"camera_pose""camera_pose""camera_pose""camera_pose""camera_pose", 'center'"center""center""center""center""center", 'diameter'"diameter""diameter""diameter""diameter""diameter", '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", '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", '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", 'pose_restriction_reference_pose'"pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose", 'sampled_model'"sampled_model""sampled_model""sampled_model""sampled_model""sampled_model", 'sampled_pose_refinement'"sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement", 'sampled_self_similarity'"sampled_self_similarity""sampled_self_similarity""sampled_self_similarity""sampled_self_similarity""sampled_self_similarity", 'self_similar_poses'"self_similar_poses""self_similar_poses""self_similar_poses""self_similar_poses""self_similar_poses", 'self_similar_poses_models'"self_similar_poses_models""self_similar_poses_models""self_similar_poses_models""self_similar_poses_models""self_similar_poses_models", 'self_similar_poses_trained'"self_similar_poses_trained""self_similar_poses_trained""self_similar_poses_trained""self_similar_poses_trained""self_similar_poses_trained", '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", 'symmetry_poses'"symmetry_poses""symmetry_poses""symmetry_poses""symmetry_poses""symmetry_poses", 'symmetry_poses_all'"symmetry_poses_all""symmetry_poses_all""symmetry_poses_all""symmetry_poses_all""symmetry_poses_all", 'view_based_trained'"view_based_trained""view_based_trained""view_based_trained""view_based_trained""view_based_trained"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (output_control) attribute.value(-array) → HTupleSequence[HTupleElementType]HTupleHtuple (real / string / integer / handle) (double / string / int / long / HHandle) (double / HString / Hlong / HHandle) (double / char* / Hlong / handle)
Wert der abzurufenden Eigenschaft.
Ergebnis
Wenn alle Parameter korrekt sind liefert get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParamget_surface_model_param den
Wert 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