trainf_ocr_class_boxT_trainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box (Operator)
Name
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_boxTrainfOcrClassBoxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_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
Description
The operator trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box trains the classifier
OcrHandleOcrHandleOcrHandleOcrHandleocrHandleocr_handle via the indicated training files.
Any number of files can be indicated. The parameter AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidenceavg_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 OcrHandleOcrHandleOcrHandleOcrHandleocrHandleocr_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:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
OcrHandleOcrHandleOcrHandleOcrHandleocrHandleocr_handle (input_control, state is modified) ocr_box → HOCRBox, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
ID of the desired OCR-network.
TrainingFileTrainingFileTrainingFileTrainingFiletrainingFiletraining_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"
"train_ocr"
File extension:
.trf, .otr
AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidenceavg_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_boxTrainfOcrClassBoxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box returns the value
2 (
H_MSG_TRUE)
.
Otherwise an exception will be raised.
Possible Predecessors
create_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBoxCreateOcrClassBoxcreate_ocr_class_box,
read_ocrread_ocrReadOcrReadOcrReadOcrread_ocr
Possible Successors
traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box,
write_ocrwrite_ocrWriteOcrWriteOcrWriteOcrwrite_ocr,
do_ocr_multido_ocr_multiDoOcrMultiDoOcrMultiDoOcrMultido_ocr_multi,
do_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingleDoOcrSingledo_ocr_single
Alternatives
traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box
Module
OCR/OCV