Back to FabImage Studio website

You are here: Start » Filter Reference » Computer Vision » Template Matching » LocateSingleObject_NCC_Deprecated

LocateSingleObject_NCC_Deprecated


Module: MatchingBasic

Finds a single occurrence of a predefined template on an image by analysing the normalized correlation between pixel values.

Applications

Detection of an object with blurred or unclear edges. Often one of the first filters in a program.
Name Type Range Description
Input value inImage Image Image on which object occurrence will be searched
Input value inSearchRegion Region* Range of possible object centers
Input value inGrayModel GrayModel Model of objects to be searched
Input value inMinPyramidLevel Integer 0 - 12 Defines the lowest pyramid level at which object position is still refined
Input value inMaxPyramidLevel Integer* 0 - 12 Defines the total number of reduced resolution levels that can be used to speed up computations
Input value inIgnoreBoundaryObjects Bool Flag indicating whether objects crossing image boundary should be ignored or not
Input value inMinScore Real -1.0 - 1.0 Minimum score of object candidates accepted at each pyramid level
Input value inMaxBrightnessRatio Real* 1.0 - Defines the maximal deviation of the mean brightness of the model object and the object present in the image
Input value inMaxContrastRatio Real* 1.0 - Defines the maximal deviation of the brightness standard deviation of the model object and the object present in the image
Output value outObject Object2D? Found object
Output value outPyramidHeight Integer Highest pyramid level used to speed up computations
Diagnostic input diagImagePyramid ImageArray Pyramid of iteratively downsampled input image
Diagnostic input diagMatchPyramid ImageArray Candidate object locations found at each pyramid level
Diagnostic input diagScores RealArray? Scores of the found object at each pyramid level

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of type: UINT8.

This operation is optimized for AVX2 technology for pixels of type: UINT8.

This operation supports automatic parallelization for multicore and multiprocessor systems.

Complexity Level

This filter is available on Basic Complexity Level.