Searches for a pattern, or template image, in the inspection image.
Reference to the template image for which you want to search in the inspection image.
Reference to the geometric template to search during the matching phase.
The template image is an output of the Learn Geometric Pattern node.
Region of the inspection image in which to perform geometric matching.
This region must be a single rectangle or rotated rectangle contour. By default, the node uses the entire inspection image for matching.
Coordinates of the bounding rectangle.
Individual shapes that define an ROI.
Object specifying if contour is the external or internal edge of an ROI.
Shape type of the contour.
Relative position of the contour.
String that contains information from the Setup Match Geometric Pattern 1 node or the Advanced Setup Match Geometric Pattern 1 node..
If this input is not connected, the node uses default parameters for all unconfigured options.
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Default: No error
Number of valid matches expected.
Smallest score a match can have to be considered valid.
The data range for a match is between 0 and 1000.
Reference to the source image.
Information about a match found in the image.
Point-coordinate cluster corresponding to the location of the template origin.
Rotation angle, in degrees, of the template at the current match location.
Ratio of the size of the matched template relative to the original template image, expressed as a percentage.
Input that ranks the match results on a scale of 0 to 1000, where 0 equals no match and 1000 equals a perfect match.
Array of five points that define the boundary of the template.
Percentage of the match that is occluded.
Input that specifies how closely the curves in the match region of the inspection, or target, image match the curves in the template.
Score values can range from 0 to 1000, where a score of 1000 indicates that all template curves have a corresponding curve in the match region of the inspection image.
Input that specifies how closely the curves in the match region of the inspection, or target, image match the curves in the template.
Score values can range from 0 to 1000, where a score of 1000 indicates that all curves in the match region of the inspection image have a corresponding curve in the template image. The node does not compute the Target Template Curve Score by default. Use the Advanced Setup Match Geometric Pattern node to configure the algorithm to compute this value.
Accuracy of the match obtained by comparing the template image to the match region using a correlation metric that compares the two regions as a function of their pixel values.
A score of 1000 indicates a perfect match, and a score of 0 indicates no match.
Information about a match found in the image.
matches (real-world) can differ from matches (pixel) if image is a calibrated image. If image is a calibrated image, Position, Angle, and Bounding Box are returned in real-world units.
Point-coordinate cluster corresponding to the location of the template origin.
Rotation angle, in degrees, of the template at the current match location.
Ratio of the size of the matched template relative to the original template image, expressed as a percentage.
Input that ranks the match results on a scale of 0 to 1000, where 0 equals no match and 1000 equals a perfect match.
Array of five points that define the boundary of the template.
Percentage of the match that is occluded.
Input that specifies how closely the curves in the match region of the inspection, or target, image match the curves in the template.
Score values can range from 0 to 1000, where a score of 1000 indicates that all template curves have a corresponding curve in the match region of the inspection image. The node does not compute the Target Template Curve Score by default. Use the Advanced Setup Match Geometric Pattern node to configure the algorithm to compute this value.
Input that specifies how closely the curves in the match region of the inspection, or target, image match the curves in the template.
Score values can range from 0 to 1000, where a score of 1000 indicates that all curves in the match region of the inspection image have a corresponding curve in the template image. The node does not compute the Target Template Curve Score by default. Use the Advanced Setup Match Geometric Pattern node to configure the algorithm to compute this value.
Accuracy of the match obtained by comparing the template image to the match region using a correlation metric that compares the two regions as a function of their pixel values.
A score of 1000 indicates a perfect match, and a score of 0 indicates no match.
Number of template matches found in the inspection image based on the input settings.
Error information.
The node produces this output according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Use one of the following methods to configure the template image for use with this node.
Where This Node Can Run:
Desktop OS: Windows
FPGA: Not supported
Web Server: Not supported in VIs that run in a web application