create_bead_inspection_modelT_create_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model (Operator)

Name

create_bead_inspection_modelT_create_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model — Create a model to inspect beads or adhesive in images.

Signature

create_bead_inspection_model(BeadContour : : TargetThickness, ThicknessTolerance, PositionTolerance, Polarity, GenParamName, GenParamValue : BeadInspectionModel)

Herror T_create_bead_inspection_model(const Hobject BeadContour, const Htuple TargetThickness, const Htuple ThicknessTolerance, const Htuple PositionTolerance, const Htuple Polarity, const Htuple GenParamName, const Htuple GenParamValue, Htuple* BeadInspectionModel)

void CreateBeadInspectionModel(const HObject& BeadContour, const HTuple& TargetThickness, const HTuple& ThicknessTolerance, const HTuple& PositionTolerance, const HTuple& Polarity, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* BeadInspectionModel)

void HBeadInspectionModel::HBeadInspectionModel(const HXLD& BeadContour, const HTuple& TargetThickness, const HTuple& ThicknessTolerance, const HTuple& PositionTolerance, const HString& Polarity, const HTuple& GenParamName, const HTuple& GenParamValue)

void HBeadInspectionModel::HBeadInspectionModel(const HXLD& BeadContour, Hlong TargetThickness, Hlong ThicknessTolerance, Hlong PositionTolerance, const HString& Polarity, const HString& GenParamName, Hlong GenParamValue)

void HBeadInspectionModel::HBeadInspectionModel(const HXLD& BeadContour, Hlong TargetThickness, Hlong ThicknessTolerance, Hlong PositionTolerance, const char* Polarity, const char* GenParamName, Hlong GenParamValue)

void HBeadInspectionModel::HBeadInspectionModel(const HXLD& BeadContour, Hlong TargetThickness, Hlong ThicknessTolerance, Hlong PositionTolerance, const wchar_t* Polarity, const wchar_t* GenParamName, Hlong GenParamValue)   (Windows only)

void HBeadInspectionModel::CreateBeadInspectionModel(const HXLD& BeadContour, const HTuple& TargetThickness, const HTuple& ThicknessTolerance, const HTuple& PositionTolerance, const HString& Polarity, const HTuple& GenParamName, const HTuple& GenParamValue)

void HBeadInspectionModel::CreateBeadInspectionModel(const HXLD& BeadContour, Hlong TargetThickness, Hlong ThicknessTolerance, Hlong PositionTolerance, const HString& Polarity, const HString& GenParamName, Hlong GenParamValue)

void HBeadInspectionModel::CreateBeadInspectionModel(const HXLD& BeadContour, Hlong TargetThickness, Hlong ThicknessTolerance, Hlong PositionTolerance, const char* Polarity, const char* GenParamName, Hlong GenParamValue)

void HBeadInspectionModel::CreateBeadInspectionModel(const HXLD& BeadContour, Hlong TargetThickness, Hlong ThicknessTolerance, Hlong PositionTolerance, const wchar_t* Polarity, const wchar_t* GenParamName, Hlong GenParamValue)   (Windows only)

static void HOperatorSet.CreateBeadInspectionModel(HObject beadContour, HTuple targetThickness, HTuple thicknessTolerance, HTuple positionTolerance, HTuple polarity, HTuple genParamName, HTuple genParamValue, out HTuple beadInspectionModel)

public HBeadInspectionModel(HXLD beadContour, HTuple targetThickness, HTuple thicknessTolerance, HTuple positionTolerance, string polarity, HTuple genParamName, HTuple genParamValue)

public HBeadInspectionModel(HXLD beadContour, int targetThickness, int thicknessTolerance, int positionTolerance, string polarity, string genParamName, int genParamValue)

void HBeadInspectionModel.CreateBeadInspectionModel(HXLD beadContour, HTuple targetThickness, HTuple thicknessTolerance, HTuple positionTolerance, string polarity, HTuple genParamName, HTuple genParamValue)

void HBeadInspectionModel.CreateBeadInspectionModel(HXLD beadContour, int targetThickness, int thicknessTolerance, int positionTolerance, string polarity, string genParamName, int genParamValue)

def create_bead_inspection_model(bead_contour: HObject, target_thickness: Union[int, float], thickness_tolerance: Union[int, float], position_tolerance: Union[int, float], polarity: str, gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[int, float, str]]) -> HHandle

Description

create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model creates a model to inspect beads or adhesive in images.

The basic principle of bead inspection

The bead inspection operators enable the user to define a reference contour that indicates the position and shape of a bead or adhesive on a certain product. Images of such products can then be inspected to verify that a bead or adhesive exists at the positions defined by the contour and that it is of acceptable thickness. The images must already be aligned with the given contour.

The operator create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model returns a handle to the bead inspection model in BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModelbead_inspection_model, which can later be used to perform other operations related to bead inspection. These operations include the modification of the bead inspection model parameters and performing the inspection on input images as defined by the model.

Providing the model contour

In order to inspect beads, a contour serving as the model for the bead must be provided in BeadContourBeadContourBeadContourBeadContourbeadContourbead_contour. Such a contour can be generated, e.g., by using the operators gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld or gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld. The contour must be defined to be aligned to the beads in the input images. To achieve this, the user can draw the XLD directly on a reference image in the graphics window (with draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygondraw_polygon or draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs). To inspect beads consisting of multiple parts, multiple models must be created.

Mandatory parameters

image/svg+xml TargetThickness ThicknessTolerance
(1)
image/svg+xml PositionTolerance BeadInspectionModel
(2)
The mandatory parameters for a bead inspection model

In order to inspect beads, the following parameters must be set:

- TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness: defines the optimal bead thickness in pixels.

- ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerancethickness_tolerance: defines the tolerance to the bead's thickness in pixels. The bead is accepted if its thickness is within the range:

[TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness-ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerancethickness_tolerance, TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness+ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerancethickness_tolerance]

- PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance: defines the tolerance to the bead's position in pixels. The 'bead position' is the center of the detected bead. The bead is accepted if the distance between its center and the contour's position is less than the PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance.

- PolarityPolarityPolarityPolaritypolaritypolarity: defines the polarity of the bead in the images to inspect. 'light'"light""light""light""light""light" if the bead is lighter than its background, 'dark'"dark""dark""dark""dark""dark" otherwise.

Edge extraction parameters

Bead inspection relies on edge extraction to identify the edges of beads. Accordingly, correct initialization of the measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos parameters helps improve bead inspection results. In particular, the following 2 parameters are included as generic parameters in the bead inspection model:

'sigma'"sigma""sigma""sigma""sigma""sigma":

As defined in measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos, 'sigma'"sigma""sigma""sigma""sigma""sigma" is the standard deviation of the Gaussian smoothing kernel. The value of 'sigma'"sigma""sigma""sigma""sigma""sigma" depends on the quality of the images to be inspected, namely on the amount of noise. 'sigma'"sigma""sigma""sigma""sigma""sigma" is set to 2.0 by default.

'threshold'"threshold""threshold""threshold""threshold""threshold":

As defined in measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos, 'threshold'"threshold""threshold""threshold""threshold""threshold" sets the minimum edge amplitude to be extracted. Setting a higher value for 'threshold'"threshold""threshold""threshold""threshold""threshold" helps to avoid the extraction of noise edges and select salient edges. 'threshold'"threshold""threshold""threshold""threshold""threshold" cannot be less than 1 and is set to 30 by default.

The Measure Assistant can be used to find suitable values for these two parameters.

Execution Information

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.

This operator modifies the state of the following input parameter:

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

Parameters

BeadContourBeadContourBeadContourBeadContourbeadContourbead_contour (input_object)  xld objectHXLDHObjectHXLDHobject

XLD contour specifying the expected bead's shape and position.

TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness (input_control)  integer HTupleUnion[int, float]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Optimal bead thickness.

Default value: 50

Typical range of values: 5 ≤ TargetThickness TargetThickness TargetThickness TargetThickness targetThickness target_thickness

ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerancethickness_tolerance (input_control)  integer HTupleUnion[int, float]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Tolerance of bead's thickness with respect to TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness.

Default value: 15

Typical range of values: 0 ≤ ThicknessTolerance ThicknessTolerance ThicknessTolerance ThicknessTolerance thicknessTolerance thickness_tolerance

PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance (input_control)  integer HTupleUnion[int, float]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Tolerance of the bead's center position.

Default value: 15

Typical range of values: 0 ≤ PositionTolerance PositionTolerance PositionTolerance PositionTolerance positionTolerance position_tolerance

PolarityPolarityPolarityPolaritypolaritypolarity (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

The bead's polarity.

Default value: 'light' "light" "light" "light" "light" "light"

List of values: 'dark'"dark""dark""dark""dark""dark", 'light'"light""light""light""light""light"

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Names of the generic parameters that can be adjusted for the bead inspection model.

Default value: []

List of values: 'sigma'"sigma""sigma""sigma""sigma""sigma", 'threshold'"threshold""threshold""threshold""threshold""threshold"

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

Values of the generic parameters that can be adjusted for the bead inspection model.

Default value: []

Suggested values: 0.6, 1.0, 4.0, 5.0, 10.0, 50.0

BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModelbead_inspection_model (output_control, state is modified)  bead_inspection_model HBeadInspectionModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle for using and accessing the bead inspection model.

Example (HDevelop)

* Read the image of the bead to be inspected.
read_image (Image, 'bead/adhesive_bead_01')
* Define the reference path of the adhesive beads.
gen_contour_nurbs_xld (ContourRef, \
                       [610.974,533.443,461.763,393.009,330.106,287.683, \
                        270.129,265.74,265.74,300.849,331.569,376.917, \
                        438.357,489.557,539.294], \
                       [418.581,424.27,439.441,473.574,526.67,574.078, \
                        644.241,708.715,765.604,818.7,866.107,915.411, \
                        966.611,998.848,993.159], \
                       'auto', \
                       [15,15,15,15,15,15,15,15,15,15,15,15,15,15,15], \
                       3, 1, 5)
*
* Create the bead inspection model, identifying the bead's parameters
create_bead_inspection_model (ContourRef, 14, 7, 30, 'dark', [], [], \ 
                               BeadInspectionModel)
*
* Apply the bead inspection model to the image
apply_bead_inspection_model (Image, LeftContour, RightContour, \
                              ErrorSegment, BeadInspectionModel, \
                              ErrorType)

Result

The operator create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model returns the value TRUE if the given parameters are valid and within acceptable range. Otherwise, an exception will be raised.

Possible Predecessors

gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld

Possible Successors

apply_bead_inspection_modelapply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_model, set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParamset_bead_inspection_param

See also

clear_bead_inspection_modelclear_bead_inspection_modelClearBeadInspectionModelClearBeadInspectionModelClearBeadInspectionModelclear_bead_inspection_model

Module

2D Metrology