Skip to content

read_deep_counting_modelReadDeepCountingModelReadDeepCountingModelread_deep_counting_modelT_read_deep_counting_model🔗

Short description🔗

read_deep_counting_modelReadDeepCountingModelReadDeepCountingModelread_deep_counting_modelT_read_deep_counting_model — Read a Deep Counting model from a file.

Signature🔗

read_deep_counting_model( filename.read FileName, out deep_counting DeepCountingHandle )void ReadDeepCountingModel( const HTuple& FileName, HTuple* DeepCountingHandle )static void HOperatorSet.ReadDeepCountingModel( HTuple fileName, out HTuple deepCountingHandle )def read_deep_counting_model( file_name: str ) -> HHandle

Herror T_read_deep_counting_model( const Htuple FileName, Htuple* DeepCountingHandle )

void HDlModelCounting::HDlModelCounting( const HString& FileName )

void HDlModelCounting::HDlModelCounting( const char* FileName )

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

public HDlModelCounting( string fileName )

void HDlModelCounting::ReadDeepCountingModel( const HString& FileName )

void HDlModelCounting::ReadDeepCountingModel( const char* FileName )

void HDlModelCounting::ReadDeepCountingModel( const wchar_t* FileName ) (Windows only)

void HDlModelCounting.ReadDeepCountingModel( string fileName )

Description🔗

The operator read_deep_counting_modelReadDeepCountingModel reads a Deep Counting model. Such models have to be in the HALCON format. As a result, the handle DeepCountingHandledeepCountingHandledeep_counting_handle is returned.

The model is loaded from the file FileNamefileNamefile_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 Counting models is '.hdc'.

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

Execution information🔗

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🔗

FileNamefileNamefile_name (input_control) filename.read → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Filename

File extension: .hdc

DeepCountingHandledeepCountingHandledeep_counting_handle (output_control) deep_counting → (handle)HTuple (HHandle)HDlModelCounting, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the Deep Counting model.

Result🔗

If the parameters are valid, the operator read_deep_counting_modelReadDeepCountingModel returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

create_deep_counting_modelCreateDeepCountingModel

Possible successors

set_deep_counting_model_paramSetDeepCountingModelParam, get_deep_counting_model_paramGetDeepCountingModelParam, prepare_deep_counting_modelPrepareDeepCountingModel, apply_deep_counting_modelApplyDeepCountingModel

Alternatives

create_deep_counting_modelCreateDeepCountingModel

Module🔗

Matching