trainf_ocr_class_box🔗
Short description🔗
trainf_ocr_class_box — Train an OCR classifier with the help of a training file.
Warning🔗
trainf_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( ocr_box OcrHandle, filename.read TrainingFile, out real AvgConfidence )
Description🔗
The operator trainf_ocr_class_box trains the classifier
OcrHandle via the indicated training files.
Any number of files can be indicated. The parameter AvgConfidence
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 OcrHandle are discarded.
Attention🔗
The names of the characters in the file must fit the network.
Execution information🔗
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🔗
OcrHandle (input_control, state is modified) ocr_box → (handle)
ID of the desired OCR-network.
TrainingFile (input_control) filename.read(-array) → (string)
Names of the training files.
Default: 'train_ocr'
File extension: .trf, .otr
AvgConfidence (output_control) real → (real)
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_box returns the value
2 (H_MSG_TRUE).
Otherwise an exception will be raised.
Combinations with other operators🔗
Combinations
Possible predecessors
create_ocr_class_box, read_ocr
Possible successors
traind_ocr_class_box, write_ocr, do_ocr_multi, do_ocr_single
Alternatives
Module🔗
OCR/OCV