CogLineMax Assurance Property Cognex VisionPro 9.10
Gets or sets the tradeoff between speed and reliability when FittingMode is set to RANSAC mode.

Namespace: Cognex.VisionPro.LineMax
Assembly: Cognex.VisionPro.LineMax (in Cognex.VisionPro.LineMax.dll) Version: 79.0.0.0
Syntax

public double Assurance { get; set; }

Property Value

Type: Double
The assurance as a ratio of 1.0.
Events

Event TypeReason
ICogChangedEvent Changed

Fires when this property changes.

The following state flag may be affected:

Exceptions

ExceptionCondition
ArgumentOutOfRangeException Thrown when you assign a value less than or equal to zero or greater than or equal to one.
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