You are here: Start » AVL.NET » AVS.AvsFilter_FitCircleToRidges3D Method

AVS.AvsFilter_FitCircleToRidges3D Method

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

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void AvsFilter_FitCircleToRidges3D
(
	AvlNet.CircleFitting3DState ioState,
	AvlNet.Surface inSurface,
	AvlNet.CircleFittingField inFittingField,
	int inScanCount,
	int inScanWidth,
	AvlNet.InterpolationMethod inSurfaceInterpolation,
	AvlNet.RidgeScanParams3D inRidgeScanParams,
	AvlNet.Selection inRidgeSelection,
	float inMaxIncompleteness,
	AvlNet.CircleFittingMethod inFittingMethod,
	INullable<AvlNet.Circle3D> outCircle,
	NullableRef<List<AvlNet.SurfaceRidge1D?>> outRidges,
	NullableRef<NullableRef<AvlNet.Profile>> outDeviationProfile,
	NullableValue<AvlNet.CircleFittingField> outAlignedFittingField,
	NullableRef<List<AvlNet.Point3D>> outInliers,
	IList<AvlNet.Segment2D> diagScanSegments,
	IList<AvlNet.Rectangle2D> diagSamplingAreas,
	IList<AvlNet.Profile> diagHeightProfiles,
	IList<AvlNet.Profile> diagResponseProfiles
)

Parameters

Name Type Range Default Description
ioStateAvlNet.CircleFitting3DState
inSurfaceAvlNet.SurfaceSurface to fit the circle to.
inFittingFieldAvlNet.CircleFittingFieldCircle fitting field.
inScanCountint<3, INF>10The number of points that will be searched to estimate the position of the circle. Default value: 10.
inScanWidthint<1, INF>5The width of each scan field (in pixels). Default value: 5.
inSurfaceInterpolationAvlNet.InterpolationMethodBilinearInterpolation method used for extraction of surface points. Default value: Bilinear.
inRidgeScanParamsAvlNet.RidgeScanParams3DRidgeScanParams3D ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 0.6f RidgeWidth: 5.0f RidgeMargin: 2.0f RidgeOperator: Minimum MinMagnitude: 5.0f RidgePolarity: Low )Parameters controlling the ridge extraction process. Default value: RidgeScanParams3D ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 0.6f RidgeWidth: 5.0f RidgeMargin: 2.0f RidgeOperator: Minimum MinMagnitude: 5.0f RidgePolarity: Low ).
inRidgeSelectionAvlNet.SelectionSelection mode of ridges.
inMaxIncompletenessfloat<0.0f, 0.999f>0.1fMaximal fraction of ridge points not found. Default value: 0.1f.
inFittingMethodAvlNet.CircleFittingMethodAlgebraicTaubinMethod used to fit a circle. Default value: AlgebraicTaubin.
outCircleAvlNet.INullable<AvlNet.Circle3D>Fitted circle or nothing if the fitting fails. This parameter cannot be null.
outRidgesAvlNet.NullableRef<System.Collections.Generic.List<AvlNet.SurfaceRidge1D?>>Found ridges. Can be null to skip this parameter calculation.
outDeviationProfileAvlNet.NullableRef<AvlNet.NullableRef<AvlNet.Profile>>Profile of distances between the actual circle points and the corresponding reference circle points. Can be null to skip this parameter calculation.
outAlignedFittingFieldAvlNet.NullableValue<AvlNet.CircleFittingField>Fitting field used; in the image coordinate system. Can be null to skip this parameter calculation.
outInliersAvlNet.NullableRef<System.Collections.Generic.List<AvlNet.Point3D>>Points matching the fitting Circle. Can be null to skip this parameter calculation.
diagScanSegmentsSystem.Collections.Generic.IList<AvlNet.Segment2D>Segments along which the scans were run.
diagSamplingAreasSystem.Collections.Generic.IList<AvlNet.Rectangle2D>Areas from which the input image is sampled.
diagHeightProfilesSystem.Collections.Generic.IList<AvlNet.Profile>Extracted surface height profiles.
diagResponseProfilesSystem.Collections.Generic.IList<AvlNet.Profile>Profiles of the ridge operator response.

Function Overrides

See also