You are here: Start » Function Reference » Computer Vision » Shape Fitting » CreateCircleFittingMap
CreateCircleFittingMap
Header: | AVL.h |
---|---|
Namespace: | avl |
Module: | MetrologyPro |
Precomputes a data object that is required for fast circle fitting on images.
Applications: Used together with circle fitting, but can be moved before the loop.
Syntax
void avl::CreateCircleFittingMap ( const avl::ImageFormat& inImageFormat, const avl::CircleFittingField& inFittingField, atl::Optional<const avl::CoordinateSystem2D&> inFittingFieldAlignment, const int inScanCount, const int inScanWidth, const avl::SamplingParams& inSamplingParams, avl::CircleFittingMap& outFittingMap, atl::Array<avl::Segment2D>& diagScanSegments, atl::Array<avl::Rectangle2D>& diagSamplingAreas )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inImageFormat | const ImageFormat& | Dimensions, depth and pixel type of the images on which fitting will be performed | |||
inFittingField | const CircleFittingField& | Defines a ring in which scan segments will be created | |||
inFittingFieldAlignment | Optional<const CoordinateSystem2D&> | NIL | Adjusts the fitting field to the position of the inspected object | ||
inScanCount | const int | 3 - | 10 | The number of points that will be searched to estimate the position of the circle | |
inScanWidth | const int | 1 - | 5 | The width of each scan field (in pixels) | |
inSamplingParams | const SamplingParams& | .interpolation Bilinear | Parameters controlling the sampling process | ||
outFittingMap | CircleFittingMap& | Optimized data required for circle fitting | |||
diagScanSegments | Array<Segment2D>& | Segments along which the scans will be run | |||
diagSamplingAreas | Array<Rectangle2D>& | Scan fields created for point detection |
Description
The operation creates a series of scan maps that can be later used by other Shape Fitting filters. Each scan map corresponds to a single scan segment of inScanWidth length.
The optional parameter inFittingFieldAlignment defines the transform to be performed on the inFittingField so that the result is defined in a new context, e.g. returned by one of Template Matching filters.
Remarks
Read more about Local Coordinate Systems in Machine Vision Guide: Local Coordinate Systems.
This filter is a part of the Shape Fitting toolset. To read more about this technique, one can refer to the Shape Fitting chapter of our Machine Vision Guide
See Also
- FitCircleToEdges – Performs a series of 1D edge detections and finds a circle that best matches the detected points.
- FitCircleToRidges – Performs a series of 1D ridge detections and finds a circle that best matches the detected points.
- FitCircleToStripe – Performs a series 1D stripe detections and finds a circle that best matches the detected points.
- FitCircleToEdges_Direct – Performs a series of 1D edge detections and finds a circle that best matches the detected points.
- FitCircleToRidges_Direct – Performs a series of 1D ridge detections and finds a circle that best matches the detected points.
- FitCircleToStripe_Direct – Performs a series 1D stripe detections and finds a circle that best matches the detected points.