get_generic_shape_model_result — Auslesen alphanumerischer Werte des Matching-Ergebnisses.
get_generic_shape_model_result( : : MatchResultID, MatchSelector, GenParamName : GenParamValue)
get_generic_shape_model_result gibt alphanumerische Ergebnisse des
formbasierten Matchings in GenParamValue zurück. Die in
MatchResultID enthaltenen Matches sind absteigend nach ihrem
Score sortiert.
Der Parameter MatchSelector dient zur Auswahl von welchen Matches
Werte ausgelesen werden sollen. Die Reihenfolge der Matches wird dabei ihren
Scores entsprechend beibehalten, daher ist die Auswahl unabhängig von der
Reihenfolge der Auswahlkriterien die in MatchSelector
übergeben werden. Zudem wird ein Matching-Ergebnis nur einmal zurückgegeben,
auch wenn es mehr als ein Auswahlkriterium erfüllt.
Für MatchSelector können folgende Auswahlkriterien verschiedener
Arten übergeben und kombiniert werden:
'all':
Alle Matching-Ergebnisse werden ausgewählt.
'best':
Das Matching-Ergebnis mit dem höchsten Score wird ausgewählt.
Ergebnisindex:
Wird eine (ganze) Zahl für MatchSelector gesetzt, wird damit der
Index des Matches in MatchResultID festgelegt.
Wertebereich: 0 bis n-1 (wobei n für die Anzahl Ergebnisse steht).
Ist der angegebene Index außerhalb des zulässigen Wertebereichs wird eine Fehlermeldung zurückgegeben.
Identifikator des Formmodells:
Alle Matches die mit einem bestimmten Formmodell gefunden wurden werden
ausgewählt. Dazu kann der Modell-Identifikator 'model_identifier'
als String an MatchSelector übergeben werden.
Handle des Formmodells:
Alle Matches die mit einem bestimmten Formmodell gefunden wurden werden
ausgewählt. Dazu kann das Handle des Formmodells an MatchSelector
übergeben werden.
Falls MatchSelector kein gültiges Auswahlkriterium ist,
wird eine Fehlermeldung zurückgegeben.
GenParamName gibt an welcher alphanumerische Ergebniswert
zurückgegeben werden soll. Folgende Werte sind setzbar:
'num_match_result':
Anzahl Matches. Für mehrere Auswahlkriterien in MatchSelector
wird die kumulierte Anzahl zurückgegeben.
'model_identifier':
String der das Modell identifiziert, mit welchem der Match gefunden wurde.
'score':
Score des gefundenen Matches. Der Score ist eine Zahl zwischen
0 und 1 und gibt näherungsweise an wie gut das Modell im Bild gefundenen
wurde. Für weitere Informationen zur Bedeutung des Scores, siehe
„Solution Guide II-B - Matching“, Kapitel 'General Topics',
Abschnitt 'About the Score'.
'angle':
'angle':
Rotationswinkel des gefundenen Matches.
Wertebereich: -3.14 'angle' 3.14 (=).
'row':
Zeilenkoordinate des gefundenen Matches im Suchbild. Die Koordinate bezieht sich auf den Ursprung des Formmodells.
'column':
Spaltenkoordinate des gefundenen Matches im Suchbild. Die Koordinate bezieht sich auf den Ursprung des Formmodells.
'scale_row':
Skalierung des gefundenen Matches in Zeilenrichtung.
'scale_column':
Skalierung des gefundenen Matches in Spaltenrichtung.
'hom_mat_2d':
Homographische Transformationsmatrix zum Transformieren der
Formmodellkonturen von ihrem Ursprung an den Ort im Suchbild an dem
der Match gefunden wurde. Dabei werden Position, Rotation und Skalierung
berücksichtigt. Für weitere Informationen zur Transformation mit
homographischen Matrizen siehe affine_trans_point_2d.
'clutter_score':
Störwert des gefundenen Matches. Der Wert ist eine Zahl zwischen 0 und 1 und gibt näherungsweise an wie stark Störkanten in der Störregion vorhanden sind.
'clutter_hom_mat_2d':
Homographische Transformationsmatrix zum Transformieren der
Störregion des Formmodells von ihrem Ursprung an den Ort im Suchbild an dem
der Match gefunden wurde. Dabei werden Position, Rotation und Skalierung
berücksichtigt. Für weitere Informationen zur Transformation mit
homographischen Matrizen siehe affine_trans_point_2d.
'match':
Dictionary, welches die Koordinate 'row', 'column', den
Rotationswinkel 'angle', die Skalierung 'scale_row',
'scale_column', den Score 'score' und die homographische
Transformation 'hom_mat_2d' des gefundenen Matches enthält. Die
beiden Clutter-spezifischen Ergebnisse 'clutter_score' und
'clutter_hom_mat_2d' sind nur im Dictionary enthalten, falls Clutter
trainiert und verwendet wurde (siehe set_generic_shape_model_object mit
'clutter_region').
'time_measurement':
Dictionary mit den Zeitmessungen während der Suche. Es ist zu beachten, dass die Summe der Einzelzeiten weniger als die gesamte Zeit des Operatorenaufrufs ist. Das Dictionary enthält die vier Hauptschritte der Suchpipeline 'pipeline':
'pyramid': Zeit zur Erzeugung der Bildpyramide.
'top_level': Zeit zur Suche der Kandidaten auf der obersten Pyramidenstufe.
'tracking': Zeit zum Propagieren der Kandidaten von der obersten Pyramidenstufe auf die unterste.
'subpixel_refinement': Zeit zur Verfeinerung am Ende der Suche.
Restriktion: MatchSelector muss auf 'all' gesetzt werden.
Es ist zu beachten, dass für Werte, die sich auf die Lage der Matches beziehen Koordinaten als Ecken-zentrierte Koordinaten gegeben werden. Für weitere Informationen über Ecken-zentrierte Koordinaten siehe das Kapitel Transformationen / 2D-Transformationen.
MatchResultID (input_control) generic_shape_model_result → (handle)
Handle der Matches.
MatchSelector (input_control) string-array → (string / integer)
Selektor für die auszulesenden Matching-Ergebnisse.
Default: 'all'
Werteliste: 'all', 'best'
GenParamName (input_control) attribute.name → (string)
Name des auszulesenden Ergebnisparameters.
Default: 'score'
Werteliste: 'angle', 'clutter_hom_mat_2d', 'clutter_score', 'column', 'hom_mat_2d', 'match', 'model_identifier', 'num_match_result', 'row', 'scale_column', 'scale_row', 'score', 'time_measurement'
GenParamValue (output_control) attribute.value-array → (real / integer / string)
Wert des auszulesenden Ergebnisparameters.
Sind die Parameterwerte korrekt, dann liefert
get_generic_shape_model_result den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls wird
eine Fehlerbehandlung durchgeführt.
Matching