You are here: Start » Function Reference » Shape Fitting » CreateCircleFittingMap
CreateCircleFittingMap
Precomputes a data object that is required for fast circle fitting on images.
Syntax
void avl::CreateCircleFittingMap ( const avl::ImageFormat& inImageFormat, const avl::CircleFittingField& inFittingField, atl::Optional<const avl::CoordinateSystem2D&> inFittingFieldAlignment, const int inScanCount, const int inScanWidth, avl::InterpolationMethod::Type inImageInterpolation, 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) |
|
inImageInterpolation | InterpolationMethod::Type | InterpolationMethod::NearestNeighbour | Interpolation method used for extraction of image pixel values | |
 |
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
For more information about local coordinate systems please refer to the following article.
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
