CogOCRMaxClassifier.Execute Method (CogOCRMaxSegmenterPositionResult, CogOCRMaxClassifierRunParams)

CogOCRMaxClassifier Execute Method (CogOCRMaxSegmenterPositionResult, CogOCRMaxClassifierRunParams)

Cognex VisionPro 9.7

Classify a single segmented character.

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

Syntax

C++

Copy to Clipboard Print

public CogOCRMaxClassifierPositionResult Execute(
	CogOCRMaxSegmenterPositionResult segmentedCharacter,
	CogOCRMaxClassifierRunParams runParams
)

public CogOCRMaxClassifierPositionResult Execute(
	CogOCRMaxSegmenterPositionResult segmentedCharacter,
	CogOCRMaxClassifierRunParams runParams
)

Public Function Execute ( 
	segmentedCharacter As CogOCRMaxSegmenterPositionResult,
	runParams As CogOCRMaxClassifierRunParams
) As CogOCRMaxClassifierPositionResult

Public Function Execute ( 
	segmentedCharacter As CogOCRMaxSegmenterPositionResult,
	runParams As CogOCRMaxClassifierRunParams
) As CogOCRMaxClassifierPositionResult

public:
CogOCRMaxClassifierPositionResult^ Execute(
	CogOCRMaxSegmenterPositionResult^ segmentedCharacter, 
	CogOCRMaxClassifierRunParams^ runParams
)

public:
CogOCRMaxClassifierPositionResult^ Execute(
	CogOCRMaxSegmenterPositionResult^ segmentedCharacter, 
	CogOCRMaxClassifierRunParams^ runParams
)

Parameters

segmentedCharacter: Type: Cognex.VisionPro.OCRMax CogOCRMaxSegmenterPositionResult
The segmented character to be classified (usually the output of CogOCRMaxSegmenter).

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

Return Value

Type: CogOCRMaxClassifierPositionResult

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 segmentedCharacter is null. Thrown if runParams 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.