HALCON Website / HALCON Operator Reference / OCR / Hyperboxes
ClassesClassesClassesClasses | | | | Operators

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox (Operator)

Name

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox — Train an OCR classifier by the input of regions.

Signature

traind_ocr_class_box(Character, Image : : OcrHandle, Class : AvgConfidence)

Herror traind_ocr_class_box(const Hobject Character, const Hobject Image, const Hlong OcrHandle, const char* Class, double* AvgConfidence)

Herror T_traind_ocr_class_box(const Hobject Character, const Hobject Image, const Htuple OcrHandle, const Htuple Class, Htuple* AvgConfidence)

Herror traind_ocr_class_box(Hobject Character, Hobject Image, const HTuple& OcrHandle, const HTuple& Class, double* AvgConfidence)

double HRegion::TraindOcrClassBox(const HImage& Image, const HOCRBox& OcrHandle, const HTuple& Class) const

double HRegionArray::TraindOcrClassBox(const HImage& Image, const HOCRBox& OcrHandle, const HTuple& Class) const

double HOCRBox::TraindOcrClassBox(const HRegionArray& Character, const HImage& Image, const HTuple& Class) const

void TraindOcrClassBox(const HObject& Character, const HObject& Image, const HTuple& OcrHandle, const HTuple& Class, HTuple* AvgConfidence)

double HRegion::TraindOcrClassBox(const HImage& Image, const HOCRBox& OcrHandle, const HTuple& Class) const

double HRegion::TraindOcrClassBox(const HImage& Image, const HOCRBox& OcrHandle, const HString& Class) const

double HRegion::TraindOcrClassBox(const HImage& Image, const HOCRBox& OcrHandle, const char* Class) const

double HOCRBox::TraindOcrClassBox(const HRegion& Character, const HImage& Image, const HTuple& Class) const

double HOCRBox::TraindOcrClassBox(const HRegion& Character, const HImage& Image, const HString& Class) const

double HOCRBox::TraindOcrClassBox(const HRegion& Character, const HImage& Image, const char* Class) const

void HOperatorSetX.TraindOcrClassBox(
[in] IHUntypedObjectX* Character, [in] IHUntypedObjectX* Image, [in] VARIANT OcrHandle, [in] VARIANT Class, [out] VARIANT* AvgConfidence)

double HRegionX.TraindOcrClassBox(
[in] IHImageX* Image, [in] IHOCRBoxX* OcrHandle, [in] VARIANT Class)

double HOCRBoxX.TraindOcrClassBox(
[in] IHRegionX* Character, [in] IHImageX* Image, [in] VARIANT Class)

static void HOperatorSet.TraindOcrClassBox(HObject character, HObject image, HTuple ocrHandle, HTuple classVal, out HTuple avgConfidence)

double HRegion.TraindOcrClassBox(HImage image, HOCRBox ocrHandle, HTuple classVal)

double HRegion.TraindOcrClassBox(HImage image, HOCRBox ocrHandle, string classVal)

double HOCRBox.TraindOcrClassBox(HRegion character, HImage image, HTuple classVal)

double HOCRBox.TraindOcrClassBox(HRegion character, HImage image, string classVal)

Description

The operator traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBox trains the classifier directly via the input of regions in an image. Any number of regions of an image can be passed. For each character (region) in CharacterCharacterCharacterCharacterCharactercharacter the corresponding name (class) ClassClassClassClassClassclassVal must be specified. The gray values are passed in ImageImageImageImageImageimage. When the procedure has finished the parameter AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidence 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).

Parallelization

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

CharacterCharacterCharacterCharacterCharactercharacter (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Characters to be trained.

ImageImageImageImageImageimage (input_object)  singlechannelimage → objectHImageHImageHImageHImageXHobject (byte / uint2)

Gray values for the characters.

OcrHandleOcrHandleOcrHandleOcrHandleOcrHandleocrHandle (input_control, state is modified)  ocr_box → HOCRBox, HTupleHTupleHOCRBox, HTupleHOCRBoxX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

ID of the desired OCR-classifier.

ClassClassClassClassClassclassVal (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Class (name) of the characters.

Default value: 'a' "a" "a" "a" "a" "a"

AvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceAvgConfidenceavgConfidence (output_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

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

Example (C)

char name[128];
Hlong orc_handle;

read_ocr("testnet",&orc_handle);
read_image(&Image,"character.tiff");
binary_threshold(Image,&Dark, 'otsu', 'dark', &UsedThreshold);
connection(Dark,&Character);
count_obj(Character,&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",name);
  traind_ocr_class_box(SingleCharacter,Image,OcrHandle,name,&AvgConfidence);
}

Result

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

Possible Predecessors

create_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBox, read_ocrread_ocrReadOcrread_ocrReadOcrReadOcr

Possible Successors

write_ocrwrite_ocrWriteOcrwrite_ocrWriteOcrWriteOcr, do_ocr_multido_ocr_multiDoOcrMultido_ocr_multiDoOcrMultiDoOcrMulti, do_ocr_singledo_ocr_singleDoOcrSingledo_ocr_singleDoOcrSingleDoOcrSingle

Alternatives

trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBox

Module

OCR/OCV

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH