LocateSingleObject_Elastic


Finds a single occurrence of a predefined template on an image by comparing object edges.

Applications:Detection of an object whose outlines are sharp and rigid. Often one of the first filters in a program.

Syntax

C++
C#
Python
 
def LocateSingleObject_Elastic(
	inImage: Image,
	inEdgeModel: EdgeModel_Elastic,
	inEdgeThreshold: float,
	inMinScore: float,
	/,
	*,
	inSearchRegion: ShapeRegion | None = None,
	inSearchRegionAlignment: CoordinateSystem2D | None = None,
	inDetectionStrategy: ElasticMatchingDetectionStrategy = ElasticMatchingDetectionStrategy.Fast,
	inMinAspectRatio: float = 1.0,
	inMaxAspectRatio: float = 1.0
)
-> (
	outObject: Object2D | None,
	outObjectEdges: list[Path] | None
)

Parameters

Name Type Range Default Description
Input value inImage Image Image on which object occurrences will be searched
Input value inSearchRegion ShapeRegion | None None Region of possible object centers
Input value inSearchRegionAlignment CoordinateSystem2D | None None Adjusts the region of interest to the position of the inspected object
Input value inEdgeModel EdgeModel_Elastic Model of objects to be searched
Input value inDetectionStrategy ElasticMatchingDetectionStrategy ElasticMatchingDetectionStrategy.Fast Specifies initial candidates detection mode
Input value inEdgeThreshold float 0.01 - Minimum strength of edges used for matching with the model
Input value inMinAspectRatio float 0.5 - 2.0 1.0 Minimum expected aspect ratio of object occurrence being found
Input value inMaxAspectRatio float 0.5 - 2.0 1.0 Maximum expected aspect ratio of object occurrence being found
Input value inMinScore float 0.0 - 1.0 Minimum score of an object occurrence
Output value outObject Object2D | None Found object
Output value outObjectEdges list[Path] | None Model edges of the found object

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.