CogCNLSearchRunParams.ConfusionThreshold Property

CogCNLSearchRunParams ConfusionThreshold Property

Cognex VisionPro

Confusion threshold 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.

Namespace: Cognex.VisionPro.CNLSearch
Assembly: Cognex.VisionPro.CNLSearch (in Cognex.VisionPro.CNLSearch.dll) Version: 65.1.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

Events

Event Type	Reason
CogCNLSearchRunParams Changed	Fires when the confusion threshold is changed. The following state flag may be affected: SfConfusionThreshold
CogCNLSearchRunParams Changed	Fires when both the accept threshold and the confusion threshold are changed. The following state flags may be affected: SfAcceptThreshold SfConfusionThreshold

Event Type

Reason

CogCNLSearchRunParams Changed

Fires when the confusion threshold is changed.

The following state flag may be affected:

SfConfusionThreshold

CogCNLSearchRunParams Changed

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

The following state flags may be affected:

Exceptions

Exception	Condition
ArgumentException	The supplied value is less than 0.0 or greater than 1.0.

Remarks

The confusion threshold. 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 tool is. The Confusion threshold must be greater than or equal to 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.

The following diagram summarizes the relationship between the Accept and Confusion thresholds. Keep in mind that you supply these thresholds to help the tool find the trained pattern as quickly and reliably as possible; you use these thresholds to provide information about the search image.

Default Value: 0.5