Skip to content

apply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_modelT_apply_bead_inspection_model🔗

Short description🔗

apply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_modelT_apply_bead_inspection_model — Inspect beads in an image, as defined by the bead inspection model.

Signature🔗

apply_bead_inspection_model( image Image, out xld LeftContour, out xld RightContour, out xld ErrorSegment, bead_inspection_model BeadInspectionModel, out string ErrorType )void ApplyBeadInspectionModel( const HObject& Image, HObject* LeftContour, HObject* RightContour, HObject* ErrorSegment, const HTuple& BeadInspectionModel, HTuple* ErrorType )static void HOperatorSet.ApplyBeadInspectionModel( HObject image, out HObject leftContour, out HObject rightContour, out HObject errorSegment, HTuple beadInspectionModel, out HTuple errorType )def apply_bead_inspection_model( image: HObject, bead_inspection_model: HHandle ) -> Tuple[HObject, HObject, HObject, Sequence[str]]

Herror T_apply_bead_inspection_model( const Hobject Image, Hobject* LeftContour, Hobject* RightContour, Hobject* ErrorSegment, const Htuple BeadInspectionModel, Htuple* ErrorType )

HXLD HBeadInspectionModel::ApplyBeadInspectionModel( const HImage& Image, HXLD* RightContour, HXLD* ErrorSegment, HTuple* ErrorType ) const

HXLD HBeadInspectionModel.ApplyBeadInspectionModel( HImage image, out HXLD rightContour, out HXLD errorSegment, out HTuple errorType )

Description🔗

The operator apply_bead_inspection_modelApplyBeadInspectionModel applies the bead inspection model BeadInspectionModelbeadInspectionModelbead_inspection_model to the input Imageimageimage. The output parameter ErrorSegmenterrorSegmenterror_segment indicates the positions of detected errors. The parameter ErrorTypeerrorTypeerror_type indicates the type of the detected errors for each segment. For more details on the possible errors, refer to the parameters’ description and figures in create_bead_inspection_modelCreateBeadInspectionModel. The value of ErrorTypeerrorTypeerror_type can be:

  • 'no bead'"no bead": No bead could be detected at this position.

  • 'incorrect position'"incorrect position": The center of the bead found at this position is further away from the contour than allowed by PositionTolerancepositionToleranceposition_tolerance.

  • 'too thin'"too thin": The bead is thinner than allowed by TargetThicknesstargetThicknesstarget_thickness and ThicknessTolerancethicknessTolerancethickness_tolerance.

  • 'too thick'"too thick": The bead is thicker than allowed by TargetThicknesstargetThicknesstarget_thickness and ThicknessTolerancethicknessTolerancethickness_tolerance.

Values of the generic parameters set through create_bead_inspection_modelCreateBeadInspectionModel or set_bead_inspection_paramSetBeadInspectionParam highly affect the inspection results of the same model. For more details on those parameters, please refer to create_bead_inspection_modelCreateBeadInspectionModel.

Note that the operator ignores the image domain and applies the model to the full image

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:

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

Parameters🔗

Imageimageimage (input_object) singlechannelimage → object (byte / uint2)HObject (byte / uint2)HImage (byte / uint2)HObject (byte / uint2)Hobject (byte / uint2)

Image to apply bead inspection on.

LeftContourleftContourleft_contour (output_object) xld-array → objectHObjectHXLDHObjectHobject *

The detected left contour of the beads.

RightContourrightContourright_contour (output_object) xld-array → objectHObjectHXLDHObjectHobject *

The detected right contour of the beads.

ErrorSegmenterrorSegmenterror_segment (output_object) xld-array → objectHObjectHXLDHObjectHobject *

Detected error segments

BeadInspectionModelbeadInspectionModelbead_inspection_model (input_control, state is modified) bead_inspection_model → (handle)HTuple (HHandle)HBeadInspectionModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the bead inspection model to be used.

ErrorTypeerrorTypeerror_type (output_control) string-array → (string)HTuple (HString)HTuple (string)Sequence[str]Htuple (char*)

Types of detected errors.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

create_bead_inspection_modelCreateBeadInspectionModel, set_bead_inspection_paramSetBeadInspectionParam

Possible successors

set_bead_inspection_paramSetBeadInspectionParam, clear_bead_inspection_modelClearBeadInspectionModel

See also

get_bead_inspection_paramGetBeadInspectionParam, create_bead_inspection_modelCreateBeadInspectionModel, set_bead_inspection_paramSetBeadInspectionParam

Module🔗

2D Metrology