get_texture_inspection_model_paramT_get_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param (Operator)

Name

get_texture_inspection_model_paramT_get_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param — Query parameters of a texture inspection model.

Signature

Description

The operator get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param is used to query the values of the different parameters of a texture inspection model (TextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModeltexture_inspection_model). The names of the desired parameters are passed in the parameter GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name, the corresponding values are returned in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. It is possible to query multiple parameters with a single call to get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param. All parameters which can be manipulated by set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamset_texture_inspection_model_param can be queried. Please refer to the documentation of set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamset_texture_inspection_model_param for an explanation of the individual parameters. It is furthermore possible to query the following parameters:

'gmm_centers'"gmm_centers""gmm_centers""gmm_centers""gmm_centers":

Returns the number of Gaussian distributions which were determined as optimal within the training process. The value can be used as a reference for future texture inspection models. The range of the possible number of distributions is determined by the settings of the parameters 'gmm_pmincenters'"gmm_pmincenters""gmm_pmincenters""gmm_pmincenters""gmm_pmincenters" and 'gmm_pmaxcenters'"gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters". Each image pyramid level can have a different number of Gaussian distributions. By adding an index, the number of Gaussian distributions for specific pyramid levels can be queried. For example, 'gmm_centers_3'"gmm_centers_3""gmm_centers_3""gmm_centers_3""gmm_centers_3" returns the number of Gaussian distributions for the third pyramid level.

'image_indices'"image_indices""image_indices""image_indices""image_indices":

Returns the indices of the images that have been added to the texture inspection model using add_texture_inspection_model_imageadd_texture_inspection_model_imageAddTextureInspectionModelImageAddTextureInspectionModelImageadd_texture_inspection_model_image. Only indices of images are returned that are currently in the texture inspection model and have not been deleted with remove_texture_inspection_model_imageremove_texture_inspection_model_imageRemoveTextureInspectionModelImageRemoveTextureInspectionModelImageremove_texture_inspection_model_image.

'trained_covartype'"trained_covartype""trained_covartype""trained_covartype""trained_covartype":

Returns the type of covariance matrix that was used during training. The user has the possibility to set the preferred type of covariance matrix by setting 'gmm_covartype'"gmm_covartype""gmm_covartype""gmm_covartype""gmm_covartype" with set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamset_texture_inspection_model_param. However, if the training with the preferred covariance type fails, training is re-initialized with a less strict 'gmm_covartype'"gmm_covartype""gmm_covartype""gmm_covartype""gmm_covartype". Hence, if training with 'diag'"diag""diag""diag""diag" fails, a further training with 'spherical'"spherical""spherical""spherical""spherical" is attempted.

In order to avoid confusions regarding the returned tuple length, multivalued parameters, such as 'image_indices'"image_indices""image_indices""image_indices""image_indices", 'gmm_centers'"gmm_centers""gmm_centers""gmm_centers""gmm_centers", 'levels'"levels""levels""levels""levels" and 'novelty_threshold'"novelty_threshold""novelty_threshold""novelty_threshold""novelty_threshold" can only be queried alone i.e. without passing any other parameter to get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param.

For an explanation of the concept of the texture inspection see the introduction of chapter Inspection / Texture Inspection.

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

Example (HDevelop)

* Create texture inspection model
create_texture_inspection_model ('basic', TextureInspectionModel)
* Make this short example fast:
set_texture_inspection_model_param (TextureInspectionModel, \
                                    'gmm_em_max_iter', 1)
* Get parameters
get_texture_inspection_model_param (TextureInspectionModel, 'patch_size', \
                                    PatchSize)
* Read and add training images
read_image (TrainImage, 'carpet/carpet_01')
add_texture_inspection_model_image (TrainImage, TextureInspectionModel, \
                                    Indices)
* Train the model
train_texture_inspection_model (TextureInspectionModel)
* Read and apply a test image
read_image (TestImage, 'carpet/carpet_02')
apply_texture_inspection_model (TestImage, DefectCandidates, \
                                TextureInspectionModel, \
                                TextureInspectionResultID)

Result

The operator get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param 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_texture_inspection_modelcreate_texture_inspection_modelCreateTextureInspectionModelCreateTextureInspectionModelcreate_texture_inspection_model, train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModeltrain_texture_inspection_model

Possible Successors

add_texture_inspection_model_imageadd_texture_inspection_model_imageAddTextureInspectionModelImageAddTextureInspectionModelImageadd_texture_inspection_model_image, train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModeltrain_texture_inspection_model

See also

set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamset_texture_inspection_model_param

Module

Matching