FitPathToEdges3D


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 FitPathToEdges3D(
	inSurface: Surface,
	inFittingMap: PathFittingMap,
	inEdgeScanParams: EdgeScanParams3D,
	inEdgeSelection: Selection,
	inMaxIncompleteness: float,
	/,
	*,
	inLocalBlindness: LocalBlindness | None = None,
	inMaxProfileGapWidth: int | None = 1,
	inMaxPathInterpolationLength: int | None = None,
	inMaxDeviationDelta: float | None = None
)
-> (
	outPath: list[Point3D] | None,
	outEdges: list[SurfaceEdge1D | None],
	outDeviationProfile: Profile | None,
	outHeightProfiles: list[Profile],
	outResponseProfiles: list[Profile],
	outPathSegments: list[Segment3D] | None
)

Parameters

Name Type Range Default Description
Input value inSurface Surface Surface to fit the path to
Input value inFittingMap PathFittingMap Input fitting map
Input value inEdgeScanParams EdgeScanParams3D 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 inMaxProfileGapWidth int | None 0 - 1 Maximal number of consecutive not existing profile points
Input value inMaxPathInterpolationLength int | None 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 list[Point3D] | None Fitted path or nothing if the fitting failed
Output value outEdges list[SurfaceEdge1D | None] Found edges
Output value outDeviationProfile Profile | None Profile of distances between the actual path points and the corresponding reference path points
Output value outHeightProfiles list[Profile] Extracted surface height profiles
Output value outResponseProfiles list[Profile] Profiles of the edge (derivative) operator response
Output value outPathSegments list[Segment3D] | None Segments of the fitted path or nothing if the fitting failed

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.