Geometric Matching Controls

NI Vision Builder

Check for Presence Tab Locate Features Tab

Geometric Matching Controls

Main Tab

The following controls are available on the Main tab.

Control Name Description
Step Name Name to give the step.
Region of Interest The region of interest you want to use for the step.
Reposition Region of Interest When enabled, the step dynamically repositions the region of interest based on a coordinate system you built in a previous step.
Reference Coordinate System Coordinate system to which you want to link the region of interest.

Template Tab

The following controls are available on the Template tab.

Control Name Description
Template Image Image you want to search for in an inspection image.
Template Size The width and height, in pixels, of the selected template image.
New Template Launches the NI Vision Template Editor wizard, in which you can learn a template and use the resulting template for searching.
Edit Template Launches the Geometric Matching Training Interface wizard, in which you can modify an existing template and use the resulting template for searching.

Curve Tab

The following controls are available on the Curve tab.

Control Name Description
Extraction Mode Specifies the mode to use to identify the location of the curves in the image.
  • Normal—Makes no assumptions about the uniformity of objects in the image or the image background.
  • Uniform Regions—Assumes that either the objects in the image or the image background consists of uniform pixel values. Use this mode to calculate the external curves of objects with greater accuracy.
Edge Threshold Specifies the threshold value for grayscale edge detection. This value can range from 0 to 255. The default value is 75.
Edge Filter Size Specifies the kernel size for computing the edges in the image. The following options are available:
  • Normal
  • Fine
Minimum Length Specifies the minimum length, in pixels, of an extracted curve. The default value is 25.
Row Search Step Size Specifies the number of pixels to skip in the vertical direction when searching for curves. The default value is 15.
Column Search Step Size Specifies the number of pixels to skip in the horizontal direction when searching for curves. The default value is 15.

Settings Tab

The following controls are available on the Settings tab.

Control Name Description
Number of Matches to Find Specifies the number of valid matches you expect the geometric matching function to return.
Minimum Score Specifies the minimum score an instance of the template can have to be considered a valid match. This value can range from 0 to 1000. A score of 1000 indicates a perfect match.
Rotated When enabled, the step searches for the template image within the angle range you specify. When disabled, this function searches for the image regardless of shifting along the x-axis and y-axis.
Scaled When enabled, the step searches for a template image that may be scaled in the inspection image.
Occluded When enabled, the step searches for a template image that may be occluded in the inspection image.
Matches Displays the following information after searching the image for the template:
Property Description
Score Score of each valid match. Score values can range from 0 to 1000. A score of 1000 indicates a perfect match.
X Position X-coordinate of each object that matches the template.
Y Position Y-coordinate of each object that matches the template.
Angle Rotation angle, in degrees, of each object that matches the template at the current match location. This output is valid only when you enable the Rotated control on the Settings tab.
Scale The percent change in scale of the object found in the image relative to the template.
Occlusion % The amount of occlusion for each object that matches the template.
Template Target Curve Score Specifies how closely the curves in the template match the curves in the match region of the inspection image. Score values can range from 0 to 1000. A score of 1000 indicates that all template curves have a corresponding curve in the match region of the inspection image.
Correlation Score Specifies how closely a match matches the template using a correlation metric that compares the two regions as a function of their pixel values.

Limits Tab

The following controls are available on the Limits tab.

Control Name Description
Minimum Number of Matches Minimum number of matches you expect the step to find.
Maximum Number of Matches Maximum number of matches you expect the step to find.
Number of Matches Found Number of matches the step found.
Matches Displays the following information after searching the image for the template:
Property Description
Score Score of each valid match. Score values can range from 0 to 1000. A score of 1000 indicates a perfect match.
X Position X-coordinate of each object that matches the template.
Y Position Y-coordinate of each object that matches the template.
Angle Rotation angle, in degrees, of each object that matches the template at the current match location. This output is valid only when you enable the Rotated control on the Settings tab.
Scale The percent change in scale of the object found in the image relative to the template.
Occlusion % The amount of occlusion for each object that matches the template.
Template Target Curve Score Specifies how closely the curves in the template match the curves in the match region of the inspection image. Score values can range from 0 to 1000. A score of 1000 indicates that all template curves have a corresponding curve in the match region of the inspection image.
Correlation Score Specifies how closely a match matches the template using a correlation metric that compares the two regions as a function of their pixel values.