Start » Filter Reference » Computer Vision » Shape Fitting 3D » FitSegmentToRidges3D
Module: | Vision3DStandard |
---|
Performs a series of 1D ridge detections in 3D and finds a segment that best matches the detected points.
Applications
Precise detection of a thin straight line, whose rough location is known beforehand.
Name | Type | Range | Description | |
---|---|---|---|---|
inSurface | Surface | Surface to fit the segment to | ||
inFittingField | SegmentFittingField | Segment fitting field | ||
inFittingFieldAlignment | CoordinateSystem2D* | Adjusts the fitting field to the position of the inspected object | ||
inScanCount | Integer | 3 - | The number of points that will be searched to estimate the position of the segment | |
inSamplingStep | Real* | 0.0 - | Desired distance between consecutive sampling points on the scan segments; if Nil, the bigger of surface X and Y scales is chosen | |
inScanWidth | Integer | 1 - | The width of each scan field (in pixels) | |
inSurfaceInterpolation | InterpolationMethod | Interpolation method used for extraction of surface points | ||
inRidgeScanParams | RidgeScanParams3D | Parameters controlling the ridge extraction process | ||
inRidgeSelection | Selection | Selection mode of ridges | ||
inLocalBlindness | LocalBlindness* | Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges | ||
inMaxProfileGapWidth | Integer* | 0 - | Maximal number of consecutive not existing profile points | |
inMaxIncompleteness | Real | 0.0 - 0.999 | Maximal fraction of ridge points not found | |
inOutlierSuppression | MEstimator* | Selects a method for ignoring incorrectly detected points | ||
outSegment | Segment3D? | Fitted segment or nothing if the fitting fails | ||
outRidges | SurfaceRidge1D?Array | Found ridges | ||
outDeviationProfile | Profile? | Profile of distances between the actual segment points and the corresponding reference segment points | ||
outAlignedFittingField | SegmentFittingField | Fitting field used; in the image coordinate system | ||
outInliers | Point3DArray | Points matching the fitting segment | ||
outHeightProfiles | ProfileArray | Extracted surface height profiles | ||
outResponseProfiles | ProfileArray | Profiles of the ridge operator response | ||
diagScanSegments | Segment2DArray | Segments along which the scans were run | ||
diagSamplingAreas | Rectangle2DArray | Areas from which the input image is sampled |
Hardware Acceleration
This operation supports automatic parallelization for multicore and multiprocessor systems.
Errors
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Ridge operator parameters are too low in surface ridges detector in FitSegmentToRidges3D. |
DomainError | Sampling step set to zero in FitSegmentToRidges3D. |
Complexity Level
This filter is available on Basic Complexity Level.
Filter Group
This filter is member of FitSegment3D filter group.