do_ocr_multi_class_knnT_do_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn (Operator)

Name

do_ocr_multi_class_knnT_do_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn — Classify multiple characters with an k-NN classifier.

Signature

do_ocr_multi_class_knn(Character, Image : : OCRHandle : Class, Confidence)

Description

do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnnDoOcrMultiClassKnn computes the best class for each of the characters given by the regions CharacterCharacterCharacterCharactercharacter and the gray values ImageImageImageImageimage with the k-NN classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandle and returns the classes in ClassClassClassClassclassVal and the corresponding confidence of the classes in ConfidenceConfidenceConfidenceConfidenceconfidence. The confidences lie between 0.0 and 1.0. The larger the value, the more reliable is the classification of the single characters. In contrast to do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnnDoOcrSingleClassKnn, do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnnDoOcrMultiClassKnn can classify multiple characters in one call, and therefore typically is faster than a loop that uses do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnnDoOcrSingleClassKnn to classify single characters. However, do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnnDoOcrMultiClassKnn can only return the best class of each character.

Before calling do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnnDoOcrMultiClassKnn, the classifier must be trained with trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnnTrainfOcrClassKnn.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.

Parameters

CharacterCharacterCharacterCharactercharacter (input_object) region(-array) → object

Characters to be recognized.

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

Gray values of the characters.

OCRHandleOCRHandleOCRHandleOCRHandleOCRHandle (input_control) ocr_knn → (handle)

Handle of the k-NN classifier.

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

Result of classifying the characters with the k-NN.

Number of elements: Class == Character

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

Confidence of the class of the characters.

Number of elements: Confidence == Character

Result

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