Operator Reference

read_deep_counting_modelT_read_deep_counting_modelReadDeepCountingModelReadDeepCountingModelread_deep_counting_model (Operator)

read_deep_counting_modelT_read_deep_counting_modelReadDeepCountingModelReadDeepCountingModelread_deep_counting_model — Read a Deep Counting model from a file.

Signature

read_deep_counting_model( : : FileName : DeepCountingHandle)

Herror T_read_deep_counting_model(const Htuple FileName, Htuple* DeepCountingHandle)

void ReadDeepCountingModel(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)

void HDlModelCounting::ReadDeepCountingModel(const HString& FileName)

void HDlModelCounting::ReadDeepCountingModel(const char* FileName)

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

static void HOperatorSet.ReadDeepCountingModel(HTuple fileName, out HTuple deepCountingHandle)

public HDlModelCounting(string fileName)

void HDlModelCounting.ReadDeepCountingModel(string fileName)

def read_deep_counting_model(file_name: str) -> HHandle

Description

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

The model is loaded from the file FileNameFileNameFileNamefileNamefile_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_modelwrite_deep_counting_modelWriteDeepCountingModelWriteDeepCountingModelwrite_deep_counting_model. As a consequence when reading a model these parameters are initialized with their default value, see get_deep_counting_model_paramget_deep_counting_model_paramGetDeepCountingModelParamGetDeepCountingModelParamget_deep_counting_model_param.

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

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.read HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Filename

File extension: .hdc

DeepCountingHandleDeepCountingHandleDeepCountingHandledeepCountingHandledeep_counting_handle (output_control)  deep_counting HDlModelCounting, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the Deep Counting model.

Result

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

Possible Predecessors

create_deep_counting_modelcreate_deep_counting_modelCreateDeepCountingModelCreateDeepCountingModelcreate_deep_counting_model

Possible Successors

set_deep_counting_model_paramset_deep_counting_model_paramSetDeepCountingModelParamSetDeepCountingModelParamset_deep_counting_model_param, get_deep_counting_model_paramget_deep_counting_model_paramGetDeepCountingModelParamGetDeepCountingModelParamget_deep_counting_model_param, prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model, apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model

Alternatives

create_deep_counting_modelcreate_deep_counting_modelCreateDeepCountingModelCreateDeepCountingModelcreate_deep_counting_model

Module

Matching