You are here: Start » AVL.NET » Invoke.FitSegmentToRidges3D_Direct

Invoke.FitSegmentToRidges3D_Direct

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

Namespace:Avl
Assembly:AvlNet.dll

Syntax

C++
C#
 
public static void FitSegmentToRidges3D_Direct
(
	Avl.Surface inSurface,
	Avl.SegmentFittingField inFittingField,
	Optional<Avl.CoordinateSystem2D> inFittingFieldAlignment,
	int inScanCount,
	Optional<float> inSamplingStep,
	int inScanWidth,
	Avl.InterpolationMethod inSurfaceInterpolation,
	Avl.RidgeScanParams3D inRidgeScanParams,
	Avl.Selection inRidgeSelection,
	Optional<Avl.LocalBlindness> inLocalBlindness,
	Optional<int> inMaxProfileGapWidth,
	float inMaxIncompleteness,
	Optional<Avl.MEstimator> inOutlierSuppression,
	Conditional<Avl.Segment3D> outSegment,
	Optional<List<Conditional<Avl.SurfaceRidge1D>>> outRidges,
	Optional<Conditional<Avl.Profile>> outDeviationProfile,
	Optional<Avl.SegmentFittingField> outAlignedFittingField,
	Optional<List<Avl.Point3D>> outInliers,
	Optional<List<Avl.Profile>> outHeightProfiles,
	Optional<List<Avl.Profile>> outResponseProfiles,
	Diagnostic<List<Avl.Segment2D>> diagScanSegments,
	Diagnostic<List<Avl.Rectangle2D>> diagSamplingAreas
)

Parameters

Name Type Range Default Description
inSurfaceAvl.SurfaceSurface to fit the segment to.
inFittingFieldAvl.SegmentFittingFieldSegment fitting field.
inFittingFieldAlignmentAtl.Optional<Avl.CoordinateSystem2D>Adjusts the fitting field to the position of the inspected object. Default value: atl::NIL.
inScanCountint<3, INF>10The number of points that will be searched to estimate the position of the segment. Default value: 10.
inSamplingStepAtl.Optional<float><0.0f, INF>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.
inSurfaceInterpolationAvl.InterpolationMethodBilinearInterpolation method used for extraction of surface points. Default value: Bilinear.
inRidgeScanParamsAvl.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 ).
inRidgeSelectionAvl.SelectionSelection mode of ridges.
inLocalBlindnessAtl.Optional<Avl.LocalBlindness>Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges. Default value: atl::NIL.
inMaxProfileGapWidthAtl.Optional<int><0, INF>1Maximal number of consecutive not existing profile points. Default value: 1.
inMaxIncompletenessfloat<0.0f, 0.999f>0.1fMaximal fraction of ridge points not found. Default value: 0.1f.
inOutlierSuppressionAtl.Optional<Avl.MEstimator>Selects a method for ignoring incorrectly detected points. Default value: atl::NIL.
outSegmentAtl.Conditional<Avl.Segment3D>Fitted segment or nothing if the fitting fails.
outRidgesAtl.Optional<System.Collections.Generic.List<Atl.Conditional<Avl.SurfaceRidge1D>>>Found ridges.
outDeviationProfileAtl.Optional<Atl.Conditional<Avl.Profile>>Profile of distances between the actual segment points and the corresponding reference segment points.
outAlignedFittingFieldAtl.Optional<Avl.SegmentFittingField>Fitting field used; in the image coordinate system.
outInliersAtl.Optional<System.Collections.Generic.List<Avl.Point3D>>Points matching the fitting segment.
outHeightProfilesAtl.Optional<System.Collections.Generic.List<Avl.Profile>>Extracted surface height profiles.
outResponseProfilesAtl.Optional<System.Collections.Generic.List<Avl.Profile>>Profiles of the ridge operator response.
diagScanSegmentsAvl.Diagnostic<System.Collections.Generic.List<Avl.Segment2D>>Segments along which the scans were run.
diagSamplingAreasAvl.Diagnostic<System.Collections.Generic.List<Avl.Rectangle2D>>Areas from which the input image is sampled.

See also