create_deep_ocrT_create_deep_ocrCreateDeepOcrCreateDeepOcrcreate_deep_ocr (Operator)
Name
create_deep_ocrT_create_deep_ocrCreateDeepOcrCreateDeepOcrcreate_deep_ocr — Create a Deep OCR model.
Signature
void CreateDeepOcr(const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* DeepOcrHandle)
void HDlModelOcr::HDlModelOcr(const HTuple& GenParamName, const HTuple& GenParamValue)
void HDlModelOcr::HDlModelOcr(const HString& GenParamName, const HString& GenParamValue)
void HDlModelOcr::HDlModelOcr(const char* GenParamName, const char* GenParamValue)
void HDlModelOcr::HDlModelOcr(const wchar_t* GenParamName, const wchar_t* GenParamValue)
(
Windows only)
void HDlModelOcr::CreateDeepOcr(const HTuple& GenParamName, const HTuple& GenParamValue)
void HDlModelOcr::CreateDeepOcr(const HString& GenParamName, const HString& GenParamValue)
void HDlModelOcr::CreateDeepOcr(const char* GenParamName, const char* GenParamValue)
void HDlModelOcr::CreateDeepOcr(const wchar_t* GenParamName, const wchar_t* GenParamValue)
(
Windows only)
Description
create_deep_ocrcreate_deep_ocrCreateDeepOcrCreateDeepOcrcreate_deep_ocr creates a Deep OCR model out of pretrained components
and returns its handle in DeepOcrHandleDeepOcrHandleDeepOcrHandledeepOcrHandledeep_ocr_handle.
The handle states all parameters needed to run an inference.
A Deep OCR model usually consists of two components that are searched in the
directory $HALCONROOT/dl/ by default:
The following options may be set using GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and according
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value:
- 'mode'"mode""mode""mode""mode":
-
Specify a mode and with it, which component is
executed. Supported values:
- 'detection'"detection""detection""detection""detection":
Perform only the detection part.
Hence, the model will merely localize the word regions within the image.
- 'recognition'"recognition""recognition""recognition""recognition":
Perform only the recognition part.
Hence, the model requires that the image contains solely a tight crop of
the word.
- 'auto'"auto""auto""auto""auto":
Perform both parts, detection of the words and their
recognition.
Default:
'auto'"auto""auto""auto""auto".
The character set, which the model can recognize through its recognition
component, can be retrieved using get_deep_ocr_paramget_deep_ocr_paramGetDeepOcrParamGetDeepOcrParamget_deep_ocr_param with
'recognition_alphabet'"recognition_alphabet""recognition_alphabet""recognition_alphabet""recognition_alphabet".
To get an overview of the Deep OCR workflow see OCR / Deep OCR.
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 returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Parameters
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name of the generic parameter.
Default:
[]
List of values:
'mode'"mode""mode""mode""mode"
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Value of the generic parameter.
Default:
[]
List of values:
'auto'"auto""auto""auto""auto", 'detection'"detection""detection""detection""detection", 'recognition'"recognition""recognition""recognition""recognition"
DeepOcrHandleDeepOcrHandleDeepOcrHandledeepOcrHandledeep_ocr_handle (output_control) deep_ocr → HDlModelOcr, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the Deep OCR model.
Result
If the parameters are valid, the operator create_deep_ocrcreate_deep_ocrCreateDeepOcrCreateDeepOcrcreate_deep_ocr
returns the value 2 (
H_MSG_TRUE)
. If necessary, an exception is raised.
Possible Successors
write_deep_ocrwrite_deep_ocrWriteDeepOcrWriteDeepOcrwrite_deep_ocr,
apply_deep_ocrapply_deep_ocrApplyDeepOcrApplyDeepOcrapply_deep_ocr,
get_deep_ocr_paramget_deep_ocr_paramGetDeepOcrParamGetDeepOcrParamget_deep_ocr_param,
set_deep_ocr_paramset_deep_ocr_paramSetDeepOcrParamSetDeepOcrParamset_deep_ocr_param
Module
OCR/OCV