traind_ocv_projT_traind_ocv_projTraindOcvProjTraindOcvProj (Operator)

Name

traind_ocv_projT_traind_ocv_projTraindOcvProjTraindOcvProj — Training of an OCV tool.

Signature

Description

traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj trains patterns for an OCV tool that has been created using the operators create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProj or read_ocvread_ocvReadOcvReadOcvReadOcv. For this training one or multiple patterns are provided to the system. Such a pattern consists of an image with a reduced domain (ROI) for the area of the pattern. Note that the pattern should not only contain foreground pixels (e.g. dark pixels of a character) but also background pixels. This can be implemented e.g. by the smallest surrounding rectangle of the pattern. Without this context an evaluation of the pattern is not possible.

If more than one pattern has to be trained this can be achieved by multiple calls (one for each pattern) or by calling traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj once with all patterns and a tuple of the corresponding names. The result will be in both cases the same. However using multiple calls will normally result in a longer execution time than using one call with all patterns.

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:

• OCVHandleOCVHandleOCVHandleOCVHandleOCVHandle

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

Parameters

Example (C++ (HALCON 5.0-10.0))

create_ocv_proj("A",&ocv_handle);
draw_region(&ROI,window_handle);
reduce_domain(Image,ROI,&Sample);
traind_ocv_proj(Sample,ocv_handle,"A","single");

Result

traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj returns 2 (H_MSG_TRUE), if the handle and the training pattern(s) are correct. Otherwise, an exception is raised.

Possible Predecessors

write_ocr_trainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainfWriteOcrTrainf, create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProj, read_ocvread_ocvReadOcvReadOcvReadOcv, thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, select_shapeselect_shapeSelectShapeSelectShapeSelectShape

Possible Successors

close_ocvclose_ocvCloseOcvCloseOcvCloseOcv

See also

traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxTraindOcrClassBox

Module

OCR/OCV