Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Computer Vision » Image Analysis » CompareGoldenTemplate_Intensity


Module: FoundationPro

Compares an image with a template image considered to have no defects.


Finding general object defects by analyzing brightness deviations from a template image.
Name Type Range Description
inImage Image Input image
inGoldenTemplate GrayGoldenTemplate Golden gray template containing image of an object with no defects
inGoldenTemplateAlignment CoordinateSystem2D* Adjusts the golden template to the position of the inspected object
inMaxDifference Real 0.0 - Maximal allowed difference between corresponding pixels of the input and golden images
inMinDefectRadius Integer 0 - Minimal radius of a defect
outDefects Region Region of detected defects
outDifferenceRegion Region Region of pixels differing too much between the golden image and the input image
outDefectsPresent Bool Flag indicating whether any defects were detected
outEdgeRegion Region Region of pixels that will not be compared
outObjectPosition Rectangle2D Position of the object being compared


This filter compares pixels of the input images against a template image stored in passed inGoldenTemplate input. Then creates a region containing only pixels in which intensity difference is higher than inMaxDifference value as a result. This method is especially useful for finding defects like: smudges, noises and dust particles. It can be used for finding missing holes or changes in complex shapes.

When the defected pixels are found only consistent regions are selected. Minimal radius of accepted region is set in inMinDefectRadius.

You can define a part of an image when defining inGoldenTemplate.

More information about this technique can be found in Machine Vision Guide: Golden Template.


  • A golden template comparison filter should be preceded with filters finding the object in certain location. Most typically we do this with LocateSingleObject_Edges filter.
  • Connect the inImage input with the image containing the object.
  • Select an image with a perfect object and use it to create golden template using the CreateGoldenTemplate_Intensity filter.
  • Set inMaxDifference to a value that assures detection of all true defects and no false ones. Verify this with the outDefects output.
  • Dismiss very small defects by setting inMinDefectRadius.


CompareGoldenTemplate_Intensity performed on sample image. A part of the object is missing – it is marked in blue on the right.


Due to performance, it is recommended to create a template using the CreateGoldenTemplate_Intensity filter outside a main loop of a program. It will create a model only once, instead of each iteration.


This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Input image format is incompatible with golden template image format in CompareGoldenTemplate_Intensity.
DomainError No valid golden template on input in CompareGoldenTemplate_Intensity.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of CompareGoldenTemplate filter group.

See Also

  • CompareGoldenTemplate_Edges – Compares image edges with the edges of a perfect template. Significant differences are considered defects.