LineMaxOperatorBase Assurance Property Cognex VisionPro 9.21 SR1
Get

Gets the tradeoff between speed and reliability when FittingMode is set to RANSAC mode.

Set

Sets the tradeoff between speed and reliability when FittingMode is set to RANSAC mode.

Namespace: Cognex.Vision.LineMax.Implementation
Assembly: Cognex.Vision.LineMax.Net (in Cognex.Vision.LineMax.Net.dll) Version: 9.21.1.1
Syntax

public abstract double Assurance { get; set; }

Return Value

Type: Double

The assurance as a ratio of 1.0.

Exceptions

ExceptionCondition
ArgumentOutOfRangeExceptionThrown when you assign a value less than or equal to zero or greater than or equal to one.
Remarks

Changed Fires when this property changes. The following state flag may be affected:

Remarks

Use this to tradeoff speed vs reliability of results. The assurance can be set to any value between 0 and 1, exclusive. Reducing the value makes the tool faster but less reliable, increasing the value makes the tool more reliable but slower. The default setting for the assurance parameter is 0.9999. This setting specifies that the user expects to receive an optimal result from the tool 9,999 times in 10,000, but is willing to accept a less than optimal result 1 time in 10,000. In other words, the assurance specifies the success rate one can settle for in order to avoid excessive runtimes. Those familiar will RANSAC methods will recognize that the internally calculated number of RANSAC iterations used to locate each line increases monotonically with the assurance setting. This property only applies when FittingMode is set to RANSAC.

See Also