FitCircleToStripe


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

Applications:Precise detection of ring-shaped objects, whose rough location is known beforehand.

Syntax

C++
C#
Python
 
def FitCircleToStripe(
	inImage: Image,
	inFittingMap: CircleFittingMap,
	inStripeScanParams: StripeScanParams,
	inStripeSelection: Selection,
	inMaxIncompleteness: float,
	inFittingMethod: CircleFittingMethod,
	/,
	*,
	inLocalBlindness: LocalBlindness | None = None,
	inOutlierSuppression: MEstimator | None = None
)
-> (
	outCircle: Circle2D | None,
	outInnerCircle: Circle2D | None,
	outOuterCircle: Circle2D | None,
	outStripes: list[Stripe1D | None],
	outStripePoints: list[Point2D],
	outDeviationProfile: Profile | None,
	outBrightnessProfiles: list[Profile],
	outResponseProfiles: list[Profile]
)

Parameters

Name Type Range Default Description
Input value inImage Image Image to fit the circle to
Input value inFittingMap CircleFittingMap Input fitting map
Input value inStripeScanParams StripeScanParams Parameters controlling the stripe extraction process
Input value inStripeSelection Selection Selection mode of stripe
Input value inLocalBlindness LocalBlindness | None None Defines conditions in which weaker edges can be detected in the vicinity of stronger edges
Input value inMaxIncompleteness float 0.0 - 0.999 Maximal fraction of stripe 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 Circle2D | None Fitted circle in the middle of found stripe
Output value outInnerCircle Circle2D | None Fitted inner circle
Output value outOuterCircle Circle2D | None Fitted outer circle
Output value outStripes list[Stripe1D | None] Found stripes
Output value outStripePoints list[Point2D] Extracted points of middle circle of an image stripe
Output value outDeviationProfile Profile | None Profile of distances between the actual circle points and the corresponding reference circle 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.