set_metrology_object_fuzzy_paramSetMetrologyObjectFuzzyParamSetMetrologyObjectFuzzyParamset_metrology_object_fuzzy_paramT_set_metrology_object_fuzzy_param

HALCON ScriptCpp++.NETPythonC

Short description

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

Signature

set_metrology_object_fuzzy_param( metrology_model MetrologyHandle, integer Index, attribute.name GenParamName, attribute.value GenParamValue )void SetMetrologyObjectFuzzyParam( const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& GenParamName, const HTuple& GenParamValue )static void HOperatorSet.SetMetrologyObjectFuzzyParam( HTuple metrologyHandle, HTuple 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

Herror T_set_metrology_object_fuzzy_param( 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)

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

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

Description

set_metrology_object_paramSetMetrologyObjectParam 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_modelApplyMetrologyModel.

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

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

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

• '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_posFuzzyMeasurePos. There, the parameter corresponds to the parameter FuzzyThreshfuzzyThreshfuzzy_thresh.

  Default: 0.50.5

• '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_measureSetFuzzyMeasure. There, the parameter corresponds to the parameter SetTypesetTypeset_type with the value 'contrast'"contrast" and its value corresponds to the parameter Functionfunctionfunction.

  Default: 'disabled'"disabled"

• '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_measureSetFuzzyMeasure. There, the parameter corresponds to the parameter SetTypesetTypeset_type with the value 'position'"position" and its value corresponds to the parameter Functionfunctionfunction.

  Default: 'disabled'"disabled"

• '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_measureSetFuzzyMeasure. There, the parameter corresponds to the parameter SetTypesetTypeset_type with the value 'position'"position" and its value corresponds to the parameter Functionfunctionfunction.

  Default: 'disabled'"disabled"

• '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_measureSetFuzzyMeasure. There, the parameter corresponds to the parameter SetTypesetTypeset_type with the value 'position_end'"position_end" and its value corresponds to the parameter Functionfunctionfunction.

  Default: 'disabled'"disabled"

• '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_measureSetFuzzyMeasure. There, the parameter corresponds to the parameter SetTypesetTypeset_type with the value 'position_first_edge'"position_first_edge" and its value corresponds to the parameter Functionfunctionfunction.

  Default: 'disabled'"disabled"

• '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_measureSetFuzzyMeasure. There, the parameter corresponds to the parameter SetTypesetTypeset_type with the value 'position_last_edge'"position_last_edge" and its value corresponds to the parameter Functionfunctionfunction.

  Default: 'disabled'"disabled"

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

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

• MetrologyHandlemetrologyHandlemetrology_handle

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

Parameters

MetrologyHandlemetrologyHandlemetrology_handle (input_control, state is modified) metrology_model → (handle)HTuple (HHandle)HMetrologyModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the metrology model.

Indexindexindex (input_control) integer(-array) → (string / integer)HTuple (HString / Hlong)HTuple (string / int / long)MaybeSequence[Union[str, int]]Htuple (char* / Hlong)

Index of the metrology objects.

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

GenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → (string)HTuple (HString)HTuple (string)Sequence[str]Htuple (char*)

Names of the generic parameters.

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

GenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Values of the generic parameters.

Default: 0.50.5
Suggested values: 0.1, 0.3, 0.5, 0.6, 0.7, 0.9, 1, 2, 3, 4, 5, 10, 200.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_paramSetMetrologyObjectFuzzyParam returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

get_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParam

Possible successors

apply_metrology_modelApplyMetrologyModel, reset_metrology_object_fuzzy_paramResetMetrologyObjectFuzzyParam, get_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParam

See also

set_metrology_object_paramSetMetrologyObjectParam

Module

2D Metrology