CogCNLSearchRunParams AcceptThreshold Property Cognex VisionPro
Acceptance threshold on the score of a result. Only instances of the pattern that receive scores greater than or equal to this threshold are accepted. Valid range is from 0 to 1.

Namespace: Cognex.VisionPro.CNLSearch
Assembly: Cognex.VisionPro.CNLSearch (in Cognex.VisionPro.CNLSearch.dll) Version: 65.1.0.0
Syntax

public double AcceptThreshold { get; set; }

Property Value

Type: Double
Events

Event TypeReason
CogCNLSearchRunParams Changed

Fires when the accept threshold is changed.

The following state flag may be affected:

CogCNLSearchRunParams Changed

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

The following state flags may be affected:

Exceptions

ExceptionCondition
ArgumentException

The supplied value is less than 0.0 or greater than 1.0.

Remarks

The acceptance threshold. You should supply an acceptance threshold value such that no actual instance of a pattern will receive a score less than the threshold. CNLSearch assumes that any location in the search image which receives a value less than this threshold is not an actual instance of the pattern. The valid range is from 0.0 to 1.0.

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

After performing several test searches, you may be tempted to set the acceptance threshold value equal to or very close to the score of your test search. Because of the way the confusion threshold interacts with the acceptance threshold, doing so may result in your search not finding any valid instances. The acceptance threshold is the lowest score that any possible instance will receive.

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.3

See Also