do_ocr_single_class_mlpT_do_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlp (Operator)

Name

do_ocr_single_class_mlpT_do_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlp — Classify a single character with an OCR classifier.

Signature

do_ocr_single_class_mlp(Character, Image : : OCRHandle, Num : Class, Confidence)

Description

do_ocr_single_class_mlpdo_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlpDoOcrSingleClassMlp computes the best NumNumNumNumnum classes of the character given by the region CharacterCharacterCharacterCharactercharacter and the gray values ImageImageImageImageimage with the OCR classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandle and returns the classes in ClassClassClassClassclassVal and the corresponding confidences (probabilities) of the classes in ConfidenceConfidenceConfidenceConfidenceconfidence. Because multiple classes may be returned by do_ocr_single_class_mlpdo_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlpDoOcrSingleClassMlp, CharacterCharacterCharacterCharactercharacter may only contain a single region (a single character). If multiple characters should be classified in a single call, do_ocr_multi_class_mlpdo_ocr_multi_class_mlpDoOcrMultiClassMlpDoOcrMultiClassMlpDoOcrMultiClassMlp must be used. Because do_ocr_multi_class_mlpdo_ocr_multi_class_mlpDoOcrMultiClassMlpDoOcrMultiClassMlpDoOcrMultiClassMlp typically is faster than a loop with do_ocr_single_class_mlpdo_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlpDoOcrSingleClassMlp and because the confidences can be interpreted as probabilities (see classify_class_mlpclassify_class_mlpClassifyClassMlpClassifyClassMlpClassifyClassMlp and evaluate_class_mlpevaluate_class_mlpEvaluateClassMlpEvaluateClassMlpEvaluateClassMlp), and it is therefore easy to check whether a character has been classified with too much uncertainty, in most cases do_ocr_multi_class_mlpdo_ocr_multi_class_mlpDoOcrMultiClassMlpDoOcrMultiClassMlpDoOcrMultiClassMlp should be used, unless the second-best class should be examined explicitly. The result '\x1A'"\x1A""\x1A""\x1A""\x1A" in ClassClassClassClassclassVal signifies that the region has been classified as rejection class.

Before calling do_ocr_single_class_mlpdo_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlpDoOcrSingleClassMlp, the classifier must be trained with trainf_ocr_class_mlptrainf_ocr_class_mlpTrainfOcrClassMlpTrainfOcrClassMlpTrainfOcrClassMlp.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

CharacterCharacterCharacterCharactercharacter (input_object) region → object

Character to be recognized.

ImageImageImageImageimage (input_object) singlechannelimage → object (byte / uint2)

Gray values of the character.

OCRHandleOCRHandleOCRHandleOCRHandleOCRHandle (input_control) ocr_mlp → (handle)

Handle of the OCR classifier.

NumNumNumNumnum (input_control) integer-array → (integer)

Number of best classes to determine.

Default value: 1

Suggested values: 1, 2, 3, 4, 5

ClassClassClassClassclassVal (output_control) string(-array) → (string)

Result of classifying the character with the MLP.

ConfidenceConfidenceConfidenceConfidenceconfidence (output_control) real(-array) → (real)

Confidence(s) of the class(es) of the character.

Result

If the parameters are valid, the operator do_ocr_single_class_mlpdo_ocr_single_class_mlpDoOcrSingleClassMlpDoOcrSingleClassMlpDoOcrSingleClassMlp returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.