get_generic_shape_model_result_object — Auslesen von Objekten des Matching-Ergebnisses.
get_generic_shape_model_result_object( : Objects : MatchResultID, MatchSelector, GenParamName : )
get_generic_shape_model_result_object gibt in Objects die
ikonischen Ergebnisse eines formbasierten Matchings zurück.
Die Matching-Ergebnisse sind in MatchResultID enthalten.
Der Parameter MatchSelector dient zur Auswahl von welchen Matches
Werte ausgelesen werden sollen. Für weitere Informationen und eine Liste
von unterstützten Werten für MatchSelector siehe
get_generic_shape_model_result.
GenParamName gibt an welches Objekt des Matching-Ergebnisses
zurückgegeben werden soll. Folgende Werte sind setzbar:
Die Modellkonturen, dem Matching-Ergebnis entsprechend transformiert.
Achtung: Die Modellkonturen sind nur verfügbar, wenn bei der Suche 'prepare_contours_for_visualization' auf 'true' gesetzt war.
Die Region in der keine Störungen auftreten sollen.
Achtung: Die Störregion ist nur verfügbar, wenn eine Störregion dem Formmodell hinzugefügt worden ist und bei der Suche 'prepare_clutter_region_for_visualization' auf 'true' gesetzt war.
Parameter, die zusätzliche Informationen benötigen um ein ikonisches
Ergebnisse zurückzugeben, werden in einem Dictionary als Schlüssel
'param_name' mit zusätzlichen Schlüssel-Werte-Paaren übergeben.
Dabei hängen die zusätzlichen Schlüssel-Werte-Paare vom abgefragten
'param_name' ab.
Unbekannte Schlüssel werden ignoriert.
Die folgenden Parameter können abgefragt werden:
score_visualization_contours:
Teile der Modellkonturen, bei denen die Score-Beiträge der einzelnen
Modellpunkte im übergebenen Interval sind.
Die Modellkonturen sind dem Matching-Ergebnis entsprechend transformiert.
Die folgenden zusätzlichen Schlüssel sind notwendig, um
score_visualization_contours abzufragen:
low:
Unterer Schwellwert des Intervals.
Modellkonturen mit Score-Beiträgen größer oder gleich low
werden zurückgegeben.
Für low kann ein reeller Wert im Bereich
[-1.0, 1.0] gesetzt werden oder der String
'min' als niedrigster möglicher Wert übergeben werden.
high:
Oberer Schwellwert des Intervals.
Modellkonturen mit Score-Beiträgen kleiner als high werden
zurückgegeben.
Für high kann ein reeller Wert im Bereich
[-1.0, 1.0] gesetzt werden oder der String
'max' als höchster möglicher Wert übergeben werden. Es ist zu
beachten, dass für 1.0 und 'max' der Schwellwert
inkludierend betrachtet wird, sprich Teile der Kontur mit
Score-Beiträgen kleiner und gleich zu 1.0 und 'max'
zurückgegeben werden.
Die Score-Beiträge werden in find_generic_shape_model für jeden
Modellpunkt berechnet. Alle Teile der Kontur, deren Median aus
benachbarten Score-Beiträgen größer oder gleich low und kleiner
als high ist, werden zurückgegeben.
16 Score-Beiträge werden beim Median einbezogen.
Für Modellkonturen mit weniger als 16 Score-Beiträgen werden alle verfügbaren Score-Beiträge einmal ausgewertet und mit den Schwellwerten verglichen.
Für längere, geschlossene Konturen wird der Bereich, in dem Score-Beiträge einbezogen werden, über Start- und Endpunkt der Kontur hinaus fortgesetzt.
Für längere, offene Konturen wird der jeweils erste oder letzte Wert am Start oder Ende wiederholt.
Es ist zu beachten, dass abhängig vom in
find_generic_shape_model gesetzten Wert 'metric' die
Wertebereiche der Score-Beiträge unterschiedlich sind.
Achtung: Die Score-Beiträge sind nur verfügbar, wenn bei der Suche 'score_visualization' auf 'true' gesetzt war.
Objects (output_object) (multichannel-)object(-array) → object
Auszulesende Objekte des Matching-Ergebnisses.
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 / handle)
Name des auszulesenden Ergebnisparameters.
Default: 'contours'
Werteliste: 'clutter_region', 'contours'
* Get score visualization contours by passing a dictionary for GenParamName.
GenParamName := dict{param_name: 'score_visualization_contours'}
GenParamName.low := 0.25
GenParamName.high := 'max'
get_generic_shape_model_result_object (ScoreVisContour, MatchResultID, \
'all', GenParamName)
Sind die Parameterwerte korrekt, dann liefert
get_generic_shape_model_result_object den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
Matching