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

get_descriptor_model_results( : : ModelID, ObjectID, ResultNames : Results)

Herror T_get_descriptor_model_results(const Htuple ModelID, const Htuple ObjectID, const Htuple ResultNames, Htuple* Results)

void GetDescriptorModelResults(const HTuple& ModelID, const HTuple& ObjectID, const HTuple& ResultNames, HTuple* Results)

HTuple HDescriptorModel::GetDescriptorModelResults(const HTuple& ObjectID, const HString& ResultNames) const

HTuple HDescriptorModel::GetDescriptorModelResults(Hlong ObjectID, const HString& ResultNames) const

HTuple HDescriptorModel::GetDescriptorModelResults(Hlong ObjectID, const char* ResultNames) const

HTuple HDescriptorModel::GetDescriptorModelResults(Hlong ObjectID, const wchar_t* ResultNames) const   (Nur Windows)

static void HOperatorSet.GetDescriptorModelResults(HTuple modelID, HTuple objectID, HTuple resultNames, out HTuple results)

HTuple HDescriptorModel.GetDescriptorModelResults(HTuple objectID, string resultNames)

HTuple HDescriptorModel.GetDescriptorModelResults(int objectID, string resultNames)

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

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