Table Of Contents

Match Color Pattern (G Dataflow)

Last Modified: June 25, 2019

Searches for a color pattern, or color template image, in the input Image.

Use the Learn Color Pattern node prior to using this node to ensure that the color template image has been configured for the color match stage.

connector_pane_image
datatype_icon

image in

Reference to the color image in which you want to locate the color template image.

datatype_icon

template image

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

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

datatype_icon

optional rectangle

Four-element array that contains the left, top, right, and bottom coordinates of the region to process.

The right and bottom values are exclusive and lie outside the region. The node applies the operation to the entire image if optional rectangle is empty or not connected.

datatype_icon

match color pattern setup data

String that contains information obtained from the Setup Match Color Pattern node.

If this input is not connected, the node uses default parameters during the matching phase.

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 requested

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

image out

Reference to the source image.

datatype_icon

matches

Array of match clusters.

datatype_icon

Position

Point-coordinate cluster corresponding to the center of the template.

datatype_icon

Angle

Rotation angle of the template in the source image at the current match location.

datatype_icon

Scale

Change in percentage size of the matched template from the original template.

This parameter is not used for pattern matching and is always set to 1.

datatype_icon

Score

Match results ranked on a scale of 0 to 1000, where 0 equals no match and 1000 equals a perfect match.

datatype_icon

Bounding Box

Array of points that define the boundary of the template pattern in the image.

Connect this array directly to the Overlay Multiple Lines node to overlay the location of a match on the image.

datatype_icon

number of matches

Number of template matches found in the inspection image based on the input settings.

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