fast_matchfast_matchFastMatchFastMatch (Operator)

Name

fast_matchfast_matchFastMatchFastMatch — Suche nach allen guten Matches eines Templates und eines Bilds.

Warnung

fast_matchfast_matchFastMatchFastMatchFastMatch ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt. Neue Applikationen sollten stattdessen die Form-basierten oder NCC-basierten Operatoren verwenden.

Signatur

fast_match(Image : Matches : TemplateID, MaxError : )

Beschreibung

fast_matchfast_matchFastMatchFastMatchFastMatch führt ein Matching zwischen dem Template von TemplateIDTemplateIDTemplateIDTemplateIDtemplateID und ImageImageImageImageimage durch. Dabei wird das Template so über die Punkte von ImageImageImageImageimage geschoben, dass es immer vollständig innerhalb von ImageImageImageImageimage liegt. Das Matching-Kriterium („displaced frame difference“) ist wie folgt definiert:

Die Laufzeit des Verfahrens hängt von der Größe des Definitionsbereiches von ImageImageImageImageimage ab. Es ist daher wichtig, den Definitionsbereich möglichst einzugrenzen, d.h. den Operator nur in einer möglichst eng umrissenen „region of interest“ anzuwenden. Der Parameter MaxErrorMaxErrorMaxErrorMaxErrormaxError legt den maximalen Fehler fest, den die gesuchten Positionen haben dürfen. Um so kleiner dieser Wert ist, um so schneller läuft das Verfahren.

Alle Punkte, bei denen der Fehler des Matching kleiner als MaxErrorMaxErrorMaxErrorMaxErrormaxError ist, werden in der Ausgaberegion MatchesMatchesMatchesMatchesmatches übergeben.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.

Parameter

ImageImageImageImageimage (input_object) singlechannelimage(-array) → object (byte)

Eingabebild, in dem das Pattern gefunden werden soll.

MatchesMatchesMatchesMatchesmatches (output_object) region(-array) → object

Alle Punkte, bei denen der Fehler unter der Schwelle liegt.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control) template → (integer)

Nummer des Templates.

MaxErrorMaxErrorMaxErrorMaxErrormaxError (input_control) real → (real)

Maximale mittlere Differenz der Grauwerte.

Defaultwert: 20.0

Wertevorschläge: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 9.0, 11.0, 15.0, 17.0, 20.0, 30.0

Typischer Wertebereich: 0 ≤ MaxError MaxError MaxError MaxError maxError ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fast_matchfast_matchFastMatchFastMatchFastMatch den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate, read_templateread_templateReadTemplateReadTemplateReadTemplate, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Nachfolger

connectionconnectionConnectionConnectionConnection, best_matchbest_matchBestMatchBestMatchBestMatch

Alternativen

best_matchbest_matchBestMatchBestMatchBestMatch, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMg, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMg, exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatch, exhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMgExhaustiveMatchMg

Modul

Matching

Operatoren