get_descriptor_model_resultsT_get_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResults (Operator)
Name
get_descriptor_model_resultsT_get_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResults — Abfrage von alphanumerischen Ergebnissen, die bei deskriptorbasiertem
Matching angefallen sind.
Signatur
Beschreibung
Mit dem Operator get_descriptor_model_resultsget_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsGetDescriptorModelResults können
alphanumerische Ergebnisse des deskriptorbasierten Matchings abgefragt
werden. Diese Ergebnisse sind im deskriptorbasierten Modell
(ModelIDModelIDModelIDModelIDmodelID) gespeichert. Der Parameter ObjectIDObjectIDObjectIDObjectIDobjectID gibt das
Objekt an, dessen Ergebnisse zurückgegeben werden sollen. Der Index
der Objekte beginnt mit 0. Auf die Objekte ist in der gleichen
Reihenfolge zuzugreifen in der sie von
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModel bzw.
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel gefunden werden. Ergebnisse
können auch für alle Objekte gleichzeitig abgefragt werden, wenn der
gewünschte Wert ein Einzelwert und kein Tupelwert ist (z.B.
ResultNamesResultNamesResultNamesResultNamesresultNames='num_points'"num_points""num_points""num_points""num_points" oder
ResultNamesResultNamesResultNamesResultNamesresultNames='inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio").
Welche Ergebnisse in ResultsResultsResultsResultsresults zurückgeliefert werden hängt
von den gewählten ResultNamesResultNamesResultNamesResultNamesresultNames ab:
- 'num_points'"num_points""num_points""num_points""num_points":
-
Anzahl der Objektpunkte, die mit Modellpunkten übereinstimmen.
- 'inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio":
-
Verhältnis der Anzahl der übereinstimmenden Objektpunkte zu der
Anzahl der Modellpunkte.
- 'homography'"homography""homography""homography""homography":
-
3x3 projektive Transformationsmatrix, welche die Modellpunkte in
Objektpunkte transformiert. Es ist zu beachten, dass die Punktabbildung
von dem ausgewählten Modellursprung abhängt (siehe
set_descriptor_model_originset_descriptor_model_originSetDescriptorModelOriginSetDescriptorModelOriginSetDescriptorModelOrigin).
- 'pose'"pose""pose""pose""pose":
-
Geschätzte Objektpose. Dieses Ergebnis kann nur nach einem Aufruf
des Operators find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel abgefragt werden.
- 'point_classification'"point_classification""point_classification""point_classification""point_classification":
liefert hintereinanderhängende Dreiergruppen, welche die
Klassifikationsergebnisse der durch
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModel oder
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel im Suchbild extrahierten Punkte
wiedergeben. Jede Dreiergruppe enthält einen Suchpunktindex
an der ersten, einen Modellpunktindex an der zweiten und
die Klassifikationsbewertung and der dritten Stelle. Die
Reihenfolge der Such- und Modellpunktindizes entspricht der
Reihenfolge der Punkte, die vom Operator
get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPoints mit Parameter
Subset='all'"all""all""all""all" und Parameter
Set='model'"model""model""model""model" bzw. Set='search'"search""search""search""search"
zurückgegeben werden. Wenn eine Nummer in ObjectIDObjectIDObjectIDObjectIDobjectID übergeben
wird, wird nur die Klassifikation der zu diesem Objekt
korrespondierenden Punkte zurückgeliefert. Wenn 'all'"all""all""all""all" in
ObjectIDObjectIDObjectIDObjectIDobjectID übergeben wird, wird die Klassifikation für
alle Punkte zurückgeliefert, auch wenn sie keinem Objekt zugeordnet
wurden. Die Dreiergruppen werden nach ihrer Klassifikationsbewertung
geordnet. Punkte, deren Bewertung niedriger als der Wert des
Deskriptorparameters 'min_score_descr'"min_score_descr""min_score_descr""min_score_descr""min_score_descr" ist (siehe
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel oder
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModel), werden verworfen und werden
deswegen im Ergebnistupel nicht aufgelistet.
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
ModelIDModelIDModelIDModelIDmodelID (input_control) descriptor_model → HDescriptorModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle zu einem Deskriptormodell.
ObjectIDObjectIDObjectIDObjectIDobjectID (input_control) integer → HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Handle des Objekts, dessen Ergebnisse abgefragt
werden sollen.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all", 0, 1, 2, 3
ResultNamesResultNamesResultNamesResultNamesresultNames (input_control) attribute.name → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name des Ergebnisses, das abgefragt werden soll.
Defaultwert:
'num_points'
"num_points"
"num_points"
"num_points"
"num_points"
Werteliste: 'homography'"homography""homography""homography""homography", 'inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio", 'num_points'"num_points""num_points""num_points""num_points", 'point_classification'"point_classification""point_classification""point_classification""point_classification", 'pose'"pose""pose""pose""pose"
ResultsResultsResultsResultsresults (output_control) attribute.value(-array) → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Zurückgelieferte Ergebnisse.
Vorgänger
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModel,
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel
Siehe auch
get_descriptor_model_originget_descriptor_model_originGetDescriptorModelOriginGetDescriptorModelOriginGetDescriptorModelOrigin,
get_descriptor_model_paramsget_descriptor_model_paramsGetDescriptorModelParamsGetDescriptorModelParamsGetDescriptorModelParams,
get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPoints
Modul
Matching