ClassesClassesClassesClasses | | | | Operators

trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox (Operator)

Name

trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox — Train an OCR classifier with the help of a training file.

Signature

trainf_ocr_class_box( : : OcrHandle, TrainingFile : AvgConfidence)

Herror trainf_ocr_class_box(const Hlong OcrHandle, const char* TrainingFile, double* AvgConfidence)

Herror T_trainf_ocr_class_box(const Htuple OcrHandle, const Htuple TrainingFile, Htuple* AvgConfidence)

Herror trainf_ocr_class_box(const HTuple& OcrHandle, const HTuple& TrainingFile, double* AvgConfidence)

double HOCRBox::TrainfOcrClassBox(const HTuple& TrainingFile) const

void TrainfOcrClassBox(const HTuple& OcrHandle, const HTuple& TrainingFile, HTuple* AvgConfidence)

double HOCRBox::TrainfOcrClassBox(const HTuple& TrainingFile) const

double HOCRBox::TrainfOcrClassBox(const HString& TrainingFile) const

double HOCRBox::TrainfOcrClassBox(const char* TrainingFile) const

void HOperatorSetX.TrainfOcrClassBox(
[in] VARIANT OcrHandle, [in] VARIANT TrainingFile, [out] VARIANT* AvgConfidence)

double HOCRBoxX.TrainfOcrClassBox([in] VARIANT TrainingFile)

static void HOperatorSet.TrainfOcrClassBox(HTuple ocrHandle, HTuple trainingFile, out HTuple avgConfidence)

double HOCRBox.TrainfOcrClassBox(HTuple trainingFile)

double HOCRBox.TrainfOcrClassBox(string trainingFile)

Description

The operator trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox trains the classifier OcrHandleOcrHandleOcrHandleOcrHandleOcrHandleocrHandle via the indicated training files. Any number of files can be indicated. The parameter AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidence provides information about the success of the training: It contains the average confidence of the trained characters measured by a re-classification. The confidence of mismatched characters is set to 0 (thus, the average confidence will be decreased significantly). Please, note that training characters that have no corresponding class in the classifier OcrHandleOcrHandleOcrHandleOcrHandleOcrHandleocrHandle are discarded.

Attention

The names of the characters in the file must fit the network.

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_box HOCRBox, HTupleHTupleHOCRBox, HTupleHOCRBoxX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

ID of the desired OCR-network.

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

Names of the training files.

Default value: 'train_ocr' "train_ocr" "train_ocr" "train_ocr" "train_ocr" "train_ocr"

File extension: .trf, .otr

AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidence (output_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Average confidence during a re-classification of the trained characters.

Example (C)

HTuple  TrainingFile, OcrHandle, AvgConfidence;
T_create_ocr_class_box(WidthPattern,HeightPattern,Interpolation,
                    Features,\Character,&OcrHandle);
create_tuple(&TrainingFile,2);
set_s(TrainingFile,"data1",0);
set_s(TrainingFile,"data2",1);
T_trainf_ocr_class_box(OcrHandle,TrainingFile,&AvgConfidence);

Result

If the file name is correct and the data fit the network, the operator trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox returns the value 2 (H_MSG_TRUE). Otherwise an exception will be raised.

Possible Predecessors

create_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBox, read_ocrread_ocrReadOcrread_ocrReadOcrReadOcr

Possible Successors

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox, write_ocrwrite_ocrWriteOcrwrite_ocrWriteOcrWriteOcr, do_ocr_multido_ocr_multiDoOcrMultido_ocr_multiDoOcrMultiDoOcrMulti, do_ocr_singledo_ocr_singleDoOcrSingledo_ocr_singleDoOcrSingleDoOcrSingle

Alternatives

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox

Module

OCR/OCV


ClassesClassesClassesClasses | | | | Operators