get_thresh_images_variation_modelT_get_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModelget_thresh_images_variation_model (Operator)
get_thresh_images_variation_modelT_get_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModelget_thresh_images_variation_model — Return the threshold images used for image comparison by a variation
model.
Signature
def get_thresh_images_variation_model(model_id: HHandle) -> Tuple[HObject, HObject]
Description
get_thresh_images_variation_modelget_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModelget_thresh_images_variation_model returns the threshold
images of the variation model ModelIDModelIDModelIDmodelIDmodel_id in MaxImageMaxImageMaxImagemaxImagemax_image
and MinImageMinImageMinImageminImagemin_image. The threshold images must be computed with
prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModelprepare_variation_model or
prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModelprepare_direct_variation_model before they can be read out.
The formula used for calculating the threshold images is described
with prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModelprepare_variation_model or
prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModelprepare_direct_variation_model. The threshold images are
used in compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelcompare_variation_model and
compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelcompare_ext_variation_model to detect too large deviations
of an image with respect to the model. As described with
compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelcompare_variation_model and
compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelcompare_ext_variation_model, gray values outside the
interval given by MinImageMinImageMinImageminImagemin_image and MaxImageMaxImageMaxImagemaxImagemax_image are
regarded as errors.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
MinImageMinImageMinImageminImagemin_image (output_object) image → objectHImageHObjectHObjectHobject * (byte / int2 / uint2)
Threshold image for the lower threshold.
MaxImageMaxImageMaxImagemaxImagemax_image (output_object) image → objectHImageHObjectHObjectHobject * (real)
Threshold image for the upper threshold.
ModelIDModelIDModelIDmodelIDmodel_id (input_control) variation_model → HVariationModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
ID of the variation model.
Result
get_thresh_images_variation_modelget_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModelget_thresh_images_variation_model returns 2 (
H_MSG_TRUE)
if all
parameters are correct.
Possible Predecessors
prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModelprepare_variation_model,
prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModelprepare_direct_variation_model
See also
compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelcompare_variation_model,
compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelcompare_ext_variation_model
Module
Matching