exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg (Operator)

Name

exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg — Matching a template and an image in a resolution pyramid.

Signature

Description

The operator exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg is an additional option for the operator exhaustive_matchexhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatch performing a matching of the image ImageImageImageImageimage and the template ImageTemplateImageTemplateImageTemplateImageTemplateimageTemplate. Hereby ImageTemplateImageTemplateImageTemplateImageTemplateimageTemplate will be moved over all points of the region of ImageImageImageImageimage, a matching criterion will be calculated with regard to the parameter ModeModeModeModemode and the result values will be stored in ImageMatchImageMatchImageMatchImageMatchimageMatch.

Of images having been filtered this way, normally only those areas with good matching results are of interest. The size of the area to be searched, i.e. the region of the input image ImageImageImageImageimage, determines decisively the runtime of the matching filter. Therefore it is recommendable to use at first exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg with reduced image resolution in order to determine a “region of interest” in which good matching results can be expected; then in this restricted area only the real matching (see also exhaustive_matchexhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatch) will be executed with normal resolution.

Hereby the Gauss-pyramids of ImageImageImageImageimage and ImageTemplateImageTemplateImageTemplateImageTemplateimageTemplate will be composed (in particular the corresponding regions will be transformed as well). Then on each level of the resolution pyramids - starting with the startlevel LevelLevelLevelLevellevel - the matching inside the current “region of interest” will be executed. Whereby the “region of interest” on the startlevel is equivalent to the region of the input image ImageImageImageImageimage. After the filtering, a new “region of interest” is determined with the help of a threshold operation and will be transformed on the next resolution level:

    threshold(...:...:0,Threshold,...:),   if Mode = 'dfd'
    threshold(...:...:Threshold,255,...:), if Mode = 'norm_correlation'

The final matching in the determined “region of interest” will then be calculated with the highest resolution (LevelLevelLevelLevellevel 0). The output image ImageMatchImageMatchImageMatchImageMatchimageMatch includes the corresponding filter result and the final “region of interest”, which is determined on the result image with the help of a threshold operation.

The operator exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg therefore is not simply a filter, but can also be considered as a member of the class of region transformations.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

Example (C)

read_image(&Image,"monkey");
disp_image(Image,WindowHandle);
draw_rectangle2(WindowHandle,&Row,&Column,&Phi,&Length1,&Length2);
gen_rectangle2(&Rectangle,Row,Column,Phi,Length1,Length2);
reduce_domain(Image,Rectangle,&Template);
exhaustive_match_mg(Image,Template,&ImageMatch,'dfd'1,30);
invert_image(ImageMatch,&ImageInvert);
local_max(ImageInvert,&BestFit);
disp_region(BestFit,WindowHandle);

Result

If the parameter values are correct, the operator exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg returns the value 2 (H_MSG_TRUE). If the input is empty (no input images are available) the behaviour can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

draw_regiondraw_regiondraw_regionDrawRegionDrawRegion, draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1

Possible Successors

thresholdthresholdthresholdThresholdThreshold, local_maxlocal_maxlocal_maxLocalMaxLocalMax

Alternatives

exhaustive_matchexhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatch

See also

gen_gauss_pyramidgen_gauss_pyramidgen_gauss_pyramidGenGaussPyramidGenGaussPyramid

Module

Foundation