ClassesClassesClassesClasses | | | | Operators

do_ocr_single_class_knnT_do_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn (Operator)

Name

do_ocr_single_class_knnT_do_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn — Classify a single character with an OCR classifier.

Signature

do_ocr_single_class_knn(Character, Image : : OCRHandle, NumClasses, NumNeighbors : Class, Confidence)

Herror T_do_ocr_single_class_knn(const Hobject Character, const Hobject Image, const Htuple OCRHandle, const Htuple NumClasses, const Htuple NumNeighbors, Htuple* Class, Htuple* Confidence)

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

Herror do_ocr_single_class_knn(Hobject Character, Hobject Image, const HTuple& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Class, HTuple* Confidence)

HTuple HRegion::DoOcrSingleClassKnn(const HImage& Image, const HOCRKnn& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Confidence) const

HTuple HOCRKnn::DoOcrSingleClassKnn(const HRegion& Character, const HImage& Image, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Confidence) const

void DoOcrSingleClassKnn(const HObject& Character, const HObject& Image, const HTuple& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Class, HTuple* Confidence)

HTuple HRegion::DoOcrSingleClassKnn(const HImage& Image, const HOCRKnn& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Confidence) const

HString HRegion::DoOcrSingleClassKnn(const HImage& Image, const HOCRKnn& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, double* Confidence) const

HTuple HOCRKnn::DoOcrSingleClassKnn(const HRegion& Character, const HImage& Image, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Confidence) const

HString HOCRKnn::DoOcrSingleClassKnn(const HRegion& Character, const HImage& Image, const HTuple& NumClasses, const HTuple& NumNeighbors, double* Confidence) const

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

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

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

static void HOperatorSet.DoOcrSingleClassKnn(HObject character, HObject image, HTuple OCRHandle, HTuple numClasses, HTuple numNeighbors, out HTuple classVal, out HTuple confidence)

HTuple HRegion.DoOcrSingleClassKnn(HImage image, HOCRKnn OCRHandle, HTuple numClasses, HTuple numNeighbors, out HTuple confidence)

string HRegion.DoOcrSingleClassKnn(HImage image, HOCRKnn OCRHandle, HTuple numClasses, HTuple numNeighbors, out double confidence)

HTuple HOCRKnn.DoOcrSingleClassKnn(HRegion character, HImage image, HTuple numClasses, HTuple numNeighbors, out HTuple confidence)

string HOCRKnn.DoOcrSingleClassKnn(HRegion character, HImage image, HTuple numClasses, HTuple numNeighbors, out double confidence)

Description

do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn uses the OCR-k-NN classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle to determine the best training samples for the features of the character given by the region CharacterCharacterCharacterCharacterCharactercharacter and the gray values ImageImageImageImageImageimage and returns their classes in ClassClassClassClassClassclassVal and the corresponding confidences in ConfidenceConfidenceConfidenceConfidenceConfidenceconfidence. If the first NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors training vectors have different classes, maximally NumClassesNumClassesNumClassesNumClassesNumClassesnumClasses classes are returned sorted by frequency and weighted distance. The confidences lie between 0.0 and 1.0. The larger the value, the more reliable is the classification. The confidence can be only computed robustly if NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors is large enough.

Because multiple classes may be returned by do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn, CharacterCharacterCharacterCharacterCharactercharacter may only contain a single region (a single character). If multiple characters should be classified in a single call, do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn must be used. Before calling do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn, the classifier must be trained with trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn or select_feature_set_trainf_knnselect_feature_set_trainf_knnSelectFeatureSetTrainfKnnselect_feature_set_trainf_knnSelectFeatureSetTrainfKnnSelectFeatureSetTrainfKnn. If all NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors neighbors are of the same class, only one class is returned.

Parallelization

Parameters

CharacterCharacterCharacterCharacterCharactercharacter (input_object)  region objectHRegionHRegionHRegionHRegionXHobject

Character to be recognized.

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / uint2)

Gray values of the character.

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

Handle of the k-NN classifier.

NumClassesNumClassesNumClassesNumClassesNumClassesnumClasses (input_control)  integer-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of maximal classes to determine.

Default value: 1

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

NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors (input_control)  integer-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of neighbors to consider.

Default value: 1

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

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

Results of classifying the character with the k-NN.

ConfidenceConfidenceConfidenceConfidenceConfidenceconfidence (output_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

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

Result

If the parameters are valid, the operator do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn 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_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn

See also

create_ocr_class_knncreate_ocr_class_knnCreateOcrClassKnncreate_ocr_class_knnCreateOcrClassKnnCreateOcrClassKnn, classify_class_knnclassify_class_knnClassifyClassKnnclassify_class_knnClassifyClassKnnClassifyClassKnn

Module

OCR/OCV


ClassesClassesClassesClasses | | | | Operators