Compare Golden Template (G Dataflow)

Download Manual | Offline Viewer Required

Version:

Last Modified: June 25, 2019

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

Inputs/Outputs
Compatibility

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.

template image

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

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.

dark defect image dst in

Reference to the destination image for dark defects.

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

inspection options

Cluster specifying the golden template comparison.

registration method

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

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.

edge thickness to ignore

Desired thickness of edges to be ignored.

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

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.

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.

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.

alignment options

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

position

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

angle

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

scale

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

image out

Reference to the source image.

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.

dark defect image dst out