Table Of Contents

Advanced Match Geometric Pattern (G Dataflow)

Last Modified: June 25, 2019

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

connector_pane_image
datatype_icon

image in

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

datatype_icon

template image

Reference to the template to search during the matching phase.

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

datatype_icon

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.

datatype_icon

Global Rectangle

Coordinates of the bounding rectangle.

datatype_icon

Contours

Individual shapes that define an ROI.

datatype_icon

ID

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

datatype_icon

Type

Shape type of the contour.

datatype_icon

Coordinates

Relative position of the contour.

datatype_icon

match geometric pattern setup data

String that contains information from the Setup Match Geometric Pattern node or the Advanced Setup Match Geometric Pattern node.

The node uses default parameters for all unconfigured options if this input is not connected.

datatype_icon

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

datatype_icon

number of matches

Number of valid matches expected.

datatype_icon

minimum match score

Smallest score a match can have to be considered valid.

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

datatype_icon

array of matched features

Array of a list of geometric features associated with each match returned.

datatype_icon

matched features

List of geometric features associated with a given match.

datatype_icon

feature type

Type of geometric feature.

datatype_icon

feature data

Array that describes the geometric feature.

The elements of this array should be interpreted according to the feature type.

circle
  • element 0—X coordinate of the center of circle
  • element 1—Y coordinate of the center of circle
  • element 2—Radius of circle
ellipse
  • element 0—X coordinate of the center of ellipse
  • element 1—Y coordinate of the center of ellipse
  • element 2—Orientation in degrees of the major axis
  • element 3—The length of the semi-major axis
  • element 4—The length of the semi-minor axis
constant curve
  • element 0—X coordinate of the center of the constant curve
  • element 1—Y coordinate of the center of the constant curve
  • element 2—The starting angle in degrees of the constant curve
  • element 3—The ending angle in degrees of the constant curve
  • element 4—The radius of the circle subtended by the constant curve
rectangle/leg
  • element 0—X coordinate of the location of the center of the rectangle/leg
  • element 1—Y coordinate of the location of the center of the rectangle/leg
  • elements 2 and 3—The first corner point (x, y) of the rectangle/leg
  • elements 4 and 5—The second corner point (x, y) of the rectangle/leg
  • elements 6 and 7—The third corner point (x, y) of the rectangle/leg
  • elements 8 and 9—The fourth corner point (x, y) of the rectangle/leg
  • element 10—The orientation of the rectangle/leg in degrees with respect to the horizontal axis
  • element 11—The width of the rectangle/leg
  • element 12—The height of the rectangle/leg
corner
  • element 0—X coordinate of the corner position
  • element 1—Y coordinate of the corner position
  • element 2—The orientation of the corner
  • element 3—The enclosed angle of the corner
  • element 4—Specifies if the corner is a virtual corner. A value of 0 means that the corner is not a virtual corner. A value of 1 means that the corner is a virtual corner.
parallel line pair
  • elements 0 and 1 —The start point (x, y) of the first line
  • elements 2 and 3—The end point (x, y) of the first line
  • elements 4 and 5—The start point (x, y) of the second line
  • elements 6 and 7—The end point (x, y) of the second line
  • element 8—The orientation in degrees of the parallel line pair with respect to the horizontal axis
  • element 9—The distance of the two lines from one another
parallel line pairs
  • elements 0-9—The first parallel line pair
  • elements 10-19—The second parallel line pair
  • element 20—The orientation in degrees of the pair of parallel line pairs with respect to the horizontal axis
  • element 21—The distance the two parallel line pairs are from one another as measured by the midline of the first to the midline of the second
line
  • elements 0 and 1—The start point (x,y) of the line
  • elements 2 and 3—The end point (x,y) of the line
  • element 4—The length of the line
  • element 5—The orientation in degrees of the line with respect to the horizontal axis
closed curve
  • elements 0 and 1—The center point (x,y) of the closed curve
  • element 2—The arc length of the closed curve element
  • elements 3 and 4—The first of N contour points (x,y) of the closed curve
  • elements 5 and 6—The second of N contour points (x,y) of the closed curve
  • elements k and k+1—The (k-1)/2 contour point (x,y) of the closed curve
  • elements 2*N+1 and 2*N+2—The last of N contour points (x,y) of the closed curve
datatype_icon

matches (pixel)

Information about a match found in the image.

datatype_icon

Position

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

datatype_icon

Angle

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

datatype_icon

Scale

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

datatype_icon

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.

datatype_icon

Bounding Box

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

datatype_icon

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.
datatype_icon

Occlusion %

Percentage of the match that is occluded.

datatype_icon

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.

datatype_icon

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.

datatype_icon

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.

datatype_icon

matches (real-world)

Information about a match found in the image.

matches (real-world) may 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.

datatype_icon

Position

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

datatype_icon

Angle

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

datatype_icon

Scale

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

datatype_icon

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.

datatype_icon

Bounding Box

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

datatype_icon

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.
datatype_icon

Occlusion %

Percentage of the match that is occluded.

datatype_icon

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.

datatype_icon

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.

datatype_icon

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.

datatype_icon

number of matches requested

Number of valid matches expected.

datatype_icon

error out

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.

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.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported

Web Server: Not supported in VIs that run in a web application


Recently Viewed Topics