apply_bead_inspection_modelT_apply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_model (Operator)
Name
apply_bead_inspection_modelT_apply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_model — Inspect beads in an image, as defined by the bead inspection
model.
Signature
def apply_bead_inspection_model(image: HObject, bead_inspection_model: HHandle) -> Tuple[HObject, HObject, HObject, Sequence[str]]
Description
The operator apply_bead_inspection_modelapply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_model applies the bead
inspection model BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModelbead_inspection_model to the
input ImageImageImageImageimageimage. The output parameter ErrorSegmentErrorSegmentErrorSegmentErrorSegmenterrorSegmenterror_segment
indicates the positions of detected errors.
The parameter ErrorTypeErrorTypeErrorTypeErrorTypeerrorTypeerror_type 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_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model.
The value of 'ErrorType'"ErrorType""ErrorType""ErrorType""ErrorType""ErrorType" can be:
- 'no bead'"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""incorrect position":
-
The center of the bead found at
this position is further away from the contour than allowed by
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance.
- 'too thin'"too thin""too thin""too thin""too thin""too thin":
-
The bead is thinner than allowed by
TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness and ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerancethickness_tolerance.
- 'too thick'"too thick""too thick""too thick""too thick""too thick":
The bead is thicker than allowed by
TargetThicknessTargetThicknessTargetThicknessTargetThicknesstargetThicknesstarget_thickness and ThicknessToleranceThicknessToleranceThicknessToleranceThicknessTolerancethicknessTolerancethickness_tolerance.
Values of the generic parameters set through
create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model or set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParamset_bead_inspection_param
highly affect the inspection results of the same model. For more details on
those parameters, please refer to create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model.
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
ImageImageImageImageimageimage (input_object) singlechannelimage → objectHImageHObjectHImageHobject (byte / uint2)
Image to apply bead inspection on.
LeftContourLeftContourLeftContourLeftContourleftContourleft_contour (output_object) xld-array → objectHXLDHObjectHXLDHobject *
The detected left contour of the beads.
RightContourRightContourRightContourRightContourrightContourright_contour (output_object) xld-array → objectHXLDHObjectHXLDHobject *
The detected right contour of the beads.
ErrorSegmentErrorSegmentErrorSegmentErrorSegmenterrorSegmenterror_segment (output_object) xld-array → objectHXLDHObjectHXLDHobject *
Detected error segments
BeadInspectionModelBeadInspectionModelBeadInspectionModelBeadInspectionModelbeadInspectionModelbead_inspection_model (input_control, state is modified) bead_inspection_model → HBeadInspectionModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the bead inspection model to be used.
ErrorTypeErrorTypeErrorTypeErrorTypeerrorTypeerror_type (output_control) string-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Types of detected errors.
Result
The operator apply_bead_inspection_modelapply_bead_inspection_modelApplyBeadInspectionModelApplyBeadInspectionModelApplyBeadInspectionModelapply_bead_inspection_model 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_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model,
set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParamset_bead_inspection_param
Possible Successors
set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParamset_bead_inspection_param,
clear_bead_inspection_modelclear_bead_inspection_modelClearBeadInspectionModelClearBeadInspectionModelClearBeadInspectionModelclear_bead_inspection_model
See also
get_bead_inspection_paramget_bead_inspection_paramGetBeadInspectionParamGetBeadInspectionParamGetBeadInspectionParamget_bead_inspection_param,
create_bead_inspection_modelcreate_bead_inspection_modelCreateBeadInspectionModelCreateBeadInspectionModelCreateBeadInspectionModelcreate_bead_inspection_model,
set_bead_inspection_paramset_bead_inspection_paramSetBeadInspectionParamSetBeadInspectionParamSetBeadInspectionParamset_bead_inspection_param
Module
2D Metrology