HALCON Website / HALCON Operator Reference / Inspection / Variation Model
ClassesClassesClassesClasses | | | | Operators

compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModel (Operator)

Name

compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModel — Compare an image to a variation model.

Signature

compare_ext_variation_model(Image : Region : ModelID, Mode : )

Herror compare_ext_variation_model(const Hobject Image, Hobject* Region, const Hlong ModelID, const char* Mode)

Herror T_compare_ext_variation_model(const Hobject Image, Hobject* Region, const Htuple ModelID, const Htuple Mode)

Herror compare_ext_variation_model(Hobject Image, Hobject* Region, const HTuple& ModelID, const HTuple& Mode)

HRegion HImage::CompareExtVariationModel(const HVariationModel& ModelID, const HTuple& Mode) const

HRegionArray HImageArray::CompareExtVariationModel(const HVariationModel& ModelID, const HTuple& Mode) const

HRegionArray HVariationModel::CompareExtVariationModel(const HImageArray& Image, const HTuple& Mode) const

void CompareExtVariationModel(const HObject& Image, HObject* Region, const HTuple& ModelID, const HTuple& Mode)

HRegion HVariationModel::CompareExtVariationModel(const HImage& Image, const HString& Mode) const

HRegion HVariationModel::CompareExtVariationModel(const HImage& Image, const char* Mode) const

HRegion HImage::CompareExtVariationModel(const HVariationModel& ModelID, const HString& Mode) const

HRegion HImage::CompareExtVariationModel(const HVariationModel& ModelID, const char* Mode) const

void HOperatorSetX.CompareExtVariationModel(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** Region, [in] VARIANT ModelID, [in] VARIANT Mode)

IHRegionX* HVariationModelX.CompareExtVariationModel(
[in] IHImageX* Image, [in] BSTR Mode)

IHRegionX* HImageX.CompareExtVariationModel(
[in] IHVariationModelX* ModelID, [in] BSTR Mode)

static void HOperatorSet.CompareExtVariationModel(HObject image, out HObject region, HTuple modelID, HTuple mode)

HRegion HVariationModel.CompareExtVariationModel(HImage image, string mode)

HRegion HImage.CompareExtVariationModel(HVariationModel modelID, string mode)

Description

compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModel compares the input image ImageImageImageImageImageimage to the variation model given by ModelIDModelIDModelIDModelIDModelIDmodelID. compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModel is an extension of compare_variation_modelcompare_variation_modelCompareVariationModelcompare_variation_modelCompareVariationModelCompareVariationModel that provides more modes for the image comparison. Before compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModel can be called, the two internal threshold images of the variation model must have been created with prepare_variation_modelprepare_variation_modelPrepareVariationModelprepare_variation_modelPrepareVariationModelPrepareVariationModel or prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModel. Let c(x,y) denote the input image ImageImageImageImageImageimage and denote the two threshold images (see prepare_variation_modelprepare_variation_modelPrepareVariationModelprepare_variation_modelPrepareVariationModelPrepareVariationModel or prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModel). Then, for ModeModeModeModeModemode = 'absolute'"absolute""absolute""absolute""absolute""absolute" the output region RegionRegionRegionRegionRegionregion contains all points that differ substantially from the model, i.e., the points that fulfill the following condition:

This mode is identical to compare_variation_modelcompare_variation_modelCompareVariationModelcompare_variation_modelCompareVariationModelCompareVariationModel. For ModeModeModeModeModemode = 'light'"light""light""light""light""light", RegionRegionRegionRegionRegionregion contains all points that are too bright:
For ModeModeModeModeModemode = 'dark'"dark""dark""dark""dark""dark", RegionRegionRegionRegionRegionregion contains all points that are too dark:
Finally, for ModeModeModeModeModemode = 'light_dark'"light_dark""light_dark""light_dark""light_dark""light_dark" two regions are returned in RegionRegionRegionRegionRegionregion. The first region contains the result of ModeModeModeModeModemode = 'light'"light""light""light""light""light", while the second region contains the result of ModeModeModeModeModemode = 'dark'"dark""dark""dark""dark""dark". The respective regions can be selected with select_objselect_objSelectObjselect_objSelectObjSelectObj.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  singlechannelimage(-array) → objectHImageHImageHImageHImageXHobject (byte / int2 / uint2)

Image of the object to be compared.

RegionRegionRegionRegionRegionregion (output_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject *

Region containing the points that differ substantially from the model.

ModelIDModelIDModelIDModelIDModelIDmodelID (input_control)  variation_model → HVariationModel, HTupleHTupleHVariationModel, HTupleHVariationModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

ID of the variation model.

ModeModeModeModeModemode (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Method used for comparing the variation model.

Default value: 'absolute' "absolute" "absolute" "absolute" "absolute" "absolute"

Suggested values: 'absolute'"absolute""absolute""absolute""absolute""absolute", 'light'"light""light""light""light""light", 'dark'"dark""dark""dark""dark""dark", 'light_dark'"light_dark""light_dark""light_dark""light_dark""light_dark"

Example (HDevelop)

open_framegrabber ('File', 1, 1, 0, 0, 0, 0, 'default', -1, \
                   'default', -1, 'default', 'testimages.seq', 'default', \
                   -1, -1, AcqHandle)
read_region (Region, 'model.reg')
area_center (Region, Area, RowRef, ColumnRef)
read_shape_model ('model.shm', TemplateID)
read_variation_model ('model.var', ModelID)
for K := 1 to 10000 by 1
    grab_image (Image, AcqHandle)
    find_shape_model (Image, TemplateID, 0, rad(360), 0.5, 1, 0.5, \
                      'true', 4, 0.9, Row, Column, Angle, Score)
    dev_display (Image)
    if (|Score| == 1)
        vector_angle_to_rigid (Row, Column, Angle, RowRef, \
                               ColumnRef, 0, HomMat2D)
        affine_trans_image (Image, ImageTrans, HomMat2D, 'constant', \
                            'false')
        compare_ext_variation_model (ImageTrans, RegionDiff, ModelID, \
                                     'light')
        dev_display (RegionDiff)
    endif
endfor
clear_shape_model (TemplateID)
clear_variation_model (ModelID)
close_framegrabber (AcqHandle)

Result

compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModel returns 2 (H_MSG_TRUE) if all parameters are correct and if the internal threshold images have been generated with prepare_variation_modelprepare_variation_modelPrepareVariationModelprepare_variation_modelPrepareVariationModelPrepareVariationModel or prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModel.

Possible Predecessors

prepare_variation_modelprepare_variation_modelPrepareVariationModelprepare_variation_modelPrepareVariationModelPrepareVariationModel, prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModel

Possible Successors

select_objselect_objSelectObjselect_objSelectObjSelectObj, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

compare_variation_modelcompare_variation_modelCompareVariationModelcompare_variation_modelCompareVariationModelCompareVariationModel, dyn_thresholddyn_thresholdDynThresholddyn_thresholdDynThresholdDynThreshold

See also

get_thresh_images_variation_modelget_thresh_images_variation_modelGetThreshImagesVariationModelget_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModel

Module

Matching

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH