LocateMultipleObjects_Elastic


Finds all occurrences of a predefined template on an image by comparing object edges.

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

Syntax

C++
C#
Python
 
def LocateMultipleObjects_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,
	outAlignedSearchRegion: ShapeRegion | None = None
)
-> (
	outObjects: list[Object2D],
	outObjectEdges: list[ list[Path] ]
)

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.1 - 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 outObjects list[Object2D] Found objects
Output value outObjectEdges list[ list[Path] ] Model edges of the found objects
Output value outAlignedSearchRegion ShapeRegion | None None Transformed input shape region

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.