ClassesClassesClassesClasses | | | | Operators

do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn (Operator)

Name

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

Signature

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

Herror do_ocr_multi_class_knn(const Hobject Character, const Hobject Image, const Hlong OCRHandle, char* Class, double* Confidence)

Herror T_do_ocr_multi_class_knn(const Hobject Character, const Hobject Image, const Htuple OCRHandle, Htuple* Class, Htuple* Confidence)

Herror do_ocr_multi_class_knn(Hobject Character, Hobject Image, const HTuple& OCRHandle, char* Class, double* Confidence)

Herror do_ocr_multi_class_knn(Hobject Character, Hobject Image, const HTuple& OCRHandle, HTuple* Class, HTuple* Confidence)

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

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

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

void DoOcrMultiClassKnn(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

void HOperatorSetX.DoOcrMultiClassKnn(
[in] IHUntypedObjectX* Character, [in] IHUntypedObjectX* Image, [in] VARIANT OCRHandle, [out] VARIANT* Class, [out] VARIANT* Confidence)

VARIANT HRegionX.DoOcrMultiClassKnn(
[in] IHImageX* Image, [in] IHOCRKnnX* OCRHandle, [out] VARIANT* Confidence)

VARIANT HOCRKnnX.DoOcrMultiClassKnn(
[in] IHRegionX* Character, [in] IHImageX* Image, [out] VARIANT* Confidence)

static void HOperatorSet.DoOcrMultiClassKnn(HObject character, HObject image, HTuple OCRHandle, out HTuple classVal, out HTuple confidence)

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_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn computes the best class for each of the characters given by the regions CharacterCharacterCharacterCharacterCharactercharacter and the gray values ImageImageImageImageImageimage with the k-NN classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle and returns the classes in ClassClassClassClassClassclassVal and the corresponding confidence of the classes in ConfidenceConfidenceConfidenceConfidenceConfidenceconfidence. 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_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn, do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn 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_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn to classify single characters. However, do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn can only return the best class of each character.

Before calling do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn, the classifier must be trained with trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn.

Parallelization

Parameters

CharacterCharacterCharacterCharacterCharactercharacter (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Characters to be recognized.

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / uint2)

Gray values of the characters.

OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle (input_control)  ocr_knn HOCRKnn, HTupleHTupleHOCRKnn, HTupleHOCRKnnX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the k-NN classifier.

ClassClassClassClassClassclassVal (output_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Result of classifying the characters with the k-NN.

Number of elements: Class == Character

ConfidenceConfidenceConfidenceConfidenceConfidenceconfidence (output_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (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_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn, read_ocr_class_knnread_ocr_class_knnReadOcrClassKnnread_ocr_class_knnReadOcrClassKnnReadOcrClassKnn

Alternatives

do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn

See also

create_ocr_class_knncreate_ocr_class_knnCreateOcrClassKnncreate_ocr_class_knnCreateOcrClassKnnCreateOcrClassKnn, classify_class_knnclassify_class_knnClassifyClassKnnclassify_class_knnClassifyClassKnnClassifyClassKnn

Module

OCR/OCV


ClassesClassesClassesClasses | | | | Operators