HALCON Reference Manual 10.0.2
Table of Contents / OCR / Hyperboxes ClassesClassesClasses | | | Operators

trainf_ocr_class_boxtrainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox (Operator)

Name

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

Signature

trainf_ocr_class_box( : : OcrHandle, FileName : AvgConfidence)

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

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

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

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

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

double HOCRBoxX.TrainfOcrClassBox([in] VARIANT FileName)

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

double HOCRBox.TrainfOcrClassBox(HTuple fileName)

double HOCRBox.TrainfOcrClassBox(string fileName)

Description

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

Attention

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

Parallelization

Parameters

OcrHandleOcrHandleOcrHandleOcrHandleocrHandle (input_control)  ocr_box → HOCRBox, HTupleHOCRBox, HTupleHOCRBoxX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

ID of the desired OCR-network.

FileNameFileNameFileNameFileNamefileName (input_control)  filename.read(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name(s) of the training file(s).

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

File extension: .trf

AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidence (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

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

Example (C)

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

Result

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

Possible Predecessors

create_ocr_class_boxcreate_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBox, read_ocrread_ocrread_ocrReadOcrReadOcr

Possible Successors

traind_ocr_class_boxtraind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox, write_ocrwrite_ocrwrite_ocrWriteOcrWriteOcr, do_ocr_multido_ocr_multido_ocr_multiDoOcrMultiDoOcrMulti, do_ocr_singledo_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingle

Alternatives

traind_ocr_class_boxtraind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox

Module

OCR/OCV

Table of Contents / OCR / Hyperboxes ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH