Match Geometric Pattern 1 (G Dataflow)

Download Manual | Offline Viewer Required

Version:

Last Modified: June 25, 2019

Searches for a pattern, or template image, in the inspection image.

image in

Reference to the template image for which you want to search in the inspection image.

template image

Reference to the geometric template to search during the matching phase.

The template image is an output of the Learn Geometric Pattern node.

ROI descriptor

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.

Global Rectangle

Coordinates of the bounding rectangle.

Contours

Individual shapes that define an ROI.

ID

Object specifying if contour is the external or internal edge of an ROI.

Type

Shape type of the contour.

Coordinates

Relative position of the contour.

match geometric pattern 1 setup data in

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 in

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.

error in does not contain an error	error in contains an error

If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

number of matches requested

Number of valid matches expected.

minimum match score

Smallest score a match can have to be considered valid.

The data range for a match is between 0 and 1000.

image out

Reference to the source image.

matches (pixel)

Information about a match found in the image.

Position

Point-coordinate cluster corresponding to the location of the template origin.

Angle

Rotation angle, in degrees, of the template at the current match location.

Scale

Ratio of the size of the matched template relative to the original template image, expressed as a percentage.

Score

Input that ranks the match results on a scale of 0 to 1000, where 0 equals no match and 1000 equals a perfect match.

Bounding Box

Array of five points that define the boundary of the template.

Contrast Reversed

Boolean value that specifies whether the match is an inverse of the template image.

TRUE	Match is an inverse of the template image.
FALSE	Match is not the inverse of the template image.

Occlusion %

Percentage of the match that is occluded.

Template Target Curve Score

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.

Target Template Curve Score

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.

Correlation Score

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.

matches (real-world)

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.