matchTemplate

Description

Compares a template against overlapped image regions.

Signature

cv2.matchTemplate(image, templ, method[, result[, mask]]) → result

Parameters

Explanation

The function slides through image, compares the overlapped patches of size \(w \times h\) against templ using the specified method and stores the comparison results in result. TemplateMatchModes describes the formulae for the available comparison methods (\(I\) denotes image, \(T\) template, \(R\) result, \(M\) the optional mask). The summation is done over template and/or the image patch: \(x'=0...w−1,y'=0...h−1\).

After the function finishes the comparison, the best matches can be found as global minimums (when TM_SQDIFF was used) or maximums (when TM_CCORR or TM_CCOEFF was used) using the minMaxLoc function. In case of a color image, template summation in the numerator and each sum in the denominator is done over all of the channels and separate mean values are used for each channel. That is, the function can take a color template and a color image. The result will still be a single-channel image, which is easier to analyze.

Notes


References

Created with OpenCV 4.4.0