adapt_shape_model_high_noiseT_adapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise (Operator)
Name
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
Description
adapt_shape_model_high_noiseadapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise adapts the parameters of a shape model
ModelIDModelIDModelIDModelIDmodelIDmodel_id for high noise images and returns them in ResultDictResultDictResultDictResultDictresultDictresult_dict.
Based on a sample search image ImageReducedImageReducedImageReducedImageReducedimageReducedimage_reduced, the optimal values of
the shape model's parameters are estimated and adapted in the model. The
domain of ImageReducedImageReducedImageReducedImageReducedimageReducedimage_reduced should contain the model and surrounding
background, such that the typical noise is presented to the algorithm.
With GenParamGenParamGenParamGenParamgenParamgen_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""all" or
'lowest_level'"lowest_level""lowest_level""lowest_level""lowest_level""lowest_level" should be provided to GenParamGenParamGenParamGenParamgenParamgen_param.
Please note that the operator changes the shape model ModelIDModelIDModelIDModelIDmodelIDmodel_id such
that it uses the estimated lowest pyramid level in subsequent calls of, e.g.,
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model.
The estimated lowest pyramid level can be overridden in subsequent find calls
as explained in the documentation of the different find operators, e.g.,
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_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 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:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
ImageReducedImageReducedImageReducedImageReducedimageReducedimage_reduced (input_object) (multichannel-)image → objectHImageHObjectHImageHobject (byte / uint2)
Sample search image with reduced domain.
ModelIDModelIDModelIDModelIDmodelIDmodel_id (input_control, state is modified) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the shape model.
GenParamGenParamGenParamGenParamgenParamgen_param (input_control) string-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Parameters to be estimated.
Default value:
'all'
"all"
"all"
"all"
"all"
"all"
List of values: 'all'"all""all""all""all""all", 'lowest_level'"lowest_level""lowest_level""lowest_level""lowest_level""lowest_level"
ResultDictResultDictResultDictResultDictresultDictresult_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_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
Possible Predecessors
create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModelcreate_shape_model,
create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model,
create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model
Possible Successors
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model,
find_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModelFindScaledShapeModelfind_scaled_shape_model,
find_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModelFindAnisoShapeModelfind_aniso_shape_model,
find_shape_modelsfind_shape_modelsFindShapeModelsFindShapeModelsFindShapeModelsfind_shape_models,
find_scaled_shape_modelsfind_scaled_shape_modelsFindScaledShapeModelsFindScaledShapeModelsFindScaledShapeModelsfind_scaled_shape_models,
find_aniso_shape_modelsfind_aniso_shape_modelsFindAnisoShapeModelsFindAnisoShapeModelsFindAnisoShapeModelsfind_aniso_shape_models
Module
Matching