🖥
🖥
🖥
🖥
AugeLab Studio Manual
English
Ask or search…
K
Comment on page

Find Object

Find Object Node Documentation

The Find Object node in AugeLab Studio is used to find objects in an image based on Find Object. It compares a template image with an input image to locate instances of the template within the input image.

Node Overview

The Find Object node performs template matching to find instances of a template image within an input image. It uses various methods to match the template and provides the coordinates and count of the matched objects.

Node Properties

  • Node Title: Find Object
  • Node ID: OP_NODE_TEMPLATE_MATCH

Inputs

The Find Object node has the following input sockets:
  1. 1.
    Main Image: The input image in which the object will be searched.
  2. 2.
    Object Image: The template image representing the object to be found.

Outputs

The Find Object node has the following output sockets:
  1. 1.
    Detected Image: The input image with the matched objects highlighted.
  2. 2.
    Object Positions: The shape of the matched objects represented as rectangles.
  3. 3.
    Object Count: The number of matched objects found in the input image.
  4. 4.
    Rectangle Coordinates: The coordinates of the rectangles encompassing the matched objects.

Parameters

The Find Object node provides the following parameters for configuration:
  • Method: The template matching method to be used. It can be one of the following options:
    • TM_CCOEFF_NORMED: Normalized cross-correlation coefficient method.
    • TM_CCORR_NORMED: Normalized cross-correlation method.
    • TM_SQDIFF: Sum of squared differences method.
    • TM_SQDIFF_NORMED: Normalized sum of squared differences method.
    • TM_CCORR: Cross-correlation method.
    • TM_CCOEFF: Cross-correlation coefficient method.
  • Match Threshold %: The threshold value for considering a match. It is expressed as a percentage of the maximum value. Adjust this value to control the sensitivity of the matching.

Usage

  1. 1.
    Drag and drop the Find Object node from the node library onto the canvas in AugeLab Studio.
  2. 2.
    Connect the main image to the Main Image input socket of the Find Object node.
  3. 3.
    Connect the object image (template) to the Object Image input socket of the Find Object node.
  4. 4.
    Configure the desired parameters of the Find Object node, such as the matching method and the match threshold.
  5. 5.
    Run the pipeline.
  6. 6.
    The Find Object node will perform template matching between the object image and the main image.
  7. 7.
    The matched objects will be highlighted in the Detected Image output.
  8. 8.
    The Object Positions output will provide the shape of the matched objects represented as rectangles.
  9. 9.
    The Object Count output will indicate the number of matched objects found in the input image.
  10. 10.
    The Rectangle Coordinates output will provide the coordinates of the rectangles encompassing the matched objects.
  11. 11.
    Retrieve the outputs for further analysis, processing, or visualization.

Notes

  • The Find Object node performs template matching to find instances of a template image within an input image.
  • It uses various matching methods to compare the template with the input image.
  • Adjust the match threshold to control the sensitivity of the matching process.
  • The outputs include the image with the matched objects highlighted, the shape of the matched objects as rectangles, the count of the matched objects, and the coordinates of the rectangles encompassing the matched objects.
  • Use the outputs for further analysis, processing, or visualization.
  • If no match is found, the outputs will reflect the absence of matched objects.
  • Proper error handling is implemented in case the maximum number of matches is reached. In such cases, the threshold value needs to be adjusted to find more matches.
  • Experiment with different template matching methods and threshold values to achieve the desired results.
That concludes the documentation for the Find Object node in AugeLab Studio. Use this node to find objects in an image based on template matching. This node is useful for various applications such as object recognition, localization, and tracking.