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

append_ocr_trainfappend_ocr_trainfappend_ocr_trainfAppendOcrTrainfAppendOcrTrainf (Operator)

Name

append_ocr_trainfappend_ocr_trainfappend_ocr_trainfAppendOcrTrainfAppendOcrTrainf — Add characters to a training file.

Signature

append_ocr_trainf(Character, Image : : Class, FileName : )

Herror append_ocr_trainf(const Hobject Character, const Hobject Image, const char* Class, const char* FileName)

Herror T_append_ocr_trainf(const Hobject Character, const Hobject Image, const Htuple Class, const Htuple FileName)

Herror append_ocr_trainf(Hobject Character, Hobject Image, const HTuple& Class, const HTuple& FileName)

void HRegion::AppendOcrTrainf(const HImage& Image, const HTuple& Class, const HTuple& FileName) const

void HRegionArray::AppendOcrTrainf(const HImage& Image, const HTuple& Class, const HTuple& FileName) const

void HOperatorSetX.AppendOcrTrainf(
[in] IHUntypedObjectX* Character, [in] IHUntypedObjectX* Image, [in] VARIANT Class, [in] VARIANT FileName)

void HRegionX.AppendOcrTrainf(
[in] IHImageX* Image, [in] VARIANT Class, [in] BSTR FileName)

static void HOperatorSet.AppendOcrTrainf(HObject character, HObject image, HTuple classVal, HTuple fileName)

void HRegion.AppendOcrTrainf(HImage image, HTuple classVal, string fileName)

void HRegion.AppendOcrTrainf(HImage image, string classVal, string fileName)

Description

The operator append_ocr_trainfappend_ocr_trainfappend_ocr_trainfAppendOcrTrainfAppendOcrTrainf serves to prepare the training with the operator trainf_ocr_class_mlptrainf_ocr_class_mlptrainf_ocr_class_mlpTrainfOcrClassMlpTrainfOcrClassMlp, trainf_ocr_class_svmtrainf_ocr_class_svmtrainf_ocr_class_svmTrainfOcrClassSvmTrainfOcrClassSvm, or trainf_ocr_class_boxtrainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox. Hereby regions, representing characters, including their gray values (region and pixel) and the corresponding class name will be written into a file. An arbitrary number of regions within one image is supported. For each character (region) in CharacterCharacterCharacterCharactercharacter the corresponding class name must be specified in ClassClassClassClassclassVal. The gray values are passed via the parameter ImageImageImageImageimage. In contrast to the operator write_ocr_trainfwrite_ocr_trainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainf the characters are appended to an existing file using the same training file format as this file. If the file does not exist, a new file is generated. In this case, the file format can be chosen by the parameter 'ocr_trainf_version'"ocr_trainf_version""ocr_trainf_version""ocr_trainf_version""ocr_trainf_version" of the operator set_systemset_systemset_systemSetSystemSetSystem. If no file extension is specified in FileNameFileNameFileNameFileNamefileName, the extension '.trf' is appended to the name.

Parallelization

Parameters

CharacterCharacterCharacterCharactercharacter (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Characters to be trained.

ImageImageImageImageimage (input_object)  image objectHImageHImageHImageXHobject (byte / uint2)

Gray values of the characters.

ClassClassClassClassclassVal (input_control)  string(-array) HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Class (name) of the characters.

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name of the training file.

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

File extension: .trf

Example (C)

char       name[128];
char       class[128];

read_image(&Image,"character.tiff");
bin_threshold(Image,&Dark);
connection(Dark,&Character);
count_obj(Character,&num);
create_tuple(&Class,num);
open_window(0,0,-1,-1,0,"","",&WindowHandle);
set_color(WindowHandle,"red");
for (i=0; i<num; i++) {
  select_obj(Character,&SingleCharacter,i);
  clear_window(WindowHandle);
  disp_region(SingleCharacter,WindowHandle);
  printf("class of character %d ?\n",i);
  scanf("%s\n",class);
  append_ocr_trainf(Character,Image,name,class);
}

Result

If the parameters are correct, the operator append_ocr_trainfappend_ocr_trainfappend_ocr_trainfAppendOcrTrainfAppendOcrTrainf returns the value 2 (H_MSG_TRUE). Otherwise an exception will be raised.

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, connectionconnectionconnectionConnectionConnection, create_ocr_class_boxcreate_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBox, read_ocrread_ocrread_ocrReadOcrReadOcr

Possible Successors

trainf_ocr_class_mlptrainf_ocr_class_mlptrainf_ocr_class_mlpTrainfOcrClassMlpTrainfOcrClassMlp, trainf_ocr_class_svmtrainf_ocr_class_svmtrainf_ocr_class_svmTrainfOcrClassSvmTrainfOcrClassSvm, trainf_ocr_class_boxtrainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox, info_ocr_class_boxinfo_ocr_class_boxinfo_ocr_class_boxInfoOcrClassBoxInfoOcrClassBox, write_ocrwrite_ocrwrite_ocrWriteOcrWriteOcr, do_ocr_multido_ocr_multido_ocr_multiDoOcrMultiDoOcrMulti, do_ocr_singledo_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingle

Alternatives

write_ocr_trainfwrite_ocr_trainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainf, write_ocr_trainf_imagewrite_ocr_trainf_imagewrite_ocr_trainf_imageWriteOcrTrainfImageWriteOcrTrainfImage

Module

OCR/OCV


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