Match Pattern Controls

NI Vision Builder

Check for Presence Locate Features Tab

Match Pattern 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. Portions of the template ignored during matching are shown in red.
Template Size The width and height, in pixels, of the selected template image.
Create Template When clicked, this button launches the template editor. Use the template editor to select a region of the image to become the template. You can also specify areas of the template to ignore.
Edit Template When clicked, this button launches the template editor and allows you to modify an existing template.
Match Offset Specifies the number of pixels you want to shift the focal point of the template from the center of the template. The focal point of the template is the coordinate location of the template match within an inspection image.

Settings Tab

The following controls are available on the Settings tab.

Control Name Description
Number of Matches to Find Specifies the number of matches you expect to find in the image.
Minimum Score Specifies the minimum score an instance of the template can have to be considered a valid match. This value can vary between 0 and 1000. A score of 1000 indicates a perfect match.
Search Level Specifies the thoroughness with which you want to search for template matches. A coarse search is faster but sometimes less accurate than a thorough search. A thorough search is very accurate but takes more time than a coarse search.
Search for Rotated Patterns When enabled, the step searches for the template at all specified angle ranges in the inspection image.
Angle Range (Degrees) Specifies the angles at which you want to search for the template image. The step searches for the template image at angles ranging from the positive angle to the negative angle, as shown in the graph adjacent to this control.
Mirror Angle When enabled, the step searches for the template image in the angle range you specified in Angle Range (degrees) and the mirror of that angle range, as shown in the graph adjacent to this control.

Limits Tab

The following controls are available on the Limits tab.

Note  If you calibrate the image using the Calibrate Image step, X and Y are returned in the calibration unit you specified.
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.
Matches Displays information about the possible matches. Possible matches whose scores are less than Minimum Score appear in a different color with the match number in parentheses.
  • X—X-coordinate position of the match at the focal point.
  • Y—Y-coordinate position of the match at the focal point.
  • Angle—Clockwise angle of the match from the x-axis.
  • Score—Number ranging from 0 to 1000 that indicates how similar a potential match is to the template image. A score of 1000 indicates a perfect match. A score of 0 indicates no match.