HALCON Website / HALCON Operator-Referenz / Legacy / Matching
KlassenKlassen | | Operatoren

best_matchbest_matchBestMatchBestMatch (Operator)

Name

best_matchbest_matchBestMatchBestMatch — Suche des besten Matching zwischen einem Template und einem Bild.

Warnung

best_matchbest_matchBestMatchBestMatchBestMatch 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

best_match(Image : : TemplateID, MaxError, SubPixel : Row, Column, Error)

Herror best_match(const Hobject Image, const Hlong TemplateID, double MaxError, const char* SubPixel, double* Row, double* Column, double* Error)

Herror T_best_match(const Hobject Image, const Htuple TemplateID, const Htuple MaxError, const Htuple SubPixel, Htuple* Row, Htuple* Column, Htuple* Error)

void BestMatch(const HObject& Image, const HTuple& TemplateID, const HTuple& MaxError, const HTuple& SubPixel, HTuple* Row, HTuple* Column, HTuple* Error)

void HTemplate::BestMatch(const HImage& Image, double MaxError, const HString& SubPixel, HTuple* Row, HTuple* Column, HTuple* Error) const

void HTemplate::BestMatch(const HImage& Image, double MaxError, const HString& SubPixel, double* Row, double* Column, double* Error) const

void HTemplate::BestMatch(const HImage& Image, double MaxError, const char* SubPixel, double* Row, double* Column, double* Error) const

void HImage::BestMatch(const HTemplate& TemplateID, double MaxError, const HString& SubPixel, HTuple* Row, HTuple* Column, HTuple* Error) const

void HImage::BestMatch(const HTemplate& TemplateID, double MaxError, const HString& SubPixel, double* Row, double* Column, double* Error) const

void HImage::BestMatch(const HTemplate& TemplateID, double MaxError, const char* SubPixel, double* Row, double* Column, double* Error) const

static void HOperatorSet.BestMatch(HObject image, HTuple templateID, HTuple maxError, HTuple subPixel, out HTuple row, out HTuple column, out HTuple error)

void HTemplate.BestMatch(HImage image, double maxError, string subPixel, out HTuple row, out HTuple column, out HTuple error)

void HTemplate.BestMatch(HImage image, double maxError, string subPixel, out double row, out double column, out double error)

void HImage.BestMatch(HTemplate templateID, double maxError, string subPixel, out HTuple row, out HTuple column, out HTuple error)

void HImage.BestMatch(HTemplate templateID, double maxError, string subPixel, out double row, out double column, out double error)

Beschreibung

best_matchbest_matchBestMatchBestMatchBestMatch 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. best_matchbest_matchBestMatchBestMatchBestMatch arbeitet ähnlich wie fast_matchfast_matchFastMatchFastMatchFastMatch mit der Erweiterung, dass jedesmal wenn eine Position mit einem geringeren Matching-Fehler gefunden wurde, der Parameter MaxErrorMaxErrorMaxErrorMaxErrormaxError intern entsprechend angepasst (d.h. verkleinert) wird, um die Rechenzeit zu verkürzen. Abhängig vom Parameter SubPixelSubPixelSubPixelSubPixelsubPixel wird die Position in Subpixelgenauigkeit ausgegeben. 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 gesuchte Position haben darf. Um so kleiner dieser Wert ist, um so schneller läuft das Verfahren.

RowRowRowRowrow und ColumnColumnColumnColumncolumn liefern die Position des Best-Match, wobei ErrorErrorErrorErrorerror die mittlere Abweichung der Grauwerte angiebt.

Falls keine Position mit einem Fehler unter MaxErrorMaxErrorMaxErrorMaxErrormaxError gefunden wurde, wird die Position (0,0) und ein Matching-Fehler von 255 für ErrorErrorErrorErrorerror geliefert. In diesem Fall müs der Wert für MaxErrorMaxErrorMaxErrorMaxErrormaxError größer gewählt werden.

Der maximale Fehler der Position (ohne Rauschen) beträgt im sub-Pixel Modus 0.1 Pixel. Der mittlere Fehler betra"gt 0.03 Pixel.

Ausführungsinformationen

Parameter

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

Eingabebild, in dem das Pattern gefunden werden soll.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control)  template → HTemplate, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Nummer des Templates.

MaxErrorMaxErrorMaxErrorMaxErrormaxError (input_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

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, 40.0, 50.0, 60.0, 70.0

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 3

SubPixelSubPixelSubPixelSubPixelsubPixel (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Subpixel Genauigkeit falls 'true'"true""true""true""true".

Defaultwert: 'false' "false" "false" "false" "false"

Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"

RowRowRowRowrow (output_control)  point.y(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Zeilenposition des Best-Match.

ColumnColumnColumnColumncolumn (output_control)  point.x(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Spaltenposition des Best-Match.

ErrorErrorErrorErrorerror (output_control)  real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Mittlere Abweichung der Grauwerte des Best-Match.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert best_matchbest_matchBestMatchBestMatchBestMatch 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, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate, set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Alternativen

fast_matchfast_matchFastMatchFastMatchFastMatch, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMg, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMg, best_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMgBestMatchPreMg, best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot, best_match_rot_mgbest_match_rot_mgBestMatchRotMgBestMatchRotMgBestMatchRotMg, exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatch, exhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMgExhaustiveMatchMg

Modul

Matching

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH