You are here: Start » FIL.NET » Invoke.FitCircleToEdges3D

Invoke.FitCircleToEdges3D

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

Namespace:Fil
Assembly:FilNet.dll

Syntax

C++
C#
 
public static void FitCircleToEdges3D
(
	Fil.Surface inSurface,
	Fil.CircleFittingMap inFittingMap,
	Fil.EdgeScanParams3D inEdgeScanParams,
	Fil.Selection inEdgeSelection,
	Optional<Fil.LocalBlindness> inLocalBlindness,
	Optional<int> inMaxProfileGapWidth,
	float inMaxIncompleteness,
	Fil.CircleFittingMethod inFittingMethod,
	Optional<Fil.MEstimator> inOutlierSuppression,
	Conditional<Fil.Circle3D> outCircle,
	Optional<List<Conditional<Fil.SurfaceEdge1D>>> outEdges,
	Optional<Conditional<Fil.Profile>> outDeviationProfile,
	Optional<List<Fil.Point3D>> outInliers,
	Optional<List<Fil.Profile>> outHeightProfiles,
	Optional<List<Fil.Profile>> outResponseProfiles
)

Parameters

Name Type Range Default Description
inSurfaceFil.SurfaceSurface to fit the circle to.
inFittingMapFil.CircleFittingMapInput fitting map.
inEdgeScanParamsFil.EdgeScanParams3DParameters controlling the edge extraction process.
inEdgeSelectionFil.Selectionfil::SelectionBestSelection mode of edges. Default value: fil::SelectionBest.
inLocalBlindnessFtl.Optional<Fil.LocalBlindness>Defines conditions in which weaker edges can be detected in the vicinity of stronger edges. Default value: ftl::NIL.
inMaxProfileGapWidthFtl.Optional<int><0, INF>1Maximal number of consecutive not existing profile points. Default value: 1.
inMaxIncompletenessfloat<0.0f, 0.999f>0.1fMaximal fraction of edge points not found. Default value: 0.1f.
inFittingMethodFil.CircleFittingMethodAlgebraicTaubinMethod used to fit a circle. Default value: AlgebraicTaubin.
inOutlierSuppressionFtl.Optional<Fil.MEstimator>Selects a method for ignoring incorrectly detected points. Default value: ftl::NIL.
outCircleFtl.Conditional<Fil.Circle3D>Fitted circle or nothing if the fitting fails.
outEdgesFtl.Optional<System.Collections.Generic.List<Ftl.Conditional<Fil.SurfaceEdge1D>>>Found edges.
outDeviationProfileFtl.Optional<Ftl.Conditional<Fil.Profile>>Profile of distances between the actual circle points and the corresponding reference circle points.
outInliersFtl.Optional<System.Collections.Generic.List<Fil.Point3D>>Points matching the fitting Circle.
outHeightProfilesFtl.Optional<System.Collections.Generic.List<Fil.Profile>>Extracted surface height profiles.
outResponseProfilesFtl.Optional<System.Collections.Generic.List<Fil.Profile>>Profiles of the edge (derivative) operator response.

See also