get_descriptor_model_results
— Abfrage von alphanumerischen Ergebnissen, die bei deskriptorbasiertem
Matching angefallen sind.
get_descriptor_model_results( : : ModelID, ObjectID, ResultNames : Results)
Mit dem Operator get_descriptor_model_results
können
alphanumerische Ergebnisse des deskriptorbasierten Matchings abgefragt
werden. Diese Ergebnisse sind im deskriptorbasierten Modell
(ModelID
) gespeichert. Der Parameter ObjectID
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_model
bzw.
find_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.
ResultNames
='num_points' oder
ResultNames
='inlier_ratio' ).
Welche Ergebnisse in Results
zurückgeliefert werden hängt
von den gewählten ResultNames
ab:
Anzahl der Objektpunkte, die mit Modellpunkten übereinstimmen.
Verhältnis der Anzahl der übereinstimmenden Objektpunkte zu der Anzahl der Modellpunkte.
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_origin
).
Geschätzte Objektpose. Dieses Ergebnis kann nur nach einem Aufruf
des Operators find_calib_descriptor_model
abgefragt werden.
liefert hintereinanderhängende Dreiergruppen, welche die
Klassifikationsergebnisse der durch
find_uncalib_descriptor_model
oder
find_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 and der dritten Stelle. Die
Reihenfolge der Such- und Modellpunktindizes entspricht der
Reihenfolge der Punkte, die vom Operator
get_descriptor_model_points
mit Parameter
Subset
='all' und Parameter
Set
='model' bzw. Set
='search'
zurückgegeben werden. Wenn eine Nummer in ObjectID
übergeben
wird, wird nur die Klassifikation der zu diesem Objekt
korrespondierenden Punkte zurückgeliefert. Wenn 'all' in
ObjectID
ü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' ist (siehe
find_calib_descriptor_model
oder
find_uncalib_descriptor_model
), werden verworfen und werden
deswegen im Ergebnistupel nicht aufgelistet.
ModelID
(input_control) descriptor_model →
(handle)
Handle zu einem Deskriptormodell.
ObjectID
(input_control) integer →
(integer / string)
Handle des Objekts, dessen Ergebnisse abgefragt werden sollen.
Defaultwert: 'all'
Wertevorschläge: 'all' , 0, 1, 2, 3
ResultNames
(input_control) attribute.name →
(string)
Name des Ergebnisses, das abgefragt werden soll.
Defaultwert: 'num_points'
Werteliste: 'homography' , 'inlier_ratio' , 'num_points' , 'point_classification' , 'pose'
Results
(output_control) attribute.value(-array) →
(string / integer / real)
Zurückgelieferte Ergebnisse.
find_uncalib_descriptor_model
,
find_calib_descriptor_model
get_descriptor_model_origin
,
get_descriptor_model_params
,
get_descriptor_model_points
Matching