Operator Reference

HALCON Operator Reference / Matching / Correlation-Based

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

set_ncc_model_paramT_set_ncc_model_paramSetNccModelParamSetNccModelParamset_ncc_model_param (Operator)

set_ncc_model_paramT_set_ncc_model_paramSetNccModelParamSetNccModelParamset_ncc_model_param — Set selected parameters of the NCC model.

Signature

set_ncc_model_param( : : ModelID, GenParamName, GenParamValue : )

Herror T_set_ncc_model_param(const Htuple ModelID, const Htuple GenParamName, const Htuple GenParamValue)

void SetNccModelParam(const HTuple& ModelID, const HTuple& GenParamName, const HTuple& GenParamValue)

void HNCCModel::SetNccModelParam(const HTuple& GenParamName, const HTuple& GenParamValue) const

static void HImage::SetNccModelParam(const HNCCModel& ModelID, const HTuple& GenParamName, const HTuple& GenParamValue)

static void HOperatorSet.SetNccModelParam(HTuple modelID, HTuple genParamName, HTuple genParamValue)

void HNCCModel.SetNccModelParam(HTuple genParamName, HTuple genParamValue)

static void HImage.SetNccModelParam(HNCCModel modelID, HTuple genParamName, HTuple genParamValue)

def set_ncc_model_param(model_id: HHandle, gen_param_name: Sequence[str], gen_param_value: Sequence[Union[float, int, str]]) -> None

Description

The operator set_ncc_model_paramset_ncc_model_paramSetNccModelParamSetNccModelParamset_ncc_model_param sets the selected parameters GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name in the NCC model ModelIDModelIDModelIDmodelIDmodel_id. The following parameters can be modified:

'timeout'"timeout""timeout""timeout""timeout"

Sets the maximum runtime of the operators used to find the NCC model ModelIDModelIDModelIDmodelIDmodel_id (using find_ncc_modelfind_ncc_modelFindNccModelFindNccModelfind_ncc_model). This is especially useful in cases where a maximum cycle time has to be ensured. The 'timeout'"timeout""timeout""timeout""timeout" must be given in milliseconds. The temporal accuracy depends on several factors including the size of the model, the speed of your computer, and the 'timer_mode'"timer_mode""timer_mode""timer_mode""timer_mode" set via set_systemset_systemSetSystemSetSystemset_system. Be aware that the runtime of the search increases by up to 10 percent with activated timeout. To disable the timeout you can either use a negative value or 'false'"false""false""false""false".

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 modifies the state of the following input parameter:

• ModelIDModelIDModelIDmodelIDmodel_id

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

ModelIDModelIDModelIDmodelIDmodel_id (input_control, state is modified)  ncc_model → HNCCModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the model.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Parameter names.

List of values: 'timeout'"timeout""timeout""timeout""timeout"

GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control)  attribute.value-array → HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Parameter values.

Result

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

Possible Predecessors

create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelcreate_ncc_model

Possible Successors

find_ncc_modelfind_ncc_modelFindNccModelFindNccModelfind_ncc_model

Module

Matching

---

ClassesClasses | | Operators