Operator Reference

HALCON Operator Reference / Matching / Shape-Based

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

adapt_shape_model_high_noiseT_adapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise (Operator)

adapt_shape_model_high_noiseT_adapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise — Adapt a shape model's parameters for high noise images.

Signature

adapt_shape_model_high_noise(ImageReduced : : ModelID, GenParam : ResultDict)

Herror T_adapt_shape_model_high_noise(const Hobject ImageReduced, const Htuple ModelID, const Htuple GenParam, Htuple* ResultDict)

void AdaptShapeModelHighNoise(const HObject& ImageReduced, const HTuple& ModelID, const HTuple& GenParam, HTuple* ResultDict)

HDict HShapeModel::AdaptShapeModelHighNoise(const HImage& ImageReduced, const HTuple& GenParam) const

static void HOperatorSet.AdaptShapeModelHighNoise(HObject imageReduced, HTuple modelID, HTuple genParam, out HTuple resultDict)

HDict HShapeModel.AdaptShapeModelHighNoise(HImage imageReduced, HTuple genParam)

def adapt_shape_model_high_noise(image_reduced: HObject, model_id: HHandle, gen_param: Sequence[str]) -> HHandle

Description

adapt_shape_model_high_noiseadapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise adapts the parameters of a shape model ModelIDModelIDModelIDmodelIDmodel_id for high noise images and returns them in ResultDictResultDictResultDictresultDictresult_dict. Based on a sample search image ImageReducedImageReducedImageReducedimageReducedimage_reduced, the optimal values of the shape model's parameters are estimated and adapted in the model. The domain of ImageReducedImageReducedImageReducedimageReducedimage_reduced should contain the model and surrounding background, such that the typical noise is presented to the algorithm. With GenParamGenParamGenParamgenParamgen_param the parameters to be estimated can be controlled. Currently, the operator supports the estimation of the lowest pyramid level used in the matching step. Accordingly, the value 'all'"all""all""all""all" or 'lowest_level'"lowest_level""lowest_level""lowest_level""lowest_level" should be provided to GenParamGenParamGenParamgenParamgen_param.

Attention: The operator changes the shape model ModelIDModelIDModelIDmodelIDmodel_id by setting the estimated lowest pyramid level.

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 returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

This operator modifies the state of the following input parameter:

• ModelIDModelIDModelIDmodelIDmodel_id

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

Parameters

ImageReducedImageReducedImageReducedimageReducedimage_reduced (input_object)  (multichannel-)image → objectHImageHObjectHObjectHobject (byte / uint2)

Sample search image with reduced domain.

ModelIDModelIDModelIDmodelIDmodel_id (input_control, state is modified)  shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the shape model.

GenParamGenParamGenParamgenParamgen_param (input_control)  string-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Parameters to be estimated.

Default: 'all' "all" "all" "all" "all"

List of values: 'all'"all""all""all""all", 'lowest_level'"lowest_level""lowest_level""lowest_level""lowest_level"

ResultDictResultDictResultDictresultDictresult_dict (output_control)  dict → HDict, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Dictionary with the estimated parameter values.

Result

If the parameters are valid, the operator adapt_shape_model_high_noiseadapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

create_generic_shape_modelcreate_generic_shape_modelCreateGenericShapeModelCreateGenericShapeModelcreate_generic_shape_model

Possible Successors

find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model

Module

Matching

---

ClassesClasses | | Operators