FitPathToEdges


Performs a series of 1D edge detections and creates a path from the detected points.

Applications:Tracing of an object contour, whose rough location and shape is known beforehand.

Syntax

C++
C#
Python
 
def FitPathToEdges(
	inImage: Image,
	inFittingMap: PathFittingMap,
	inEdgeScanParams: EdgeScanParams,
	inEdgeSelection: Selection,
	inMaxIncompleteness: float,
	/,
	*,
	inLocalBlindness: LocalBlindness | None = None,
	inMaxInterpolationLength: int | None = None,
	inMaxDeviationDelta: float | None = None
)
-> (
	outPath: Path | None,
	outEdges: list[Edge1D | None],
	outDeviationProfile: Profile | None,
	outBrightnessProfiles: list[Profile],
	outResponseProfiles: list[Profile]
)

Parameters

Name Type Range Default Description
Input value inImage Image Image to fit the path to
Input value inFittingMap PathFittingMap Input fitting map
Input value inEdgeScanParams EdgeScanParams Parameters controlling the edge extraction process
Input value inEdgeSelection Selection Selection mode of edges
Input value inLocalBlindness LocalBlindness | None None Defines conditions in which weaker edges can be detected in the vicinity of stronger edges
Input value inMaxInterpolationLength int | None 0 - None Maximal number of consecutive points not found
Input value inMaxDeviationDelta float | None 0.0 - None Maximal difference between deviations of consecutive path points
Input value inMaxIncompleteness float 0.0 - 0.999 Maximal fraction of edge points not found
Output value outPath Path | None Fitted path or nothing if the fitting failed
Output value outEdges list[Edge1D | None] Found edges
Output value outDeviationProfile Profile | None Profile of distances between the actual path points and the corresponding reference path points
Output value outBrightnessProfiles list[Profile] Extracted image profiles
Output value outResponseProfiles list[Profile] Profiles of the edge (derivative) operator response

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.