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

Invoke.FitPathToRidges3D_Direct

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

Namespace:Fil
Assembly:FilNet.dll

Syntax

C++
C#
 
public static void FitPathToRidges3D_Direct
(
	Fil.Surface inSurface,
	Fil.PathFittingField inFittingField,
	Optional<Fil.CoordinateSystem2D> inFittingFieldAlignment,
	Optional<float> inScanStep,
	Optional<float> inSamplingStep,
	int inScanWidth,
	Fil.InterpolationMethod inSurfaceInterpolation,
	Fil.RidgeScanParams3D inRidgeScanParams,
	Fil.Selection inRidgeSelection,
	Optional<Fil.LocalBlindness> inLocalBlindness,
	Optional<int> inMaxProfileGapWidth,
	Optional<int> inMaxPathInterpolationLength,
	Optional<float> inMaxDeviationDelta,
	float inMaxIncompleteness,
	Conditional<List<Fil.Point3D>> outPath,
	Optional<List<Conditional<Fil.SurfaceRidge1D>>> outRidges,
	Optional<Conditional<Fil.Profile>> outDeviationProfile,
	Optional<Fil.PathFittingField> outAlignedFittingField,
	Optional<List<Fil.Profile>> outHeightProfiles,
	Optional<List<Fil.Profile>> outResponseProfiles,
	Optional<Conditional<List<Fil.Segment3D>>> outPathSegments,
	Diagnostic<List<Fil.Segment2D>> diagScanSegments,
	Diagnostic<List<Fil.Rectangle2D>> diagSamplingAreas
)

Parameters

Name Type Range Default Description
inSurfaceFil.SurfaceSurface to fit the path to.
inFittingFieldFil.PathFittingFieldPath fitting field.
inFittingFieldAlignmentFtl.Optional<Fil.CoordinateSystem2D>Adjusts the fitting field to the position of the inspected object. Default value: ftl::NIL.
inScanStepFtl.Optional<float><0.0f, INF>5.0fOptional implicit conversion of the input path to an equidistant one. Default value: 5.0f.
inSamplingStepFtl.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: ftl::NIL.
inScanWidthint<1, INF>5The width of each scan field (in pixels). Default value: 5.
inSurfaceInterpolationFil.InterpolationMethodBilinearInterpolation method used for extraction of surface points. Default value: Bilinear.
inRidgeScanParamsFil.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 ).
inRidgeSelectionFil.SelectionSelection mode of ridges.
inLocalBlindnessFtl.Optional<Fil.LocalBlindness>Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges. Default value: ftl::NIL.
inMaxProfileGapWidthFtl.Optional<int><0, INF>1Maximal number of consecutive not existing profile points. Default value: 1.
inMaxPathInterpolationLengthFtl.Optional<int><0, INF>1Maximal number of consecutive points not found. Default value: 1.
inMaxDeviationDeltaFtl.Optional<float><0.0f, INF>Maximal difference between deviations of consecutive path points. Default value: ftl::NIL.
inMaxIncompletenessfloat<0.0f, 0.999f>0.1fMaximal fraction of ridge points not found. Default value: 0.1f.
outPathFtl.Conditional<System.Collections.Generic.List<Fil.Point3D>>Fitted path or nothing if the fitting failed.
outRidgesFtl.Optional<System.Collections.Generic.List<Ftl.Conditional<Fil.SurfaceRidge1D>>>Found ridges.
outDeviationProfileFtl.Optional<Ftl.Conditional<Fil.Profile>>Profile of distances between the actual path points and the corresponding reference path points.
outAlignedFittingFieldFtl.Optional<Fil.PathFittingField>Fitting field used; in the image coordinate system.
outHeightProfilesFtl.Optional<System.Collections.Generic.List<Fil.Profile>>Extracted surface height profiles.
outResponseProfilesFtl.Optional<System.Collections.Generic.List<Fil.Profile>>Profiles of the ridge operator response.
outPathSegmentsFtl.Optional<Ftl.Conditional<System.Collections.Generic.List<Fil.Segment3D>>>Segments of the fitted path or nothing if the fitting failed.
diagScanSegmentsFil.Diagnostic<System.Collections.Generic.List<Fil.Segment2D>>Segments along which the scans were run.
diagSamplingAreasFil.Diagnostic<System.Collections.Generic.List<Fil.Rectangle2D>>Areas from which the input image is sampled.

See also