CreateEdgeModel1


Creates a model for edge-based template matching.

Applications:Dynamic creation of models in the runtime environment (normally they are created interactively in Studio).

Syntax

C++
C#
Python
 
def CreateEdgeModel1(
	inImage: Image,
	/,
	*,
	inTemplateRegion: Region | None = None,
	inReferenceFrame: Rectangle2D | None = None,
	inMinPyramidLevel: int = 0,
	inMaxPyramidLevel: int | None = None,
	inSmoothingStdDev: float = 0.0,
	inEdgeThreshold: float = 35.0,
	inEdgeHysteresis: float = 15.0,
	inMinAngle: float = -180.0,
	inMaxAngle: float = 180.0,
	inAnglePrecision: float = 1.0,
	inMinScale: float = 1.0,
	inMaxScale: float = 1.0,
	inScalePrecision: float = 1.0,
	inEdgeCompleteness: float = 1.0
)
-> (
	outEdgeModel: EdgeModel | None,
	outEdgeModelPoint: Point2D | None,
	outEdges: list[Path] | None,
	diagEdgePyramid: list[Image] | None
)

Parameters

Name Type Range Default Description
Input value inImage Image Image from which model will be extracted
Input value inTemplateRegion Region | None None Region of the image from which model will be extracted
Input value inReferenceFrame Rectangle2D | None None Exact position of the model object in the image
Input value inMinPyramidLevel int 0 - 12 0 Defines the index of the lowest reduced resolution level used to speed up computations
Input value inMaxPyramidLevel int | None 0 - 12 None Defines the number of reduced resolution levels used to speed up computations
Input value inSmoothingStdDev float 0.0 - 0.0 Standard deviation of the gaussian smoothing applied before edge extraction
Input value inEdgeThreshold float 0.0 - 35.0 Higher threshold for edge magnitude
Input value inEdgeHysteresis float 0.0 - 15.0 Threshold hysteresis value for edge magnitude
Input value inMinAngle float -180.0 Start of range of possible rotations
Input value inMaxAngle float 180.0 End of range of possible rotations
Input value inAnglePrecision float 0.001 - 10.0 1.0 Defines angular resolution of the matching process
Input value inMinScale float 0.0 - 1.0 Start of range of possible scales
Input value inMaxScale float 0.0 - 1.0 End of range of possible scales
Input value inScalePrecision float 0.001 - 10.0 1.0 Defines scale resolution of the matching process
Input value inEdgeCompleteness float 0.01 - 1.0 1.0 Determines what fraction of the edges will be present in the created model
Output value outEdgeModel EdgeModel | None Created model that can be used by LocateMultipleObjects_Edges
Output value outEdgeModelPoint Point2D | None The middle point of the created model
Output value outEdges list[Path] | None Visualization of the model edges found at the original resolution
Diagnostic input diagEdgePyramid list[Image] | None Visualization of the edges found at different resolution levels

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.