FitCircleToRidges3D


Performs a series of 1D ridge detections and finds a circle that best matches the detected points.

Applications:Precise detection of a circular object or hole, whose rough location is known beforehand.

Syntax

C++
C#
Python
 
def FitCircleToRidges3D(
	inSurface: Surface,
	inFittingMap: CircleFittingMap,
	inRidgeScanParams: RidgeScanParams3D,
	inRidgeSelection: Selection,
	inMaxIncompleteness: float,
	inFittingMethod: CircleFittingMethod,
	/,
	*,
	inLocalBlindness: LocalBlindness | None = None,
	inMaxProfileGapWidth: int | None = 1,
	inOutlierSuppression: MEstimator | None = None
)
-> (
	outCircle: Circle3D | None,
	outRidges: list[SurfaceRidge1D | None],
	outDeviationProfile: Profile | None,
	outInliers: list[Point3D],
	outHeightProfiles: list[Profile],
	outResponseProfiles: list[Profile]
)

Parameters

Name Type Range Default Description
Input value inSurface Surface Surface to fit the circle to
Input value inFittingMap CircleFittingMap 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 inMaxIncompleteness float 0.0 - 0.999 Maximal fraction of ridge points not found
Input value inFittingMethod CircleFittingMethod Method used to fit a circle
Input value inOutlierSuppression MEstimator | None None Selects a method for ignoring incorrectly detected points
Output value outCircle Circle3D | None Fitted circle or nothing if the fitting fails
Output value outRidges list[SurfaceRidge1D | None] Found ridges
Output value outDeviationProfile Profile | None Profile of distances between the actual circle points and the corresponding reference circle points
Output value outInliers list[Point3D] Points matching the fitting Circle
Output value outHeightProfiles list[Profile] Extracted surface height profiles
Output value outResponseProfiles list[Profile] Profiles of the ridge operator response

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.