HALCON 18.05 / HALCON Operator Reference / Inspection / Bead Inspection
ClassesClasses | | Operators

set_bead_inspection_paramT_set_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParam (Operator)

Name

set_bead_inspection_paramT_set_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParam — Set parameters of the bead inspection model.

Signature

set_bead_inspection_param( : : BeadInspectionModel, GenParamName, GenParamValue : )

Herror T_set_bead_inspection_param(const Htuple BeadInspectionModel, const Htuple GenParamName, const Htuple GenParamValue)

void SetBeadInspectionParam(const HTuple& BeadInspectionModel, const HTuple& GenParamName, const HTuple& GenParamValue)

void HBeadInspectionModel::SetBeadInspectionParam(const HTuple& GenParamName, const HTuple& GenParamValue) const

void HBeadInspectionModel::SetBeadInspectionParam(const HString& GenParamName, const HString& GenParamValue) const

void HBeadInspectionModel::SetBeadInspectionParam(const char* GenParamName, const char* GenParamValue) const

static void HOperatorSet.SetBeadInspectionParam(HTuple beadInspectionModel, HTuple genParamName, HTuple genParamValue)

void HBeadInspectionModel.SetBeadInspectionParam(HTuple genParamName, HTuple genParamValue)

void HBeadInspectionModel.SetBeadInspectionParam(string genParamName, string genParamValue)

Description

The operator set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParam is used to set parameters of a bead inspection model in order to adapt it to a particular inspection task. All parameters except for the model's contour can be set with this operator. A new bead inspection model should be used when a new contour is introduced. The current values of all parameters can be queried with the operator get_bead_inspection_paramget_bead_inspection_paramGetBeadInspectionParamGetBeadInspectionParamGetBeadInspectionParam.

Parameters that can be set

The following parameters are essential and inspection model specific. It is vital for the inspection's success to identify accurate values for those parameters:

'target_thickness'"target_thickness""target_thickness""target_thickness""target_thickness":

sets the TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThickness.

'thickness_tolerance'"thickness_tolerance""thickness_tolerance""thickness_tolerance""thickness_tolerance":

sets the ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerance.

'position_tolerance'"position_tolerance""position_tolerance""position_tolerance""position_tolerance":

sets the PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance.

'polarity'"polarity""polarity""polarity""polarity":

sets the bead's PolarityPolarityPolarityPolaritypolarity.

'sigma'"sigma""sigma""sigma""sigma"

'threshold'"threshold""threshold""threshold""threshold"

For more details, refer to the parameters' description in create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel.

Execution Information

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModel (input_control, state is modified)  bead_inspection_model → HBeadInspectionModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the bead inspection model.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the model parameter that shall be adjusted for the specified bead inspection model.

Default value: 'target_thickness' "target_thickness" "target_thickness" "target_thickness" "target_thickness"

List of values: 'polarity'"polarity""polarity""polarity""polarity", 'position_tolerance'"position_tolerance""position_tolerance""position_tolerance""position_tolerance", 'sigma'"sigma""sigma""sigma""sigma", 'target_thickness'"target_thickness""target_thickness""target_thickness""target_thickness", 'thickness_tolerance'"thickness_tolerance""thickness_tolerance""thickness_tolerance""thickness_tolerance", 'threshold'"threshold""threshold""threshold""threshold"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.value(-array) → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Value of the model parameter that shall be adjusted for the specified bead inspection model.

Default value: 40

Suggested values: 40, 10, 15, 0.6, 1.0, 4.0, 5.0, 'light'"light""light""light""light", 'dark'"dark""dark""dark""dark"

Result

The operator set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParam returns the value 2 (H_MSG_TRUE) if the given parameters are valid and within acceptable range. Otherwise, an exception will be raised.

Possible Predecessors

create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel

Possible Successors

apply_bead_inspection_modelapply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelApplyBeadInspectionModel, get_bead_inspection_paramget_bead_inspection_paramGetBeadInspectionParamGetBeadInspectionParamGetBeadInspectionParam

Alternatives

create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel

See also

create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel, clear_bead_inspection_modelclear_bead_inspection_modelClearBeadInspectionModelClearBeadInspectionModelClearBeadInspectionModel

Module

2D Metrology

ClassesClasses | | Operators
HALCON Operator Reference 18.05 Copyright © 1996-2018 MVTec Software GmbH