CogSearchMaxRunParams.ConfusionThreshold Property

CogSearchMaxRunParams ConfusionThreshold Property

Cognex VisionPro 9.7

Gets or sets the confusion threshold on the score of a result which is a hint regarding how confusing the search image is likely to be. A high value slows the search but ensures that wrong features are not found. A low value speeds up the search for non-confusing scenes. Must be >= AcceptThreshold. Valid range is from 0 to 1.

Namespace: Cognex.VisionPro.SearchMax
Assembly: Cognex.VisionPro.SearchMax (in Cognex.VisionPro.SearchMax.dll) Version: 73.0.0.0

Syntax

C++

Copy to Clipboard Print

public double ConfusionThreshold { get; set; }

public double ConfusionThreshold { get; set; }

Public Property ConfusionThreshold As Double 
	Get 
	Set

Public Property ConfusionThreshold As Double 
	Get 
	Set

public:
property double ConfusionThreshold {
	double get ();
	void set (double value);
}

public:
property double ConfusionThreshold {
	double get ();
	void set (double value);
}

Property Value

Type: Double
The confusion threshold. Default value is 1.0.

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when this property changes. The following state flag may be affected: SfConfusionThreshold
ICogChangedEvent Changed	Fires when both the acceptance threshold and the confusion threshold are changed. The following state flags may be affected: SfAcceptThreshold SfConfusionThreshold

Event Type

Reason

ICogChangedEvent Changed

Fires when this property changes.

The following state flag may be affected:

SfConfusionThreshold

ICogChangedEvent Changed

Fires when both the acceptance threshold and the confusion threshold are changed.

The following state flags may be affected:

SfAcceptThreshold
SfConfusionThreshold

Exceptions

Exception	Condition
ArgumentOutOfRangeException	Thrown when you attempt to set this to a value less than 0 or greater than 1.0.

Remarks

The confusion threshold is the highest score that something other than a valid pattern instance will receive. You specify a confusion threshold to indicate how confusing you expect the search image to be; the higher a value you specify, the more careful the the AcceptThreshold (which is the score above which all valid pattern instances lie).

The ConfusionThreshold must be greater than or equal to the AcceptThreshold. If this property is set to a value less than the AcceptThreshold, the AcceptThreshold is set to the new value.