get_descriptor_model_resultsT_get_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsget_descriptor_model_results (Operator)
Name
get_descriptor_model_resultsT_get_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsget_descriptor_model_results — Abfrage von alphanumerischen Ergebnissen, die bei deskriptorbasiertem
Matching angefallen sind.
Signatur
def get_descriptor_model_results(model_id: HHandle, object_id: Union[int, str], result_names: str) -> Sequence[Union[int, float, str]]
def get_descriptor_model_results_s(model_id: HHandle, object_id: Union[int, str], result_names: str) -> Union[int, float, str]
Beschreibung
Mit dem Operator get_descriptor_model_resultsget_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsGetDescriptorModelResultsget_descriptor_model_results können
alphanumerische Ergebnisse des deskriptorbasierten Matchings abgefragt
werden. Diese Ergebnisse sind im deskriptorbasierten Modell
(ModelIDModelIDModelIDModelIDmodelIDmodel_id) gespeichert. Der Parameter ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id 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_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model bzw.
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model 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.
ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names='num_points'"num_points""num_points""num_points""num_points""num_points" oder
ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names='inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio").
Welche Ergebnisse in ResultsResultsResultsResultsresultsresults zurückgeliefert werden hängt
von den gewählten ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names ab:
- 'num_points'"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""inlier_ratio":
-
Verhältnis der Anzahl der übereinstimmenden Objektpunkte zu der
Anzahl der Modellpunkte.
- 'homography'"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_originSetDescriptorModelOriginSetDescriptorModelOriginSetDescriptorModelOriginset_descriptor_model_origin).
- 'pose'"pose""pose""pose""pose""pose":
-
Geschätzte Objektpose. Dieses Ergebnis kann nur nach einem Aufruf
des Operators find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model abgefragt werden.
- 'point_classification'"point_classification""point_classification""point_classification""point_classification""point_classification":
liefert hintereinander hängende Dreiergruppen, welche die
Klassifikationsergebnisse der durch
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model oder
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model im Suchbild extrahierten Punkte
wiedergeben. Jede Dreiergruppe enthält einen Suchpunktindex
an der ersten, einen Modellpunktindex an der zweiten und
die Klassifikationsbewertung und der dritten Stelle. Die
Reihenfolge der Such- und Modellpunktindizes entspricht der
Reihenfolge der Punkte, die vom Operator
get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPointsget_descriptor_model_points mit Parameter
SubsetSubsetSubsetSubsetsubsetsubset='all'"all""all""all""all""all" und Parameter
SetSetSetSetsetset='model'"model""model""model""model""model" bzw. SetSetSetSetsetset='search'"search""search""search""search""search"
zurückgegeben werden. Wenn eine Nummer in ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id übergeben
wird, wird nur die Klassifikation der zu diesem Objekt
korrespondierenden Punkte zurückgeliefert. Wenn 'all'"all""all""all""all""all" in
ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id ü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""min_score_descr" ist (siehe
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model oder
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model), 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
ModelIDModelIDModelIDModelIDmodelIDmodel_id (input_control) descriptor_model → HDescriptorModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle zu einem Deskriptormodell.
ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id (input_control) integer → HTupleUnion[int, str]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Handle des Objekts, dessen Ergebnisse abgefragt
werden sollen.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2, 3
ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names (input_control) attribute.name → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name des Ergebnisses, das abgefragt werden soll.
Defaultwert:
'num_points'
"num_points"
"num_points"
"num_points"
"num_points"
"num_points"
Werteliste: 'homography'"homography""homography""homography""homography""homography", 'inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio", 'num_points'"num_points""num_points""num_points""num_points""num_points", 'point_classification'"point_classification""point_classification""point_classification""point_classification""point_classification", 'pose'"pose""pose""pose""pose""pose"
ResultsResultsResultsResultsresultsresults (output_control) attribute.value(-array) → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Zurückgelieferte Ergebnisse.
Vorgänger
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model,
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model
Siehe auch
get_descriptor_model_originget_descriptor_model_originGetDescriptorModelOriginGetDescriptorModelOriginGetDescriptorModelOriginget_descriptor_model_origin,
get_descriptor_model_paramsget_descriptor_model_paramsGetDescriptorModelParamsGetDescriptorModelParamsGetDescriptorModelParamsget_descriptor_model_params,
get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPointsget_descriptor_model_points
Modul
Matching