You are here: Start » FIL.NET » FIS.FitCircleToEdges_Direct Method

FIS.FitCircleToEdges_Direct Method

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

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

public static void FitCircleToEdges_Direct
(
	FilNet.Image inImage,
	FilNet.CircleFittingField inFittingField,
	FilNet.CoordinateSystem2D? inFittingFieldAlignment,
	int inScanCount,
	int inScanWidth,
	FilNet.SamplingParams inSamplingParams,
	FilNet.EdgeScanParams inEdgeScanParams,
	FilNet.Selection inEdgeSelection,
	FilNet.LocalBlindness? inLocalBlindness,
	float inMaxIncompleteness,
	FilNet.CircleFittingMethod inFittingMethod,
	FilNet.MEstimator? inOutlierSuppression,
	out FilNet.Circle2D? outCircle,
	NullableRef<List<FilNet.Edge1D?>> outEdges,
	NullableRef<NullableRef<FilNet.Profile>> outDeviationProfile,
	NullableValue<FilNet.CircleFittingField> outAlignedFittingField,
	NullableRef<List<FilNet.Point2D>> outInliers,
	NullableRef<SafeList<FilNet.Profile>> outBrightnessProfiles,
	NullableRef<SafeList<FilNet.Profile>> outResponseProfiles
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageImage to fit the circle to.
inFittingFieldFilNet.CircleFittingFieldCircle fitting field.
inFittingFieldAlignmentFilNet.CoordinateSystem2D?Adjusts the fitting field to the position of the inspected object. Default value: ftl::NIL.
inScanCountint<3, INF>10The number of points that will be searched to estimate the position of the circle. Default value: 10.
inScanWidthint<1, INF>5The width of each scan field (in pixels). Default value: 5.
inSamplingParamsFilNet.SamplingParamsParameters controlling the sampling process.
inEdgeScanParamsFilNet.EdgeScanParamsEdgeScanParams ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 1.0f MinMagnitude: 5.0f EdgeTransition: BrightToDark )Parameters controlling the edge extraction process. Default value: EdgeScanParams ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 1.0f MinMagnitude: 5.0f EdgeTransition: BrightToDark ).
inEdgeSelectionFilNet.SelectionSelection mode of edges.
inLocalBlindnessFilNet.LocalBlindness?Defines conditions in which weaker edges can be detected in the vicinity of stronger edges. Default value: ftl::NIL.
inMaxIncompletenessfloat<0.0f, 0.999f>0.1fMaximal fraction of edge points not found. Default value: 0.1f.
inFittingMethodFilNet.CircleFittingMethodAlgebraicTaubinMethod used to fit a circle. Default value: AlgebraicTaubin.
inOutlierSuppressionFilNet.MEstimator?Selects a method for ignoring incorrectly detected points. Default value: ftl::NIL.
outCircleFilNet.Circle2D?Fitted circle or nothing if the fitting fails.
outEdgesFilNet.NullableRef<System.Collections.Generic.List<FilNet.Edge1D?>>Found edges. Can be null to skip this parameter calculation.
outDeviationProfileFilNet.NullableRef<FilNet.NullableRef<FilNet.Profile>>Profile of distances between the actual circle points and the corresponding reference circle points. Can be null to skip this parameter calculation.
outAlignedFittingFieldFilNet.NullableValue<FilNet.CircleFittingField>Fitting field used; in the image coordinate system. Can be null to skip this parameter calculation.
outInliersFilNet.NullableRef<System.Collections.Generic.List<FilNet.Point2D>>Points matching the fitting Circle. Can be null to skip this parameter calculation.
outBrightnessProfilesFilNet.NullableRef<FilNet.SafeList<FilNet.Profile>>Extracted image profiles. Can be null to skip this parameter calculation.
outResponseProfilesFilNet.NullableRef<FilNet.SafeList<FilNet.Profile>>Profiles of the edge (derivative) operator response. Can be null to skip this parameter calculation.

Function Overrides

See also