CogOCRMaxClassifier.Execute Method (CogOCRMaxClassifierRunParams, CogOCRMaxSwapCharSet, IList(CogOCRMaxSegmenterPositionResult))

CogOCRMaxClassifier Execute Method (CogOCRMaxClassifierRunParams, CogOCRMaxSwapCharSet, IList CogOCRMaxSegmenterPositionResult )

Cognex VisionPro 9.8

Classify the line of segmented characters contained in the CogOCRMaxSegmenterLineResult.

Namespace: Cognex.VisionPro.OCRMax
Assembly: Cognex.VisionPro.OCRMax (in Cognex.VisionPro.OCRMax.dll) Version: 75.1.0.0

Syntax

C++

Copy to Clipboard Print

public CogOCRMaxClassifierLineResult Execute(
	CogOCRMaxClassifierRunParams runParams,
	CogOCRMaxSwapCharSet swapCharSet,
	IList<CogOCRMaxSegmenterPositionResult> segmentedCharacters
)

public CogOCRMaxClassifierLineResult Execute(
	CogOCRMaxClassifierRunParams runParams,
	CogOCRMaxSwapCharSet swapCharSet,
	IList<CogOCRMaxSegmenterPositionResult> segmentedCharacters
)

Public Function Execute ( 
	runParams As CogOCRMaxClassifierRunParams,
	swapCharSet As CogOCRMaxSwapCharSet,
	segmentedCharacters As IList(Of CogOCRMaxSegmenterPositionResult)
) As CogOCRMaxClassifierLineResult

Public Function Execute ( 
	runParams As CogOCRMaxClassifierRunParams,
	swapCharSet As CogOCRMaxSwapCharSet,
	segmentedCharacters As IList(Of CogOCRMaxSegmenterPositionResult)
) As CogOCRMaxClassifierLineResult

public:
CogOCRMaxClassifierLineResult^ Execute(
	CogOCRMaxClassifierRunParams^ runParams, 
	CogOCRMaxSwapCharSet^ swapCharSet, 
	IList<CogOCRMaxSegmenterPositionResult^>^ segmentedCharacters
)

public:
CogOCRMaxClassifierLineResult^ Execute(
	CogOCRMaxClassifierRunParams^ runParams, 
	CogOCRMaxSwapCharSet^ swapCharSet, 
	IList<CogOCRMaxSegmenterPositionResult^>^ segmentedCharacters
)

Parameters

runParams: Type: Cognex.VisionPro.OCRMax CogOCRMaxClassifierRunParams
The run params that specify how to perform classification.

swapCharSet: Type: Cognex.VisionPro.OCRMax CogOCRMaxSwapCharSet
The set of chracters which have been predetermined to be "swappable" (They appear similar and are hard to distinguish, e.g. '0' and 'O').

segmentedCharacters: Type: System.Collections.Generic IList CogOCRMaxSegmenterPositionResult
The characters to be classified (usually the output of CogOCRMaxSegmenter).

Return Value

Type: CogOCRMaxClassifierLineResult

Exceptions

Exception	Condition
CogSecurityViolationException
CogOCRMaxClassifierParamsException	Thrown if: any character's image is not allocated any character's cell rect is not specified
CogTimeoutExpiredException	Thrown if the Timeout expired.
ArgumentNullException	Thrown if runParams is null. Thrown if swapCharSet is null. Thrown if segmentedCharacters is null.

Remarks

Note that space characters are a special case. The OCRMax Classifier does not classify space characters. Instead the classifier input (cf. the segmenter output) is responsible for deciding if a particular character is a space. The classifier simply "passes through" space characters and their associated scores. Space characters are not assigned alternative characters, and the confidence score is set to be equal to the regular score in the classifier output.

If the CogOCRMaxClassifierPositionResult.IsSpace property is true the classifier will automatically classify the character as a space. The space character's score and confidence score will be set to the CogOCRMaxClassifierPositionResult.SpaceScore of the input.