create_deep_ocrT_create_deep_ocrCreateDeepOcrCreateDeepOcrcreate_deep_ocr (Operator)
名称
create_deep_ocrT_create_deep_ocrCreateDeepOcrCreateDeepOcrcreate_deep_ocr — 创建深度 OCR 模型。
签名
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)
描述
create_deep_ocrcreate_deep_ocrCreateDeepOcrCreateDeepOcrCreateDeepOcrcreate_deep_ocr creates a Deep OCR model out of pretrained components
and returns its handle in DeepOcrHandleDeepOcrHandleDeepOcrHandleDeepOcrHandledeepOcrHandledeep_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 GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and according
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value:
- 'mode'"mode""mode""mode""mode""mode":
-
Specify a mode and with it, which component is
executed. Supported values:
- 'detection'"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""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""auto":
Perform both parts, detection of the words and their
recognition.
默认值：
'auto'"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_paramGetDeepOcrParamGetDeepOcrParamGetDeepOcrParamget_deep_ocr_param with
'recognition_alphabet'"recognition_alphabet""recognition_alphabet""recognition_alphabet""recognition_alphabet""recognition_alphabet".
To get an overview of the Deep OCR workflow see OCR / Deep OCR.
执行信息
- 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.
参数
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name of the generic parameter.
默认值：
[]
值列表：
'mode'"mode""mode""mode""mode""mode"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_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.
默认值：
[]
值列表：
'auto'"auto""auto""auto""auto""auto", 'detection'"detection""detection""detection""detection""detection", 'recognition'"recognition""recognition""recognition""recognition""recognition"
DeepOcrHandleDeepOcrHandleDeepOcrHandleDeepOcrHandledeepOcrHandledeep_ocr_handle (output_control) deep_ocr → HDlModelOcr, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the Deep OCR model.
结果
If the parameters are valid, the operator create_deep_ocrcreate_deep_ocrCreateDeepOcrCreateDeepOcrCreateDeepOcrcreate_deep_ocr
returns the value 2 (
H_MSG_TRUE)
. If necessary, an exception is raised.
可能的后继算子
write_deep_ocrwrite_deep_ocrWriteDeepOcrWriteDeepOcrWriteDeepOcrwrite_deep_ocr,
apply_deep_ocrapply_deep_ocrApplyDeepOcrApplyDeepOcrApplyDeepOcrapply_deep_ocr,
get_deep_ocr_paramget_deep_ocr_paramGetDeepOcrParamGetDeepOcrParamGetDeepOcrParamget_deep_ocr_param,
set_deep_ocr_paramset_deep_ocr_paramSetDeepOcrParamSetDeepOcrParamSetDeepOcrParamset_deep_ocr_param
模块
OCR/OCV