You are here: Start » AVL.NET » AVL.FitArcToEdges Method

AVL.FitArcToEdges Method

Performs a series of 1D edge detections and finds an arc that best matches the detected points.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax

public static void FitArcToEdges(
	AvlNet.Image inImage,
	AvlNet.ArcFittingMap inFittingMap,
	AvlNet.EdgeScanParams inEdgeScanParams,
	AvlNet.Selection inEdgeSelection,
	AvlNet.LocalBlindness? inLocalBlindness,
	float inMaxIncompleteness,
	AvlNet.CircleFittingMethod inFittingMethod,
	AvlNet.MEstimator? inOutlierSuppression,
	out AvlNet.Arc2D? outArc,
	out System.Nullable&lt;AvlNet.Edge1D&gt;[] outEdges,
	out AvlNet.Profile outDeviationProfile,
	out AvlNet.Profile[] diagBrightnessProfiles,
	out AvlNet.Profile[] diagResponseProfiles
)

Parameters

Name	Type	Range	Default	Description
inImage	AvlNet.Image			Input image to fit arc to.
inFittingMap	AvlNet.ArcFittingMap			Input fitting map.
inEdgeScanParams	AvlNet.EdgeScanParams			Parameters controlling the edge extraction process.
inEdgeSelection	AvlNet.Selection		avl::Selection::Best	Selection mode of edges. Default value: avl::Selection::Best.
inLocalBlindness	AvlNet.LocalBlindness ?			Defines conditions in which weaker edges can be detected in the vicinity of stronger edges. Default value: atl::NIL, or null.
inMaxIncompleteness	float	<0.0f, 0.999f>	0.1f	Maximal fraction of edge points not found. Default value: 0.1f.
inFittingMethod	AvlNet.CircleFittingMethod		AlgebraicTaubin	Method used to fit an arc. Default value: AlgebraicTaubin.
inOutlierSuppression	AvlNet.MEstimator ?			Selects a method for ignoring incorrectly detected points. Default value: atl::NIL, or null.
outArc	AvlNet.Arc2D ?			Fitted arc or nothing if the fitting fails.
outEdges	AvlNet.Edge1D ?			Found edges
outDeviationProfile	AvlNet.Profile			Profile of distances between the actual arc points and the corresponding reference arc points
diagBrightnessProfiles	AvlNet.Profile			Extracted image profiles.
diagResponseProfiles	AvlNet.Profile			Profiles of the edge (derivative) operator response.

Description

The operation tries to fit a given arc to edges present in the inImage image. Internally, it performs a series of scans with the ScanSingleEdge filter using inFittingMap previously generated from the object being fitted. The found points are then used to determine the actual position of the arc in the image. Only inMaxIncompleteness fraction of these scans may fail. If the fitting according to the given parameters is not possible, outArc is set to Nil.

Examples

Fitting an arc to the edges of a semi-hole
(inEdgeScanParams.Transition = BrightToDark).

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

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.