ClassesClassesClassesClasses | | | | Operators

trainf_ocr_class_knnT_trainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn (Operator)

Name

trainf_ocr_class_knnT_trainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn — Trains an k-NN classifier for an OCR task.

Signature

trainf_ocr_class_knn( : : OCRHandle, TrainingFile, GenParamName, GenParamValue : )

Herror T_trainf_ocr_class_knn(const Htuple OCRHandle, const Htuple TrainingFile, const Htuple GenParamName, const Htuple GenParamValue)

Herror trainf_ocr_class_knn(const HTuple& OCRHandle, const HTuple& TrainingFile, const HTuple& GenParamName, const HTuple& GenParamValue)

void HOCRKnn::TrainfOcrClassKnn(const HTuple& TrainingFile, const HTuple& GenParamName, const HTuple& GenParamValue) const

void TrainfOcrClassKnn(const HTuple& OCRHandle, const HTuple& TrainingFile, const HTuple& GenParamName, const HTuple& GenParamValue)

void HOCRKnn::TrainfOcrClassKnn(const HTuple& TrainingFile, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HOCRKnn::TrainfOcrClassKnn(const HString& TrainingFile, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HOCRKnn::TrainfOcrClassKnn(const char* TrainingFile, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HOperatorSetX.TrainfOcrClassKnn(
[in] VARIANT OCRHandle, [in] VARIANT TrainingFile, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

void HOCRKnnX.TrainfOcrClassKnn(
[in] VARIANT TrainingFile, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

static void HOperatorSet.TrainfOcrClassKnn(HTuple OCRHandle, HTuple trainingFile, HTuple genParamName, HTuple genParamValue)

void HOCRKnn.TrainfOcrClassKnn(HTuple trainingFile, HTuple genParamName, HTuple genParamValue)

void HOCRKnn.TrainfOcrClassKnn(string trainingFile, HTuple genParamName, HTuple genParamValue)

Description

trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn trains the k-NN classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle with the training characters stored in the OCR training files given by TrainingFileTrainingFileTrainingFileTrainingFileTrainingFiletrainingFile. The training files must have been created, e.g., using write_ocr_trainfwrite_ocr_trainfWriteOcrTrainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainf, before calling trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn. Please, note that training characters that have no corresponding class in the classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle are discarded.

It is possible to set the number of trees via the parameters GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName and GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue by 'num_trees'"num_trees""num_trees""num_trees""num_trees""num_trees". The default value for the number of search trees is 4. A higher number of trees improves the accuracy of the search, but also increases the runtime. Normalization can be activated by setting 'normalization'"normalization""normalization""normalization""normalization""normalization" in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName and and 'true'"true""true""true""true""true" in GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue. This will change the stored training data permanently. Therefore, adding data after the training is not possible.

Parallelization

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

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

Handle of the k-NN classifier.

TrainingFileTrainingFileTrainingFileTrainingFileTrainingFiletrainingFile (input_control)  filename.read(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Names of the training files.

Default value: 'ocr.trf' "ocr.trf" "ocr.trf" "ocr.trf" "ocr.trf" "ocr.trf"

File extension: .trf, .otr

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  string-array HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Names of the generic parameters that can be adjusted for the k-NN classifier creation.

Default value: []

List of values: 'normalization'"normalization""normalization""normalization""normalization""normalization", 'num_trees'"num_trees""num_trees""num_trees""num_trees""num_trees"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  number-array HTupleHTupleHTupleVARIANTHtuple (integer / string / real) (int / long / string / double) (Hlong / HString / double) (Hlong / char* / double) (Hlong / BSTR / double) (Hlong / char* / double)

Values of the generic parameters that can be adjusted for the k-NN classifier creation.

Default value: []

Suggested values: 4, 5, 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

Example (HDevelop)

* Train an OCR classifier
read_ocr_trainf_names ('ocr.trf', CharacterNames, CharacterCount)
create_ocr_class_knn (8, 10, 'constant', 'default', CharacterNames, [],\
                      [], OCRHandle)
trainf_ocr_class_knn (OCRHandle, 'ocr.trf', [], [])
write_ocr_class_knn (OCRHandle, 'ocr.omc')
clear_ocr_class_knn (OCRHandle)

Result

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

Possible Predecessors

create_ocr_class_knncreate_ocr_class_knnCreateOcrClassKnncreate_ocr_class_knnCreateOcrClassKnnCreateOcrClassKnn, write_ocr_trainfwrite_ocr_trainfWriteOcrTrainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainf, append_ocr_trainfappend_ocr_trainfAppendOcrTrainfappend_ocr_trainfAppendOcrTrainfAppendOcrTrainf, write_ocr_trainf_imagewrite_ocr_trainf_imageWriteOcrTrainfImagewrite_ocr_trainf_imageWriteOcrTrainfImageWriteOcrTrainfImage

Possible Successors

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

Alternatives

read_ocr_class_knnread_ocr_class_knnReadOcrClassKnnread_ocr_class_knnReadOcrClassKnnReadOcrClassKnn

See also

train_class_knntrain_class_knnTrainClassKnntrain_class_knnTrainClassKnnTrainClassKnn

Module

OCR/OCV


ClassesClassesClassesClasses | | | | Operators