You are here: Start » AVL.NET » Function Reference » Surface » Surface Fitting » AVL.FitCircleToSurfaceHole

AVL.FitCircleToSurfaceHole

Fits a circle to a hole in a surface plane.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void FitCircleToSurfaceHole
(
	AvlNet.Surface inSurface,
	NullableRef<AvlNet.Region> inRoi,
	AvlNet.MEstimator inPlaneOutlierSuppression,
	float inClippingFactor,
	int inIterationCount,
	AvlNet.Plane3D? inInitialPlane,
	AvlNet.CircleFittingMethod inCircleFittingMethod,
	AvlNet.MEstimator? inCircleOutlierSuppression,
	INullable<AvlNet.Circle3D> outCircle3D,
	out AvlNet.Plane3D outPlane,
	NullableRef<List<AvlNet.Point3D>> outInliers,
	NullableRef<List<float>> outDistances,
	NullableValue<float> outSignedDistanceSum,
	NullableValue<float> outDistanceSum,
	NullableRef<List<float>> outSquaredDistances,
	NullableValue<float> outSquaredDistanceSum
)

Parameters

Name Type Range Default Description
inSurfaceAvlNet.SurfaceInput surface.
inRoiAvlNet.NullableRef<AvlNet.Region>Region of interest. Default value: atl::NIL.
inPlaneOutlierSuppressionAvlNet.MEstimatorSelects a method for ignoring points not lying on the fitted plane.
inClippingFactorfloat<0.675f, 6.0f>2.5fMultitude of standard deviation within which points are considered inliers. Default value: 2.5f.
inIterationCountint<0, INF>5Number of iterations of outlier suppressing algorithm. Default value: 5.
inInitialPlaneAvlNet.Plane3D?Initial approximation of a plane (if available). Default value: atl::NIL.
inCircleFittingMethodAvlNet.CircleFittingMethodSelect a method for fitting a circle to a set of points.
inCircleOutlierSuppressionAvlNet.MEstimator?Selects a method for ignoring points not lying on the fitted circle. Default value: atl::NIL.
outCircle3DAvlNet.INullable<AvlNet.Circle3D>Circle fitted to a surface hole. This parameter cannot be null.
outPlaneAvlNet.Plane3DPlane fitted to the surface points.
outInliersAvlNet.NullableRef<System.Collections.Generic.List<AvlNet.Point3D>>Points matching the computed plane. Can be null to skip this parameter calculation.
outDistancesAvlNet.NullableRef<System.Collections.Generic.List<float>>Distances of the input surface points to a resulting plane. Can be null to skip this parameter calculation.
outSignedDistanceSumAvlNet.NullableValue<float>Sum of signed distances of the input surface points to a resulting plane. Can be null to skip this parameter calculation.
outDistanceSumAvlNet.NullableValue<float>Sum of distances of the input surface points to a resulting plane. Can be null to skip this parameter calculation.
outSquaredDistancesAvlNet.NullableRef<System.Collections.Generic.List<float>>Squared distances of the input surface points to a resulting plane. Can be null to skip this parameter calculation.
outSquaredDistanceSumAvlNet.NullableValue<float>Sum of squared distances of the input surface points to a resulting plane. Can be null to skip this parameter calculation.

Errors

List of possible exceptions:

Error type Description
DomainError Region of interest exceeds an input surface in FitCircleToSurfaceHole.

Function Overrides

See also