You are here: Start » AVL.NET » Function Reference » Computer Vision » Shape Fitting 3D » AVL.FitSegmentToRidges3D
Performs a series of 1D ridge detections and finds a segment that best matches the detected points.
Namespace: | AvlNet |
---|---|
Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void FitSegmentToRidges3D ( AvlNet.Surface inSurface, AvlNet.SegmentFittingMap inFittingMap, AvlNet.RidgeScanParams3D inRidgeScanParams, AvlNet.Selection inRidgeSelection, AvlNet.LocalBlindness? inLocalBlindness, int? inMaxProfileGapWidth, float inMaxIncompleteness, AvlNet.MEstimator? inOutlierSuppression, INullable<AvlNet.Segment3D> outSegment, NullableRef<List<AvlNet.SurfaceRidge1D?>> outRidges, NullableRef<NullableRef<AvlNet.Profile>> outDeviationProfile, NullableRef<List<AvlNet.Point3D>> outInliers, NullableRef<SafeList<AvlNet.Profile>> outHeightProfiles, NullableRef<SafeList<AvlNet.Profile>> outResponseProfiles )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inSurface | AvlNet.Surface | Surface to fit the segment to. | |||
inFittingMap | AvlNet.SegmentFittingMap | Input fitting map. | |||
inRidgeScanParams | AvlNet.RidgeScanParams3D | Parameters controlling the ridge extraction process. | |||
inRidgeSelection | AvlNet.Selection | avl::SelectionBest | Selection mode of ridges. Default value: avl::SelectionBest. | ||
inLocalBlindness | AvlNet.LocalBlindness? | Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges. Default value: atl::NIL. | |||
inMaxProfileGapWidth | int? | <0, INF> | 1 | Maximal number of consecutive not existing profile points. Default value: 1. | |
inMaxIncompleteness | float | <0.0f, 0.999f> | 0.1f | Maximal fraction of ridge points not found. Default value: 0.1f. | |
inOutlierSuppression | AvlNet.MEstimator? | Selects a method for ignoring incorrectly detected points. Default value: atl::NIL. | |||
outSegment | AvlNet.INullable<AvlNet.Segment3D> | Fitted segment or nothing if the fitting fails. This parameter cannot be null. | |||
outRidges | AvlNet.NullableRef<System.Collections.Generic.List<AvlNet.SurfaceRidge1D?>> | Found ridges. Can be null to skip this parameter calculation. | |||
outDeviationProfile | AvlNet.NullableRef<AvlNet.NullableRef<AvlNet.Profile>> | Profile of distances between the actual segment points and the corresponding reference segment points. Can be null to skip this parameter calculation. | |||
outInliers | AvlNet.NullableRef<System.Collections.Generic.List<AvlNet.Point3D>> | Points matching the fitting segment. Can be null to skip this parameter calculation. | |||
outHeightProfiles | AvlNet.NullableRef<AvlNet.SafeList<AvlNet.Profile>> | Extracted surface height profiles. Can be null to skip this parameter calculation. | |||
outResponseProfiles | AvlNet.NullableRef<AvlNet.SafeList<AvlNet.Profile>> | Profiles of the ridge operator response. Can be null to skip this parameter calculation. |
Hardware Acceleration
This operation supports automatic parallelization for multicore and multiprocessor systems.
Hardware acceleration settings may be manipulated with Settings class.
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Ridge operator parameters are too low in surface ridges detector in FitSegmentToRidges3D. |
Function Overrides
- FitSegmentToRidges3D(Surface, SegmentFittingMap, RidgeScanParams3D, Selection, Single, INullable<Segment3D>)
- FitSegmentToRidges3D(Surface, SegmentFittingMap, RidgeScanParams3D, Selection, Nullable<LocalBlindness>, Nullable<Int32>, Single, Nullable<MEstimator>, INullable<Segment3D>)
- FitSegmentToRidges3D(Surface, SegmentFittingMap, RidgeScanParams3D, Selection, Nullable<LocalBlindness>, Nullable<Int32>, Single, Nullable<MEstimator>, INullable<Segment3D>, IList<Nullable<SurfaceRidge1D>>, INullable<Profile>, IList<Point3D>, IList<Profile>, IList<Profile>)