Bird
Raised Fist0
Computer Visionml~5 mins

Template matching in Computer Vision

Choose your learning style10 modes available

Start learning this pattern below

Jump into concepts and practice - no test required

or
Recommended
Test this pattern10 questions across easy, medium, and hard to know if this pattern is strong
Introduction

Template matching helps find a small image inside a bigger one. It is like looking for a puzzle piece in a big puzzle.

Finding a logo inside a photo
Detecting a button on a screen
Locating a specific object in a picture
Checking if a part is present in a machine image
Syntax
Computer Vision
result = cv2.matchTemplate(image, template, method)
min_val, max_val, min_loc, max_loc = cv2.minMaxLoc(result)

image is the big picture where you search.

template is the small image you want to find.

method is how you compare images, like cv2.TM_CCOEFF_NORMED.

Examples
This uses a method that compares how well the template matches the image, normalized for brightness.
Computer Vision
result = cv2.matchTemplate(image, template, cv2.TM_CCOEFF_NORMED)
This finds where the best and worst matches are in the result.
Computer Vision
min_val, max_val, min_loc, max_loc = cv2.minMaxLoc(result)
Sample Model

This program loads a big image and a template, finds where the template best fits inside the big image, draws a green box around it, and shows the result. It also prints how confident the match is.

Computer Vision
import cv2
import numpy as np

# Load the big image and template in grayscale
image = cv2.imread('big_image.jpg', cv2.IMREAD_GRAYSCALE)
template = cv2.imread('template.jpg', cv2.IMREAD_GRAYSCALE)

# Check if images loaded
if image is None or template is None:
    print('Error loading images')
    exit()

# Apply template matching
result = cv2.matchTemplate(image, template, cv2.TM_CCOEFF_NORMED)

# Find the best match location
min_val, max_val, min_loc, max_loc = cv2.minMaxLoc(result)

# Draw a rectangle around the matched region
top_left = max_loc
h, w = template.shape
bottom_right = (top_left[0] + w, top_left[1] + h)

image_color = cv2.cvtColor(image, cv2.COLOR_GRAY2BGR)
cv2.rectangle(image_color, top_left, bottom_right, (0, 255, 0), 2)

# Show the result
cv2.imshow('Matched Result', image_color)
cv2.waitKey(0)
cv2.destroyAllWindows()

# Print match confidence
print(f'Maximum match confidence: {max_val:.2f}')
OutputSuccess
Important Notes

Template matching works best when the template and image have similar lighting and scale.

It is sensitive to rotation and size changes; the template must match exactly.

Use normalized methods like cv2.TM_CCOEFF_NORMED for better results.

Summary

Template matching finds a small image inside a bigger one by comparing pixel patterns.

It returns a confidence score and location of the best match.

It is simple but works best when the template matches the image exactly in size and orientation.

Practice

(1/5)
1. What is the main purpose of template matching in computer vision?
easy
A. To reduce the size of an image without losing quality
B. To classify images into different categories
C. To find a small image inside a larger image by comparing pixel patterns
D. To generate new images from existing ones

Solution

  1. Step 1: Understand template matching concept

    Template matching searches for a smaller image (template) inside a bigger image by comparing pixel patterns.
  2. Step 2: Compare with other options

    Other options describe classification, resizing, or generation, which are different tasks.
  3. Final Answer:

    To find a small image inside a larger image by comparing pixel patterns -> Option C
  4. Quick Check:

    Template matching = find small image inside big image [OK]
Hint: Template matching = locating small image inside big one [OK]
Common Mistakes:
  • Confusing template matching with image classification
  • Thinking it changes image size
  • Assuming it creates new images
2. Which of the following is the correct OpenCV function call to perform template matching?
easy
A. cv2.matchTemplate(image, template, method)
B. cv2.templateMatch(image, template)
C. cv2.findTemplate(image, template, method)
D. cv2.match(image, template)

Solution

  1. Step 1: Recall OpenCV template matching syntax

    The correct function is cv2.matchTemplate with parameters (image, template, method).
  2. Step 2: Check other options for correctness

    Other options use incorrect function names or missing parameters.
  3. Final Answer:

    cv2.matchTemplate(image, template, method) -> Option A
  4. Quick Check:

    OpenCV template matching = cv2.matchTemplate [OK]
Hint: Remember exact OpenCV function name: matchTemplate [OK]
Common Mistakes:
  • Using wrong function names like templateMatch or findTemplate
  • Omitting the method parameter
  • Confusing with other OpenCV functions
3. Given the following code snippet, what will be the shape of the result from cv2.matchTemplate(image, template, cv2.TM_CCOEFF_NORMED) if image is 100x100 pixels and template is 20x20 pixels?
medium
A. (100, 100)
B. (81, 81)
C. (120, 120)
D. (80, 80)

Solution

  1. Step 1: Understand output size formula

    The output size is (W - w + 1, H - h + 1) where W,H are image dims and w,h are template dims.
  2. Step 2: Calculate output shape

    For image 100x100 and template 20x20, output = (100-20+1, 100-20+1) = (81, 81).
  3. Final Answer:

    (81, 81) -> Option B
  4. Quick Check:

    Output shape = (image - template + 1) [OK]
Hint: Output shape = image size minus template size plus one [OK]
Common Mistakes:
  • Using image size directly as output shape
  • Adding template size instead of subtracting
  • Off-by-one errors in calculation
4. You run template matching but get an error: cv2.error: (-215:Assertion failed) src.type() == templ.type() in function 'matchTemplate'. What is the most likely cause?
medium
A. The template image and source image have different data types or channels
B. The template image is larger than the source image
C. The method parameter is missing in the function call
D. The images are not converted to grayscale

Solution

  1. Step 1: Analyze error message

    The error says src.type() == templ.type() failed, meaning image and template types differ.
  2. Step 2: Identify cause

    Different data types or number of channels (e.g., one grayscale, one color) cause this error.
  3. Final Answer:

    The template image and source image have different data types or channels -> Option A
  4. Quick Check:

    Image and template must have same type [OK]
Hint: Check image and template have same type and channels [OK]
Common Mistakes:
  • Assuming template size causes this error
  • Forgetting to pass method parameter causes this error
  • Thinking grayscale conversion is mandatory for all cases
5. You want to detect a rotated version of a template inside an image using template matching. Which approach is best to improve detection?
hard
A. Resize the image to match the template size
B. Use the original template only without rotation
C. Convert both images to grayscale before matching
D. Rotate the template at multiple angles and run template matching for each

Solution

  1. Step 1: Understand template matching limitation

    Template matching works best when template matches image exactly in size and orientation.
  2. Step 2: Handle rotation

    To detect rotated templates, rotate the template at different angles and match each rotated version.
  3. Final Answer:

    Rotate the template at multiple angles and run template matching for each -> Option D
  4. Quick Check:

    Rotate template for rotated detection [OK]
Hint: Try multiple rotated templates to detect rotated objects [OK]
Common Mistakes:
  • Using only original template ignores rotation
  • Resizing image does not fix rotation mismatch
  • Grayscale conversion helps but doesn't solve rotation