HALCON Website / HALCON Operator Reference / OCR / Deep OCR
ClassesClasses | | Operators

read_deep_ocrT_read_deep_ocrReadDeepOcrReadDeepOcrread_deep_ocr (Operator)

Name

read_deep_ocrT_read_deep_ocrReadDeepOcrReadDeepOcrread_deep_ocr — Read a Deep OCR model from a file.

Signature

read_deep_ocr( : : FileName : DeepOcrHandle)

Herror T_read_deep_ocr(const Htuple FileName, Htuple* DeepOcrHandle)

void ReadDeepOcr(const HTuple& FileName, HTuple* DeepOcrHandle)

void HDlModelOcr::HDlModelOcr(const HString& FileName)

void HDlModelOcr::HDlModelOcr(const char* FileName)

void HDlModelOcr::HDlModelOcr(const wchar_t* FileName)   (Windows only)

void HDlModelOcr::ReadDeepOcr(const HString& FileName)

void HDlModelOcr::ReadDeepOcr(const char* FileName)

void HDlModelOcr::ReadDeepOcr(const wchar_t* FileName)   (Windows only)

static void HOperatorSet.ReadDeepOcr(HTuple fileName, out HTuple deepOcrHandle)

public HDlModelOcr(string fileName)

void HDlModelOcr.ReadDeepOcr(string fileName)

def read_deep_ocr(file_name: str) -> HHandle

Description

The operator read_deep_ocrread_deep_ocrReadDeepOcrReadDeepOcrReadDeepOcrread_deep_ocr reads a Deep OCR model. Such models have to be in the HALCON format. As a result, the handle DeepOcrHandleDeepOcrHandleDeepOcrHandleDeepOcrHandledeepOcrHandledeep_ocr_handle is returned.

The model is loaded from the file FileNameFileNameFileNameFileNamefileNamefile_name. This file is thereby searched in the directory $HALCONROOT/dl/ as well as in the currently used directory. The default HALCON file extension for Deep OCR models is '.hdo'".hdo"".hdo"".hdo"".hdo"".hdo".

Please note that the values of runtime specific parameters are not written to file, see write_deep_ocrwrite_deep_ocrWriteDeepOcrWriteDeepOcrWriteDeepOcrwrite_deep_ocr. As a consequence when reading a model these parameters are initialized with their default value, see get_deep_ocr_paramget_deep_ocr_paramGetDeepOcrParamGetDeepOcrParamGetDeepOcrParamget_deep_ocr_param.

Execution Information

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

FileNameFileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Filename

File extension: .hdo

DeepOcrHandleDeepOcrHandleDeepOcrHandleDeepOcrHandledeepOcrHandledeep_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 read_deep_ocrread_deep_ocrReadDeepOcrReadDeepOcrReadDeepOcrread_deep_ocr returns the value TRUE. If necessary, an exception is raised.

Possible Successors

set_deep_ocr_paramset_deep_ocr_paramSetDeepOcrParamSetDeepOcrParamSetDeepOcrParamset_deep_ocr_param, get_deep_ocr_paramget_deep_ocr_paramGetDeepOcrParamGetDeepOcrParamGetDeepOcrParamget_deep_ocr_param, apply_deep_ocrapply_deep_ocrApplyDeepOcrApplyDeepOcrApplyDeepOcrapply_deep_ocr

Alternatives

create_deep_ocrcreate_deep_ocrCreateDeepOcrCreateDeepOcrCreateDeepOcrcreate_deep_ocr

Module

OCR/OCV

ClassesClasses | | Operators
HALCON Operator Reference 20.11.4.0 Copyright © 1996-2023 MVTec Software GmbH