FitPathToRidges3D


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

Applications:Tracing of a thin line, whose rough location is known beforehand.

Syntax

C++
C#
Python
 
def FitPathToRidges3D(
	inSurface: Surface,
	inFittingMap: PathFittingMap,
	inRidgeScanParams: RidgeScanParams3D,
	inRidgeSelection: Selection,
	inMaxIncompleteness: float,
	/,
	*,
	inLocalBlindness: LocalBlindness | None = None,
	inMaxProfileGapWidth: int | None = 1,
	inMaxPathInterpolationLength: int | None = None,
	inMaxDeviationDelta: float | None = None
)
-> (
	outPath: list[Point3D] | None,
	outRidges: list[SurfaceRidge1D | 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 inRidgeScanParams RidgeScanParams3D Parameters controlling the ridge extraction process
Input value inRidgeSelection Selection Selection mode of ridges
Input value inLocalBlindness LocalBlindness | None None Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges
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 ridge points not found
Output value outPath list[Point3D] | None Fitted path or nothing if the fitting failed
Output value outRidges list[SurfaceRidge1D | None] Found ridges
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 ridge 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.