Operator Reference

HALCON Operator Reference / 2D Metrology

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

ClassesClasses | | Operators

set_metrology_object_fuzzy_paramT_set_metrology_object_fuzzy_paramSetMetrologyObjectFuzzyParamSetMetrologyObjectFuzzyParamset_metrology_object_fuzzy_param (Operator)

set_metrology_object_fuzzy_paramT_set_metrology_object_fuzzy_paramSetMetrologyObjectFuzzyParamSetMetrologyObjectFuzzyParamset_metrology_object_fuzzy_param — Set fuzzy parameters or fuzzy functions for a metrology model.

Signature

set_metrology_object_fuzzy_param( : : MetrologyHandle, Index, GenParamName, GenParamValue : )

Herror T_set_metrology_object_fuzzy_param(const Htuple MetrologyHandle, const Htuple Index, const Htuple GenParamName, const Htuple GenParamValue)

void SetMetrologyObjectFuzzyParam(const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& GenParamName, const HTuple& GenParamValue)

void HMetrologyModel::SetMetrologyObjectFuzzyParam(const HTuple& Index, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HMetrologyModel::SetMetrologyObjectFuzzyParam(const HString& Index, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HMetrologyModel::SetMetrologyObjectFuzzyParam(const char* Index, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HMetrologyModel::SetMetrologyObjectFuzzyParam(const wchar_t* Index, const HTuple& GenParamName, const HTuple& GenParamValue) const   ( Windows only)

static void HOperatorSet.SetMetrologyObjectFuzzyParam(HTuple metrologyHandle, HTuple index, HTuple genParamName, HTuple genParamValue)

void HMetrologyModel.SetMetrologyObjectFuzzyParam(HTuple index, HTuple genParamName, HTuple genParamValue)

void HMetrologyModel.SetMetrologyObjectFuzzyParam(string index, HTuple genParamName, HTuple genParamValue)

def set_metrology_object_fuzzy_param(metrology_handle: HHandle, index: MaybeSequence[Union[str, int]], gen_param_name: Sequence[str], gen_param_value: Sequence[Union[float, int]]) -> None

Description

set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParamset_metrology_object_param is used to set or change the fuzzy parameters or fuzzy functions of a metrology object in order to adapt the model to a particular edge selection before applying the operator apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelapply_metrology_model.

For an explanation of the concept of 2D metrology see the introduction of chapter 2D Metrology.

The metrology model is defined by the handle MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle. The parameter IndexIndexIndexindexindex specifies the metrology objects for which the parameters should be changed or set. The parameters of all metrology objects are set if the parameter IndexIndexIndexindexindex is set to 'all'"all""all""all""all".

The fuzzy parameter or the type of fuzzy function is passed in the parameter GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name. The corresponding value or the fuzzy function is passed in the parameter GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. If at least one fuzzy function is set, internally the operator fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos will be used when searching the objects with the operator apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelapply_metrology_model. More information about fuzzy functions can be found with the operator fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos. The following generic parameters and parameter values for GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value are possible:

'fuzzy_thresh'"fuzzy_thresh""fuzzy_thresh""fuzzy_thresh""fuzzy_thresh":

The parameter specifies the minimum fuzzy value. The meaning and the use of this parameter is described with the operator fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos. There, the parameter corresponds to the parameter FuzzyThreshFuzzyThreshFuzzyThreshfuzzyThreshfuzzy_thresh.

Default: 0.5

'function_contrast'"function_contrast""function_contrast""function_contrast""function_contrast":

The parameter specifies a fuzzy function of type contrast. The meaning and the use of this parameter is described with the operator set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure. There, the parameter corresponds to the parameter SetTypeSetTypeSetTypesetTypeset_type with the value 'contrast'"contrast""contrast""contrast""contrast" and its value corresponds to the parameter FunctionFunctionFunctionfunctionfunction.

Default: 'disabled'"disabled""disabled""disabled""disabled"

'function_position'"function_position""function_position""function_position""function_position":

The parameter specifies a fuzzy function of type position. The meaning and the use of this parameter is described with the operator set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure. There, the parameter corresponds to the parameter SetTypeSetTypeSetTypesetTypeset_type with the value 'position'"position""position""position""position" and its value corresponds to the parameter FunctionFunctionFunctionfunctionfunction.

Default: 'disabled'"disabled""disabled""disabled""disabled"

'function_position_center'"function_position_center""function_position_center""function_position_center""function_position_center":

The parameter specifies a fuzzy function of type position_center. The meaning and the use of this parameter is described with the operator set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure. There, the parameter corresponds to the parameter SetTypeSetTypeSetTypesetTypeset_type with the value 'position'"position""position""position""position" and its value corresponds to the parameter FunctionFunctionFunctionfunctionfunction.

Default: 'disabled'"disabled""disabled""disabled""disabled"

'function_position_end'"function_position_end""function_position_end""function_position_end""function_position_end":

The parameter specifies a fuzzy function of type position_end. The meaning and the use of this parameter is described with the operator set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure. There, the parameter corresponds to the parameter SetTypeSetTypeSetTypesetTypeset_type with the value 'position_end'"position_end""position_end""position_end""position_end" and its value corresponds to the parameter FunctionFunctionFunctionfunctionfunction.

Default: 'disabled'"disabled""disabled""disabled""disabled"

'function_position_first_edge'"function_position_first_edge""function_position_first_edge""function_position_first_edge""function_position_first_edge":

The parameter specifies a fuzzy function of type position_first_edge. The meaning and the use of this parameter is described with the operator set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure. There, the parameter corresponds to the parameter SetTypeSetTypeSetTypesetTypeset_type with the value 'position_first_edge'"position_first_edge""position_first_edge""position_first_edge""position_first_edge" and its value corresponds to the parameter FunctionFunctionFunctionfunctionfunction.

Default: 'disabled'"disabled""disabled""disabled""disabled"

'function_position_last_edge'"function_position_last_edge""function_position_last_edge""function_position_last_edge""function_position_last_edge":

The parameter specifies a fuzzy function of type position_last_edge. The meaning and the use of this parameter is described with the operator set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure. There, the parameter corresponds to the parameter SetTypeSetTypeSetTypesetTypeset_type with the value 'position_last_edge'"position_last_edge""position_last_edge""position_last_edge""position_last_edge" and its value corresponds to the parameter FunctionFunctionFunctionfunctionfunction.

Default: 'disabled'"disabled""disabled""disabled""disabled"

A fuzzy function is discarded if the fuzzy function value is set to 'disabled'"disabled""disabled""disabled""disabled". All previously defined fuzzy functions and fuzzy parameters can be discarded completely using reset_metrology_object_fuzzy_paramreset_metrology_object_fuzzy_paramResetMetrologyObjectFuzzyParamResetMetrologyObjectFuzzyParamreset_metrology_object_fuzzy_param. The current configuration of the metrology objects can be accessed with get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParamget_metrology_object_fuzzy_param. Note that if at least one fuzzy function is specified, the operator fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos is used for the edge detection.

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:

• MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle

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

Parameters

MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (input_control, state is modified)  metrology_model → HMetrologyModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the metrology model.

IndexIndexIndexindexindex (input_control)  integer(-array) → HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Index of the metrology objects.

Default: 'all' "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all", 0, 1, 2

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

Names of the generic parameters.

Default: 'fuzzy_thresh' "fuzzy_thresh" "fuzzy_thresh" "fuzzy_thresh" "fuzzy_thresh"

List of values: 'function_contrast'"function_contrast""function_contrast""function_contrast""function_contrast", 'function_position'"function_position""function_position""function_position""function_position", 'function_position_center'"function_position_center""function_position_center""function_position_center""function_position_center", 'function_position_end'"function_position_end""function_position_end""function_position_end""function_position_end", 'function_position_first_edge'"function_position_first_edge""function_position_first_edge""function_position_first_edge""function_position_first_edge", 'function_position_last_edge'"function_position_last_edge""function_position_last_edge""function_position_last_edge""function_position_last_edge", 'fuzzy_thresh'"fuzzy_thresh""fuzzy_thresh""fuzzy_thresh""fuzzy_thresh"

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

Values of the generic parameters.

Default: 0.5

Suggested values: 0.1, 0.3, 0.5, 0.6, 0.7, 0.9, 1, 2, 3, 4, 5, 10, 20

Result

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

Possible Predecessors

get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParamget_metrology_object_fuzzy_param

Possible Successors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelapply_metrology_model, reset_metrology_object_fuzzy_paramreset_metrology_object_fuzzy_paramResetMetrologyObjectFuzzyParamResetMetrologyObjectFuzzyParamreset_metrology_object_fuzzy_param, get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParamget_metrology_object_fuzzy_param

See also

set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParamset_metrology_object_param

Module

2D Metrology

---

ClassesClasses | | Operators