Operator Reference

HALCON Operator Reference / Legacy / OCR

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

trainf_ocr_class_boxT_trainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box (Operator)

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

Warning

trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box is obsolete and is only provided for reasons of backward compatibility. New applications should use the MLP, SVM or CNN based operators instead.

Signature

trainf_ocr_class_box( : : OcrHandle, TrainingFile : AvgConfidence)

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

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

double HOCRBox::TrainfOcrClassBox(const wchar_t* TrainingFile) const   ( Windows only)

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

double HOCRBox.TrainfOcrClassBox(HTuple trainingFile)

double HOCRBox.TrainfOcrClassBox(string trainingFile)

def trainf_ocr_class_box(ocr_handle: HHandle, training_file: MaybeSequence[str]) -> float

Description

The operator trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box trains the classifier OcrHandleOcrHandleOcrHandleocrHandleocr_handle via the indicated training files. Any number of files can be indicated. The parameter AvgConfidenceAvgConfidenceAvgConfidenceavgConfidenceavg_confidence 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 OcrHandleOcrHandleOcrHandleocrHandleocr_handle are discarded.

Attention

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

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• OcrHandleOcrHandleOcrHandleocrHandleocr_handle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

OcrHandleOcrHandleOcrHandleocrHandleocr_handle (input_control, state is modified)  ocr_box → HOCRBox, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

ID of the desired OCR-network.

TrainingFileTrainingFileTrainingFiletrainingFiletraining_file (input_control)  filename.read(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Names of the training files.

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

File extension: .trf, .otr

AvgConfidenceAvgConfidenceAvgConfidenceavgConfidenceavg_confidence (output_control)  real → HTuplefloatHTupleHtuple (real) (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_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box returns the value 2 ( H_MSG_TRUE) . Otherwise an exception will be raised.

Possible Predecessors

create_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBoxcreate_ocr_class_box, read_ocrread_ocrReadOcrReadOcrread_ocr

Possible Successors

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box, write_ocrwrite_ocrWriteOcrWriteOcrwrite_ocr, do_ocr_multido_ocr_multiDoOcrMultiDoOcrMultido_ocr_multi, do_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingledo_ocr_single

Alternatives

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box

Module

OCR/OCV

---

ClassesClasses | | Operators