get_surface_matching_resultT_get_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResultget_surface_matching_result (Operator)
Name
get_surface_matching_resultT_get_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResultget_surface_matching_result — Auslesen von Ergebnissen des oberflächenbasierten Matchings.
Signatur
Beschreibung
Der Operator get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResultGetSurfaceMatchingResultget_surface_matching_result liefert detaillierte
Ergebnisse des oberflächenbasierten Matchings oder der oberflächenbasierten
Pose-Verfeinerung.
Die Ergebnisse sind in SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultIDsurface_matching_result_id gespeichert, das
mit find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model oder refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPoserefine_surface_model_pose
angelegt wurde.
Der Parameter ResultNameResultNameResultNameResultNameresultNameresult_name wählt das abzurufende Detailergebnis aus.
Bezieht sich das Detailergebnis auf eine der zurückgelieferten Posen,
so wählt ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index diese aus, wobei mittels 0 das
erste Ergebnis selektiert wird.
Für einige Werte von ResultNameResultNameResultNameResultNameresultNameresult_name wird ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index ignoriert.
Die folgenden Werte sind für ResultNameResultNameResultNameResultNameresultNameresult_name möglich, wenn
SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultIDsurface_matching_result_id von find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model oder
find_surface_model_imagefind_surface_model_imageFindSurfaceModelImageFindSurfaceModelImageFindSurfaceModelImagefind_surface_model_image erzeugt wurde:
- 'sampled_scene'"sampled_scene""sampled_scene""sampled_scene""sampled_scene""sampled_scene":
-
Es wird ein 3D-Objektmodell zurückgegeben, welches
die für das näherungsweise Matching abgetasteten Szenepunkte enthält.
Dies ist hilfreich um die Abtastdistanz einzustellen (siehe Parameter
RelSamplingDistance von find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model).
Der Parameter ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index wird ignoriert.
- 'key_points'"key_points""key_points""key_points""key_points""key_points":
-
Es wird ein 3D-Objektmodell zurückgegeben, welches
die Schlüsselpunkte enthält, die für das Matching verwendet wurden.
Dies ist hilfreich um die Abtastdistanz und die Anzahl an Schlüsselpunkten
einzustellen (siehe Parameter
KeyPointFraction von find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model).
Der Parameter ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index wird ignoriert.
- 'score_unrefined'"score_unrefined""score_unrefined""score_unrefined""score_unrefined""score_unrefined":
-
Es wird die Bewertung des Ergebnisses vor der
exakten Pose-Verfeinerung zurückgegeben. Je nachdem, ob die grobe
Pose-Verfeinerung aktiviert war ist dies die Bewertung des näherungsweisen
Matchings oder der groben Pose-Verfeinerung.
Eine detaillierte Beschreibung der Bewertung findet sich in
find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model.
Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index übergeben.
Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultIDsurface_matching_result_id mittels
refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPoserefine_surface_model_pose erstellt wurde, wird 0 zurückgegeben.
- 'sampled_3d_edges'"sampled_3d_edges""sampled_3d_edges""sampled_3d_edges""sampled_3d_edges""sampled_3d_edges":
Wenn das Oberflächenmodell für kantenunterstütztes oberflächenbasiertes
Matching vorbereitet wurde, wird ein 3D-Objektmodell zurückgegeben, welches
die abgetasteten 3D-Kanten enthält die für das näherungsweise
Matching verwendet wurden.
Der Parameter ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index wird ignoriert.
Die folgenden Werte für ResultNameResultNameResultNameResultNameresultNameresult_name sind unabhängig davon,
von welchem Operator SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultIDsurface_matching_result_id erzeugt wurde, möglich:
- 'pose'"pose""pose""pose""pose""pose":
-
Gibt die Pose eines der Ergebnisse zurück.
Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index übergeben.
- 'score_refined'"score_refined""score_refined""score_refined""score_refined""score_refined":
-
Gibt die Bewertung des Ergebnisses nach der exakten Pose-Verfeinerung
zurück.
Eine detaillierte Beschreibung der Bewertung findet sich in
find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model.
Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index übergeben.
Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultIDsurface_matching_result_id mittels find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model
erstellt wurde und die exakte Pose-Verfeinerung deaktiviert war, wird 0
zurückgegeben.
- 'score'"score""score""score""score""score":
-
Gibt die kombinierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index indizierten
Ergebnisses zurück, d.h., diese Bewertung ist gleich der Bewertung
ScoreScoreScoreScorescorescore des Operators find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model.
- 'score_surface'"score_surface""score_surface""score_surface""score_surface""score_surface":
-
Gibt die oberflächenbasierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index
indizierten Ergebnisses zurück.
Falls nicht speziell anders gesetzt, ist diese Bewertung und
'score_refined'"score_refined""score_refined""score_refined""score_refined""score_refined" gleich.
- 'score_3d_edges'"score_3d_edges""score_3d_edges""score_3d_edges""score_3d_edges""score_3d_edges":
-
Gibt die Bewertung der 3D-Kanten des in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index
indizierten Ergebnisses zurück.
Diese Bewertung ist nur bei oberflächenbasiertem
Matching mit Kantenunterstützung anwendbar.
- 'score_2d_edges'"score_2d_edges""score_2d_edges""score_2d_edges""score_2d_edges""score_2d_edges":
-
Gibt die bildkantenbasierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index
indizierten Ergebnisses zurück.
Diese Bewertung ist nur bei oberflächenbasiertem
Matching mit Kantenunterstützung anwendbar.
- 'score_view_based'"score_view_based""score_view_based""score_view_based""score_view_based""score_view_based":
-
Gibt die ansichtsbasierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index
indizierten Ergebnisses zurück.
Diese Bewertung ist nur bei oberflächenbasiertem Matching mit
einem Modell, das speziell für diese Berechnung trainiert wurde,
anwendbar.
- 'all_scores'"all_scores""all_scores""all_scores""all_scores""all_scores":
-
Gibt für das in ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index indizierte Ergebnis die fünf
Bewertungen 'score'"score""score""score""score""score", 'score_surface'"score_surface""score_surface""score_surface""score_surface""score_surface",
'score_3d_edges'"score_3d_edges""score_3d_edges""score_3d_edges""score_3d_edges""score_3d_edges", 'score_2d_edges'"score_2d_edges""score_2d_edges""score_2d_edges""score_2d_edges""score_2d_edges" und
'score_view_based'"score_view_based""score_view_based""score_view_based""score_view_based""score_view_based" zurück.
Dabei haben die Bewertungen die gleiche Reihenfolge wie die Schwellenwerte,
die über den Parameter MinScoreMinScoreMinScoreMinScoreminScoremin_score der Matching- und
Verfeinerungsoperatoren übergeben werden können.
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
SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultIDsurface_matching_result_id (input_control) surface_matching_result → HSurfaceMatchingResult, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Ergebnishandle des oberflächenbasierten Matchings.
ResultNameResultNameResultNameResultNameresultNameresult_name (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name des Ergebnisdetails.
Defaultwert:
'pose'
"pose"
"pose"
"pose"
"pose"
"pose"
Werteliste: 'all_scores'"all_scores""all_scores""all_scores""all_scores""all_scores", 'key_points'"key_points""key_points""key_points""key_points""key_points", 'pose'"pose""pose""pose""pose""pose", 'sampled_3d_edges'"sampled_3d_edges""sampled_3d_edges""sampled_3d_edges""sampled_3d_edges""sampled_3d_edges", 'sampled_scene'"sampled_scene""sampled_scene""sampled_scene""sampled_scene""sampled_scene", 'score'"score""score""score""score""score", 'score_2d_edges'"score_2d_edges""score_2d_edges""score_2d_edges""score_2d_edges""score_2d_edges", 'score_3d_edges'"score_3d_edges""score_3d_edges""score_3d_edges""score_3d_edges""score_3d_edges", 'score_refined'"score_refined""score_refined""score_refined""score_refined""score_refined", 'score_surface'"score_surface""score_surface""score_surface""score_surface""score_surface", 'score_unrefined'"score_unrefined""score_unrefined""score_unrefined""score_unrefined""score_unrefined", 'score_view_based'"score_view_based""score_view_based""score_view_based""score_view_based""score_view_based"
ResultIndexResultIndexResultIndexResultIndexresultIndexresult_index (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index des Ergebnisses, beginnend mit 0.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 3
Restriktion: ResultIndex >= 0
ResultValueResultValueResultValueResultValueresultValueresult_value (output_control) integer(-array) → HTupleSequence[HTupleElementType]HTupleHtuple (integer / string / real / handle) (int / long / string / double / HHandle) (Hlong / HString / double / HHandle) (Hlong / char* / double / handle)
Wert des Ergebnisses.
Ergebnis
Ist der Handle des Modells gültig, dann liefert
get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResultGetSurfaceMatchingResultget_surface_matching_result den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model,
refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPoserefine_surface_model_pose
Nachfolger
clear_surface_modelclear_surface_modelClearSurfaceModelClearSurfaceModelClearSurfaceModelclear_surface_model
Siehe auch
find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model,
refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPoserefine_surface_model_pose,
read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModelread_surface_model,
write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModelwrite_surface_model,
clear_surface_modelclear_surface_modelClearSurfaceModelClearSurfaceModelClearSurfaceModelclear_surface_model
Modul
3D Metrology