do_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnndo_ocr_multi_class_knnT_do_ocr_multi_class_knn

HALCON ScriptCpp++.NETPythonC

Short description

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

Signature

do_ocr_multi_class_knn( region Character, image Image, ocr_knn OCRHandle, out string Class, out real Confidence )void DoOcrMultiClassKnn( const HObject& Character, const HObject& Image, const HTuple& OCRHandle, HTuple* Class, HTuple* Confidence )static void HOperatorSet.DoOcrMultiClassKnn( HObject character, HObject image, HTuple OCRHandle, out HTuple classVal, out HTuple confidence )def do_ocr_multi_class_knn( character: HObject, image: HObject, ocrhandle: HHandle ) -> Tuple[Sequence[str], Sequence[float]]

def do_ocr_multi_class_knn_s( character: HObject, image: HObject, ocrhandle: HHandle ) -> Tuple[str, float]Herror T_do_ocr_multi_class_knn( const Hobject Character, const Hobject Image, const Htuple OCRHandle, Htuple* Class, Htuple* Confidence )

HTuple HRegion::DoOcrMultiClassKnn( const HImage& Image, const HOCRKnn& OCRHandle, HTuple* Confidence ) const

HString HRegion::DoOcrMultiClassKnn( const HImage& Image, const HOCRKnn& OCRHandle, double* Confidence ) const

HTuple HOCRKnn::DoOcrMultiClassKnn( const HRegion& Character, const HImage& Image, HTuple* Confidence ) const

HString HOCRKnn::DoOcrMultiClassKnn( const HRegion& Character, const HImage& Image, double* Confidence ) const

HTuple HRegion.DoOcrMultiClassKnn( HImage image, HOCRKnn OCRHandle, out HTuple confidence )

string HRegion.DoOcrMultiClassKnn( HImage image, HOCRKnn OCRHandle, out double confidence )

HTuple HOCRKnn.DoOcrMultiClassKnn( HRegion character, HImage image, out HTuple confidence )

string HOCRKnn.DoOcrMultiClassKnn( HRegion character, HImage image, out double confidence )

Description

do_ocr_multi_class_knnDoOcrMultiClassKnn computes the best class for each of the characters given by the regions Charactercharactercharacter and the gray values Imageimageimage with the k-NN classifier OCRHandleOCRHandleocrhandle and returns the classes in ClassclassValclass and the corresponding confidence of the classes in Confidenceconfidenceconfidence. 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_knnDoOcrSingleClassKnn, do_ocr_multi_class_knnDoOcrMultiClassKnn can classify multiple characters in one call, and therefore typically is faster than a loop that uses do_ocr_single_class_knnDoOcrSingleClassKnn to classify single characters. However, do_ocr_multi_class_knnDoOcrMultiClassKnn can only return the best class of each character.

Before calling do_ocr_multi_class_knnDoOcrMultiClassKnn, the classifier must be trained with trainf_ocr_class_knnTrainfOcrClassKnn.

Execution information

Execution information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

Parameters

Charactercharactercharacter (input_object) region(-array) → objectHObjectHRegionHObjectHobject

Characters to be recognized.

Imageimageimage (input_object) singlechannelimage → object (byte / uint2)HObject (byte / uint2)HImage (byte / uint2)HObject (byte / uint2)Hobject (byte / uint2)

Gray values of the characters.

OCRHandleOCRHandleocrhandle (input_control) ocr_knn → (handle)HTuple (HHandle)HOCRKnn, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the k-NN classifier.

ClassclassValclass (output_control) string(-array) → (string)HTuple (HString)HTuple (string)Sequence[str]Htuple (char*)

Result of classifying the characters with the k-NN.

Number of elements: Class == Character

Confidenceconfidenceconfidence (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Confidence of the class of the characters.

Number of elements: Confidence == Character

Result

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

Combinations with other operators

Combinations

Possible predecessors

trainf_ocr_class_knnTrainfOcrClassKnn, read_ocr_class_knnReadOcrClassKnn

Alternatives

do_ocr_single_class_knnDoOcrSingleClassKnn

See also

create_ocr_class_knnCreateOcrClassKnn, classify_class_knnClassifyClassKnn

Module

OCR/OCV