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

AVS.AvsFilter_FitPathToRidges3D Method

Performs a series of 1D ridge detections in 3D and creates a path from the detected points.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void AvsFilter_FitPathToRidges3D
(
	AvlNet.PathFitting3DState ioState,
	AvlNet.Surface inSurface,
	AvlNet.PathFittingField inFittingField,
	AvlNet.CoordinateSystem2D? inFittingFieldAlignment,
	float? inScanStep,
	float? inSamplingStep,
	int inScanWidth,
	AvlNet.InterpolationMethod inSurfaceInterpolation,
	AvlNet.RidgeScanParams3D inRidgeScanParams,
	AvlNet.Selection inRidgeSelection,
	AvlNet.LocalBlindness? inLocalBlindness,
	int? inMaxProfileGapWidth,
	int? inMaxPathInterpolationLength,
	float? inMaxDeviationDelta,
	float inMaxIncompleteness,
	INullable<List<AvlNet.Point3D>> outPath,
	NullableRef<List<AvlNet.SurfaceRidge1D?>> outRidges,
	NullableRef<NullableRef<AvlNet.Profile>> outDeviationProfile,
	NullableRef<AvlNet.PathFittingField> outAlignedFittingField
)

Parameters

Name Type Range Default Description
ioStateAvlNet.PathFitting3DState
inSurfaceAvlNet.SurfaceSurface to fit the path to.
inFittingFieldAvlNet.PathFittingFieldPath fitting field.
inFittingFieldAlignmentAvlNet.CoordinateSystem2D?Adjusts the fitting field to the position of the inspected object. Default value: atl::NIL.
inScanStepfloat?<0.0f, INF>5.0fOptional implicit conversion of the input path to an equidistant one. Default value: 5.0f.
inSamplingStepfloat?Desired distance between consecutive sampling points on the scan segments; if Nil, the bigger of surface X and Y scales is chosen. Default value: atl::NIL.
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.
inLocalBlindnessAvlNet.LocalBlindness?Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges. Default value: atl::NIL.
inMaxProfileGapWidthint?<0, INF>1Maximal number of consecutive not existing profile points. Default value: 1.
inMaxPathInterpolationLengthint?<0, INF>1Maximal number of consecutive points not found. Default value: 1.
inMaxDeviationDeltafloat?<0.0f, INF>Maximal difference between deviations of consecutive path points. Default value: atl::NIL.
inMaxIncompletenessfloat<0.0f, 0.999f>0.1fMaximal fraction of ridge points not found. Default value: 0.1f.
outPathAvlNet.INullable<System.Collections.Generic.List<AvlNet.Point3D>>Fitted path or nothing if the fitting failed. 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 path points and the corresponding reference path points. Can be null to skip this parameter calculation.
outAlignedFittingFieldAvlNet.NullableRef<AvlNet.PathFittingField>Fitting field used; in the image coordinate system. Can be null to skip this parameter calculation.

Function Overrides

See also