Table Of Contents

Compare Golden Template (G Dataflow)

Last Modified: October 26, 2017

Compares an image to a template image at a given alignment.

connector_pane_image
datatype_icon

image in

Reference to the image to compare to the golden template.

If neither bright (or both) defect image dst out or dark defect image dst out is connected, image in is used as the destination image for both bright and dark defects.

datatype_icon

template image

Reference to the golden template image to compare against the image.

datatype_icon

bright (or both) defect image dst in

Reference to the destination image for bright defects, or both kinds of defects if the same image is also connected to dark defect image dst in.

datatype_icon

dark defect image dst in

Reference to the destination image for dark defects.

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

inspection options

Cluster specifying the golden template comparison.

datatype_icon

registration method

Input that specifies if the node registers the golden template to the image.

datatype_icon

normalization method

Input that specifies how the node normalizes the golden template to the image.

Name Value Description
none 0

Specifies no normalization.

histogram 1

Specifies that the histogram of the image is normalized to match the histogram of the template image.

average matching 2

Specifies that the mean pixel value of the image is normalized to match the mean pixel value of the template image.

datatype_icon

edge thickness to ignore

Desired thickness of edges to be ignored.

A value of 0 specifies that the algorithm will not ignore edges.

datatype_icon

bright threshold

Threshold for regions where the image is brighter than the golden template.

Pixels that exceed the specified threshold value are assigned a pixel value of 2 in the bright (or both) defect image dst out image.

datatype_icon

dark threshold

Threshold for regions where the image is darker than the golden template.

Pixels that exceed the specified threshold value are assigned a pixel value of 1 in the dark defect image dst out or bright (or both) defect image dst out image.

datatype_icon

grayscale/ binary?

Boolean that specifies how to return the result of the golden template comparison.

  • grayscale—Returns the grayscale image that results from subtracting the golden template image from the inspection image. If you select to return a grayscale image, values specified for bright threshold and/or dark threshold are ignored.
  • binary—Returns the binary image that results from subtracting the golden template image from the inspection image, then thresholding the image according to the values specified by bright threshold and dark threshold.
datatype_icon

alignment options

Area within the image that is compared to the golden template.

datatype_icon

position

Location of the center of the golden template in the image under inspection.

datatype_icon

angle

Rotation, in degrees, of the golden template in the image under inspection.

datatype_icon

scale

Percentage of the size of the area under inspection compared to the size of the golden template.

datatype_icon

image out

Reference to the source image.

datatype_icon

bright (or both) defect image dst out

Reference to the destination image for bright defects, or both kinds of defects if the same image is also connected to dark defect image dst in.

datatype_icon

dark defect image dst out

Reference to the destination image for dark defects.

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