apply_bead_inspection_modelT_apply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModel (Operator)
Name
apply_bead_inspection_modelT_apply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModel — Inspect beads in an image, as defined by the bead inspection
model.
Signature
Description
The operator apply_bead_inspection_modelapply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelApplyBeadInspectionModel applies the bead
inspection model BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModel to the
input ImageImageImageImageimage. The output parameter ErrorSegmentErrorSegmentErrorSegmentErrorSegmenterrorSegment
indicates the positions of detected errors.
The parameter ErrorTypeErrorTypeErrorTypeErrorTypeerrorType indicates the type of
the detected errors. For more details on the possible errors, refer to the
parameters' description and figures in create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel.
The value of 'ErrorType'"ErrorType""ErrorType""ErrorType""ErrorType" can be:
- 'no bead'"no bead""no bead""no bead""no bead":
-
No bead could be detected at this position.
- 'incorrect position'"incorrect position""incorrect position""incorrect position""incorrect position":
-
The center of the bead found at
this position is further away from the contour than allowed by
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance.
- 'too thin'"too thin""too thin""too thin""too thin":
-
The bead is thinner than allowed by
TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThickness and ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerance.
- 'too thick'"too thick""too thick""too thick""too thick":
The bead is thicker than allowed by
TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThickness and ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerance.
Values of the generic parameters set through
create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel or set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParam
highly affect the inspection results of the same model. For more details on
those parameters, please refer to create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel.
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
ImageImageImageImageimage (input_object) singlechannelimage → objectHImageHImageHobject (byte / uint2)
Image to apply bead inspection on.
LeftContourLeftContourLeftContourLeftContourleftContour (output_object) xld-array → objectHXLDHXLDHobject *
The detected left contour of the beads.
RightContourRightContourRightContourRightContourrightContour (output_object) xld-array → objectHXLDHXLDHobject *
The detected right contour of the beads.
ErrorSegmentErrorSegmentErrorSegmentErrorSegmenterrorSegment (output_object) xld-array → objectHXLDHXLDHobject *
Detected error segments
BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModel (input_control, state is modified) bead_inspection_model → HBeadInspectionModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the bead inspection model to be used.
ErrorTypeErrorTypeErrorTypeErrorTypeerrorType (output_control) string-array → HTupleHTupleHtuple (string) (string) (HString) (char*)
Types of detected errors.
Result
The operator apply_bead_inspection_modelapply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelApplyBeadInspectionModel 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,
set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParam
Possible Successors
set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParam,
clear_bead_inspection_modelclear_bead_inspection_modelClearBeadInspectionModelClearBeadInspectionModelClearBeadInspectionModel
See also
get_bead_inspection_paramget_bead_inspection_paramGetBeadInspectionParamGetBeadInspectionParamGetBeadInspectionParam,
create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModel,
set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParam
Module
2D Metrology