get_surface_matching_resultT_get_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResult (Operator)

Name

get_surface_matching_resultT_get_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResult — Auslesen von Ergebnissen des oberflächenbasierten Matchings.

Signatur

Beschreibung

Der Operator get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResultGetSurfaceMatchingResult liefert detailierte Ergebnisse des oberflächenbasierten Matchings oder der oberflächenbasierten Pose-Verfeinerung. Die Ergebnisse sind in SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID gespeichert, das mit find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel oder refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPose angelegt wurde.

Der Parameter ResultNameResultNameResultNameResultNameresultName wählt das abzurufende Detailergebnis aus. Bezieht sich das Detailergebnis auf eine der zurückgelieferten Posen, so wählt ResultIndexResultIndexResultIndexResultIndexresultIndex diese aus, wobei mittels 0 das erste Ergebnis selektiert wird. Für einige Werte von ResultNameResultNameResultNameResultNameresultName wird ResultIndexResultIndexResultIndexResultIndexresultIndex ignoriert.

Die folgenden Werte sind für ResultNameResultNameResultNameResultNameresultName möglich, wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID von find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel oder find_surface_model_imagefind_surface_model_imageFindSurfaceModelImageFindSurfaceModelImageFindSurfaceModelImage erzeugt wurde:

'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_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel). Der Parameter ResultIndexResultIndexResultIndexResultIndexresultIndex wird ignoriert.

'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_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel). Der Parameter ResultIndexResultIndexResultIndexResultIndexresultIndex wird ignoriert.

'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 detailierte Beschreibung der Bewertung findet sich in find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel. Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexresultIndex übergeben. Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPose erstellt wurde, wird 0 zurückgegeben.

'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 ResultIndexResultIndexResultIndexResultIndexresultIndex wird ignoriert.

Die folgenden Werte für ResultNameResultNameResultNameResultNameresultName sind unabhängig davon, von welchem Operator SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID erzeugt wurde, möglich:

'pose'"pose""pose""pose""pose":

Gibt die Pose eines der Ergebnisse zurück. Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexresultIndex übergeben.

'score_refined'"score_refined""score_refined""score_refined""score_refined":

Gibt die Bewertung des Ergebnisses nach der exakten Pose-Verfeinerung zurück. Eine detailierte Beschreibung der Bewertung findet sich in find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel. Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexresultIndex übergeben. Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel erstellt wurde und die exakte Pose-Verfeinerung deaktiviert war, wird 0 zurückgegeben.

'score'"score""score""score""score":

Gibt die kombinierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndex indizierten Ergebnisses zurück, d.h., diese Bewertung ist gleich der Bewertung ScoreScoreScoreScorescore des Operators find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel.

'score_surface'"score_surface""score_surface""score_surface""score_surface":

Gibt die oberflächenbasierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndex indizierten Ergebnisses zurück. Falls nicht speziell anders gesetzt, ist diese Bewertung und '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":

Gibt die Bewertung der 3D-Kanten des in ResultIndexResultIndexResultIndexResultIndexresultIndex 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":

Gibt die Bildkantenbasierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndex 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":

Gibt die ansichtsbasierte Bewertung des in ResultIndexResultIndexResultIndexResultIndexresultIndex 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":

Gibt für das in ResultIndexResultIndexResultIndexResultIndexresultIndex indizierte Ergebnis die fünf Bewertungen 'score'"score""score""score""score", '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_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" zurück. Dabei haben die Bewertungen die gleiche Reihenfolge wie die Schwellwerte, die über den Parameter MinScoreMinScoreMinScoreMinScoreminScore 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

Ergebnis

Ist der Handle des Modells gültig, dann liefert get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResultGetSurfaceMatchingResult den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPose

Nachfolger

clear_surface_modelclear_surface_modelClearSurfaceModelClearSurfaceModelClearSurfaceModel

Siehe auch

find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPose, read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModel, write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModel, clear_surface_modelclear_surface_modelClearSurfaceModelClearSurfaceModelClearSurfaceModel

Modul

3D Metrology