Start » Filter Reference » Computer Vision » Shape Fitting 3D » FitCircleToRidges3D
Module: | Vision3DStandard |
---|
Performs a series of 1D ridge detections in 3D and finds a circle that best matches the detected points.
Applications
Precise detection of a circular object or hole, whose rough location is known beforehand.
Name | Type | Range | Description | |
---|---|---|---|---|
inSurface | Surface | Surface to fit the circle to | ||
inFittingField | CircleFittingField | Circle 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 circle | |
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 | |
inFittingMethod | CircleFittingMethod | Method used to fit a circle | ||
inOutlierSuppression | MEstimator* | Selects a method for ignoring incorrectly detected points | ||
outCircle | Circle3D? | Fitted circle or nothing if the fitting fails | ||
outRidges | SurfaceRidge1D?Array | Found ridges | ||
outDeviationProfile | Profile? | Profile of distances between the actual circle points and the corresponding reference circle points | ||
outAlignedFittingField | CircleFittingField | Fitting field used; in the image coordinate system | ||
outInliers | Point3DArray | Points matching the fitting Circle | ||
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 FitCircleToRidges3D. |
DomainError | Sampling step set to zero in FitCircleToRidges3D. |
Complexity Level
This filter is available on Basic Complexity Level.
Filter Group
This filter is member of FitCircle3D filter group.