CogOCVMaxRunParams.GetConfusionThreshold Method (CogOCVMaxParagraphIterator)

CogOCVMaxRunParams GetConfusionThreshold Method (CogOCVMaxParagraphIterator)

Cognex VisionPro 9.5

Gets the confusion threshold for the specified paragraph.

Namespace: Cognex.VisionPro.OCVMax
Assembly: Cognex.VisionPro.OCVMax (in Cognex.VisionPro.OCVMax.dll) Version: 69.0.0.0

Syntax

C++

Copy to Clipboard Print

public double GetConfusionThreshold(
	CogOCVMaxParagraphIterator pPI
)

public double GetConfusionThreshold(
	CogOCVMaxParagraphIterator pPI
)

Public Function GetConfusionThreshold ( 
	pPI As CogOCVMaxParagraphIterator
) As Double

Public Function GetConfusionThreshold ( 
	pPI As CogOCVMaxParagraphIterator
) As Double

public:
double GetConfusionThreshold(
	CogOCVMaxParagraphIterator^ pPI
)

public:
double GetConfusionThreshold(
	CogOCVMaxParagraphIterator^ pPI
)

Parameters

pPI: Type: Cognex.VisionPro.OCVMax CogOCVMaxParagraphIterator
A paragraph iterator that indicates the paragraph of interest.

Return Value

Type: Double
The confusion threshold in the range 0.0 to 1.0.

Exceptions

Exception	Condition
ObjectDisposedException	If this CogOCVMaxRunParams object has already been disposed.
ArgumentNullException	If the supplied argument is NULL.

Remarks

Each paragraph builds a confusion matrix when it is trained. This matrix has a number for every pair of keys in the paragraph's font alphabet that indicates how confusable two keys are. Values near 1.0 are very confusable (for example "5" and "S"), and values near zero are not confusable ("1" and "5").

The confusion threshold specifies the value below which other keys are not considered by OCVMax for confusion purposes. For example, if OCVMax is expecting to find a "5", it will also check other potentially confusing keys to see if they are also good matches. With a confusion threshold of 0.9, the keys for "S" and "6" might be " tried, but "1" would not. With a threshold of 0.4, many somewhat similar keys would be tried, such as "E" or "8". With a threshold of 0, all keys would be tried.