CreateCircleFittingMap3D


Precomputes a data object that is required for fast circle fitting on surfaces.

Applications:Used together with circle fitting, but can be moved before the loop.

Syntax

C++
C#
Python
 
def CreateCircleFittingMap3D(
	inSurfaceFormat: SurfaceFormat,
	inFittingField: CircleFittingField,
	inScanCount: int,
	inScanWidth: int,
	inSurfaceInterpolation: InterpolationMethod,
	outFittingMap: CircleFittingMap,
	/,
	*,
	inFittingFieldAlignment: CoordinateSystem2D | None = None,
	inSamplingStep: float | None = None
)
-> (
	diagScanSegments: list[Segment2D],
	diagSamplingAreas: list[Rectangle2D]
)

Parameters

Name Type Range Default Description
Input value inSurfaceFormat SurfaceFormat Dimensions, depth image pixel type, coordinate offsets and scales of a surface on which circle fitting will be performed
Input value inFittingField CircleFittingField Defines a ring in which scan segments will be created
Input value inFittingFieldAlignment CoordinateSystem2D | None None Adjusts the fitting field to the position of the inspected object
Input value inScanCount int 3 - The number of points that will be searched to estimate the position of the circle
Input value inSamplingStep float | None None Desired distance between consecutive sampling points on the scan segments; if Nil, the bigger of surface X and Y scales is chosen
Input value inScanWidth int 1 - The width of each scan field in pixels of the surface depth image
Input value inSurfaceInterpolation InterpolationMethod Interpolation method used for extraction of depth image pixel values
Output value outFittingMap CircleFittingMap Optimized data required for circle fitting
Diagnostic input diagScanSegments list[Segment2D] Segments along which the scans will be run
Diagnostic input diagSamplingAreas list[Rectangle2D] Scan fields created for point detection