ClassesClasses | | Operators

get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParam (Operator)

Name

get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParam — Query parameters of a texture inspection model.

Signature

get_texture_inspection_model_param( : : TextureInspectionModel, GenParamName : GenParamValue)

Herror get_texture_inspection_model_param(const Hlong TextureInspectionModel, const char* GenParamName, Hlong* GenParamValue)

Herror T_get_texture_inspection_model_param(const Htuple TextureInspectionModel, const Htuple GenParamName, Htuple* GenParamValue)

void GetTextureInspectionModelParam(const HTuple& TextureInspectionModel, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HTextureInspectionModel::GetTextureInspectionModelParam(const HTuple& GenParamName) const

HTuple HTextureInspectionModel::GetTextureInspectionModelParam(const HString& GenParamName) const

HTuple HTextureInspectionModel::GetTextureInspectionModelParam(const char* GenParamName) const

static void HOperatorSet.GetTextureInspectionModelParam(HTuple textureInspectionModel, HTuple genParamName, out HTuple genParamValue)

HTuple HTextureInspectionModel.GetTextureInspectionModelParam(HTuple genParamName)

HTuple HTextureInspectionModel.GetTextureInspectionModelParam(string genParamName)

Description

The operator get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParam is used to query the values of the different parameters of a texture inspection model (TextureInspectionModelTextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModel). The names of the desired parameters are passed in the parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamName, the corresponding values are returned in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue. It is possible to query multiple parameters with a single call to get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParam. All parameters which can be manipulated by set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam can be queried. Please refer to the documentation of set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam 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_imageAddTextureInspectionModelImageAddTextureInspectionModelImageAddTextureInspectionModelImage. 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_imageRemoveTextureInspectionModelImageRemoveTextureInspectionModelImageRemoveTextureInspectionModelImage.

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_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParam.

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

Execution Information

Parameters

TextureInspectionModelTextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModel (input_control)  texture_inspection_model HTextureInspectionModel, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of the texture inspection model.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the queried model parameter.

Default value: 'novelty_threshold' "novelty_threshold" "novelty_threshold" "novelty_threshold" "novelty_threshold"

List of values: 'gen_result_handle'"gen_result_handle""gen_result_handle""gen_result_handle""gen_result_handle", 'gmm_centers'"gmm_centers""gmm_centers""gmm_centers""gmm_centers", 'gmm_em_max_iter'"gmm_em_max_iter""gmm_em_max_iter""gmm_em_max_iter""gmm_em_max_iter", 'gmm_em_regularize'"gmm_em_regularize""gmm_em_regularize""gmm_em_regularize""gmm_em_regularize", 'gmm_em_threshold'"gmm_em_threshold""gmm_em_threshold""gmm_em_threshold""gmm_em_threshold", 'gmm_ncomp'"gmm_ncomp""gmm_ncomp""gmm_ncomp""gmm_ncomp", 'gmm_pmaxcenters'"gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters", 'gmm_pmincenters'"gmm_pmincenters""gmm_pmincenters""gmm_pmincenters""gmm_pmincenters", 'gmm_preprocessing'"gmm_preprocessing""gmm_preprocessing""gmm_preprocessing""gmm_preprocessing", 'gmm_randseed'"gmm_randseed""gmm_randseed""gmm_randseed""gmm_randseed", 'gmm_sigma'"gmm_sigma""gmm_sigma""gmm_sigma""gmm_sigma", 'image_indices'"image_indices""image_indices""image_indices""image_indices", 'levels'"levels""levels""levels""levels", 'novelty_threshold'"novelty_threshold""novelty_threshold""novelty_threshold""novelty_threshold", 'num_levels'"num_levels""num_levels""num_levels""num_levels", 'patch_normalization'"patch_normalization""patch_normalization""patch_normalization""patch_normalization", 'patch_rotational_robustness'"patch_rotational_robustness""patch_rotational_robustness""patch_rotational_robustness""patch_rotational_robustness", 'patch_size'"patch_size""patch_size""patch_size""patch_size", 'sensitivity'"sensitivity""sensitivity""sensitivity""sensitivity"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (output_control)  string(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Value of the queried model parameter.

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)
* Clean up
clear_texture_inspection_model (TextureInspectionModel)

Result

The operator get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParam 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_modelCreateTextureInspectionModelCreateTextureInspectionModelCreateTextureInspectionModel, train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel

Possible Successors

add_texture_inspection_model_imageadd_texture_inspection_model_imageAddTextureInspectionModelImageAddTextureInspectionModelImageAddTextureInspectionModelImage, train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel

See also

set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam

Module

Matching


ClassesClasses | | Operators