ClassesClasses | | Operators

set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParam (Operator)

Name

set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParam — Set parameters of a texture inspection model.

Signature

set_texture_inspection_model_param( : : TextureInspectionModel, GenParamName, GenParamValue : )

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

Herror T_set_texture_inspection_model_param(const Htuple TextureInspectionModel, const Htuple GenParamName, const Htuple GenParamValue)

void SetTextureInspectionModelParam(const HTuple& TextureInspectionModel, const HTuple& GenParamName, const HTuple& GenParamValue)

void HTextureInspectionModel::SetTextureInspectionModelParam(const HTuple& GenParamName, const HTuple& GenParamValue) const

void HTextureInspectionModel::SetTextureInspectionModelParam(const HString& GenParamName, Hlong GenParamValue) const

void HTextureInspectionModel::SetTextureInspectionModelParam(const char* GenParamName, Hlong GenParamValue) const

static void HOperatorSet.SetTextureInspectionModelParam(HTuple textureInspectionModel, HTuple genParamName, HTuple genParamValue)

void HTextureInspectionModel.SetTextureInspectionModelParam(HTuple genParamName, HTuple genParamValue)

void HTextureInspectionModel.SetTextureInspectionModelParam(string genParamName, int genParamValue)

Description

The operator set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam is used to manipulate the parameters of a texture inspection model TextureInspectionModelTextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModel. The current parameter settings can be queried with the operator 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.

General parameters:

'num_levels'"num_levels""num_levels""num_levels""num_levels":

Determines the number of pyramid levels used within the texture inspection process. The number of pyramid levels affects the inspection results as well as the runtime of train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel and apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel. Per default the number of levels is estimated by the size of the training images. It should be noted, that no more than 5 pyramid levels are used by the estimation process.

Changing this parameter can require a complete new training of the texture inspection model. No retraining is required if the number of levels of a trained texture inspection model are merely reduced.

If the texture in your images is very coarse, the lower pyramid levels may not be needed for a successful inspection. Then you can save a lot of runtime by setting the levels of interest explicitly with 'levels'"levels""levels""levels""levels".

Values: integer values larger or equal to 1 or 'auto'"auto""auto""auto""auto"

Default: 'auto'"auto""auto""auto""auto"

'levels'"levels""levels""levels""levels":

Determines the pyramid levels used within the texture inspection process. The number of pyramid levels affects the inspection results as well as the runtime of train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel and apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel. Per default the pyramid levels are determined by the value of 'num_levels'"num_levels""num_levels""num_levels""num_levels". If for example 'num_levels'"num_levels""num_levels""num_levels""num_levels" is set to four, then the texture inspection is performed for levels 1 to 4. If all available levels should be trained, the value has to be set to 'auto'"auto""auto""auto""auto".

Changing this parameter can require a complete new training of the texture inspection model. No retraining is required if the number of levels of a trained texture inspection model are merely reduced.

If the texture in your images is very coarse, the lower pyramid levels may not be needed for a successful inspection. Then you can save a lot of runtime by excluding unwanted levels by setting the pyramid levels with 'levels'"levels""levels""levels""levels" explicitly.

In order to avoid confusions regarding the returned tuple length, 'levels'"levels""levels""levels""levels" can only be set alone i.e. without passing any other parameter to set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam.

Values: a monotonically increasing tuple of integer values larger or equal to 1, or 'auto'"auto""auto""auto""auto"

Default: 'auto'"auto""auto""auto""auto"

'gen_result_handle'"gen_result_handle""gen_result_handle""gen_result_handle""gen_result_handle":

This parameter determines whether or not a result handle is returned by apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel. If set to 'true'"true""true""true""true", the individual pyramid level results can be queried from the texture result handle with get_texture_inspection_result_objectget_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectGetTextureInspectionResultObject. This is useful for debugging and fine tuning.

If set to 'false'"false""false""false""false", apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel only returns a novelty region.

Values: 'true'"true""true""true""true", 'false'"false""false""false""false"

Default: 'false'"false""false""false""false"

Parameters which influence the automatic novelty threshold calculation:

'novelty_threshold'"novelty_threshold""novelty_threshold""novelty_threshold""novelty_threshold":

This parameter sets the values of the novelty thresholds, which distinguish between defective and non-defective texture. The novelty thresholds are passed as a tuple and are set for all pyramid levels at once. Therefore, the number of elements must be equal to the number of pyramid levels 'num_levels'"num_levels""num_levels""num_levels""num_levels".

Setting the novelty thresholds prior to training has no effect since the training automatically determines novelty thresholds. Hence the novelty thresholds should be adapted after the training. A typical use case is the fine tuning to optimize the results of apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel. Please note, if the novelty thresholds have been set explicitly, a new call of train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel will re-estimate the novelty thresholds automatically and overwrite any explicitly set novelty thresholds.

It is possible to add an index to set the novelty threshold of a specific pyramid level. For example, 'novelty_threshold_3'"novelty_threshold_3""novelty_threshold_3""novelty_threshold_3""novelty_threshold_3" sets the novelty threshold for the third pyramid level.

Values: integer or float values larger or equal to 0 and smaller or equal to 710

Default: Is determined by train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel

'sensitivity'"sensitivity""sensitivity""sensitivity""sensitivity":

This parameter influences the sensitivity of the novelty thresholds which are determined during the training with train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel. Per default 'sensitivity'"sensitivity""sensitivity""sensitivity""sensitivity" is set to 0.0, which means the novelty thresholds from the training are used directly when calling apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel. If a negative value for the parameter 'sensitivity'"sensitivity""sensitivity""sensitivity""sensitivity" is used, the value is added to the novelty boundaries. Hence, a sensitivity value below 0.0 increments the novelty thresholds and therefore leads to potentially fewer detected errors. If instead a positive value is set, the novelty thresholds are decremented which leads to potentially more detected errors.

The automatically determined novelty thresholds can be changed after the training with the parameter 'novelty_threshold'"novelty_threshold""novelty_threshold""novelty_threshold""novelty_threshold".

Values: float or integer value

Default: 0.0

Parameters that influence the texture features:

'patch_normalization'"patch_normalization""patch_normalization""patch_normalization""patch_normalization":

Determines the method used to normalize the texture features. A normalization is required if the lighting between different images is not consistent. If set to 'weber'"weber""weber""weber""weber", the patches are normalized in accordance with the Weber-Fechner law. If the parameter is set to 'none'"none""none""none""none", no feature normalization is performed.

Changing this parameter requires a complete new training of the texture inspection model.

Values: 'none'"none""none""none""none", 'weber'"weber""weber""weber""weber"

Default: 'none'"none""none""none""none"

'patch_rotational_robustness'"patch_rotational_robustness""patch_rotational_robustness""patch_rotational_robustness""patch_rotational_robustness":

If set to 'true'"true""true""true""true", the texture features are sorted in a way to obtain a certain amount of rotational invariance. Sorting the features leads to a loss of feature information and generally makes the texture inspection less sensitive. Also, the runtime is slightly increased. If the parameter is set to 'false'"false""false""false""false", the texture features are not sorted.

Alternatively, it is possible to capture all possible rotations within the training images. Increasing the training images leads to an increase of the training time.

Changing this parameter requires a complete new training of the texture inspection model.

Values: 'true'"true""true""true""true", 'false'"false""false""false""false"

Default: 'false'"false""false""false""false"

'patch_size'"patch_size""patch_size""patch_size""patch_size":

This parameter determines the diameter of the extracted texture feature patches in pixels. Higher patch sizes increase the runtime significantly. Therefore this parameter should only be changed with great care. First try to change the image resolution or the number of pyramids used.

Changing this parameter requires a complete new training of the texture inspection model.

Values: odd integer values between 1 and 11

Default: 5

Advanced parameters that influence the GMM classifiers:

Internally, the texture inspection model uses a Gaussian Mixture Model (GMM) classifier. In general, it is recommended not to change the GMM parameters, but for experienced users this is still possible.

Changing these parameters requires a new training of the texture inspection model.

In the following, the parameters which influence the GMM classifiers are described. For more information on classification with GMM classifiers, see create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmCreateClassGmm and train_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmmTrainClassGmm.

'gmm_sigma'"gmm_sigma""gmm_sigma""gmm_sigma""gmm_sigma":

This parameter determines the standard deviation of the Gaussian noise which is added to the training samples (see add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmmAddSampleClassGmm).

Values: integer or float values larger or equal to 0.0

Default: 0.0

'gmm_pmincenters'"gmm_pmincenters""gmm_pmincenters""gmm_pmincenters""gmm_pmincenters":

This parameter determines the minimum number of Gaussian distributions per class. 'gmm_pmincenters'"gmm_pmincenters""gmm_pmincenters""gmm_pmincenters""gmm_pmincenters" cannot be set to a value larger than the current value of 'gmm_pmaxcenters'"gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters".

Values: integer value larger or equal to 1 and less or equal to 'gmm_pmaxcenters'"gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters"

Default: 12

'gmm_pmaxcenters'"gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters":

This parameter determines the maximum number of Gaussian distributions per class. 'gmm_pmaxcenters'"gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters""gmm_pmaxcenters" cannot be set to a value smaller than the current value of 'gmm_pmincenters'"gmm_pmincenters""gmm_pmincenters""gmm_pmincenters""gmm_pmincenters".

Values: integer value larger or equal to 'gmm_pmincenters'"gmm_pmincenters""gmm_pmincenters""gmm_pmincenters""gmm_pmincenters"

Default: 12

'gmm_preprocessing'"gmm_preprocessing""gmm_preprocessing""gmm_preprocessing""gmm_preprocessing":

This parameter determines the type of preprocessing used to transform the feature vectors.

Values: 'principal_components'"principal_components""principal_components""principal_components""principal_components", 'none'"none""none""none""none"

Default: 'none'"none""none""none""none"

'gmm_ncomp'"gmm_ncomp""gmm_ncomp""gmm_ncomp""gmm_ncomp":

This parameter manipulates the preprocessing in case 'principal_components'"principal_components""principal_components""principal_components""principal_components" is chosen as the preprocessing method. More specifically, it determines the dimension of the transformed feature vectors. It needs to be chosen such that it is smaller than the feature dimension, which is PatchSizePatchSizePatchSizePatchSizepatchSize PatchSizePatchSizePatchSizePatchSizepatchSize. If the PatchSizePatchSizePatchSizePatchSizepatchSize is changed such that PatchSizePatchSizePatchSizePatchSizepatchSize PatchSizePatchSizePatchSizePatchSizepatchSize gmm_ncompgmm_ncompgmm_ncompgmm_ncompgmmNcomp, the parameter is manipulated accordingly.

Values: integer value larger or equal to 1

Default: 15

'gmm_randseed'"gmm_randseed""gmm_randseed""gmm_randseed""gmm_randseed":

This parameter determines the initialization value for the random number generator, which is required to initialize the GMM with random values.

Values: integer value

Default: 42

'gmm_em_max_iter'"gmm_em_max_iter""gmm_em_max_iter""gmm_em_max_iter""gmm_em_max_iter":

This parameter determines the maximum number of iterations of the expectation maximization algorithm.

Values: integer values larger or equal to 0

Default: 100

'gmm_em_threshold'"gmm_em_threshold""gmm_em_threshold""gmm_em_threshold""gmm_em_threshold":

This parameter determines the threshold for the relative change of the error for the expectation maximization algorithm to terminate.

Values: integer or float value larger or equal to 0 and smaller than 1.0

Default: 0.001

'gmm_em_regularize'"gmm_em_regularize""gmm_em_regularize""gmm_em_regularize""gmm_em_regularize":

This parameter determines the regularization value for preventing covariance matrix singularity within the training process.

Values: integer or float values larger or equal to 0 and smaller than 1.0

Default: 0.0001

Changing the parameters of a trained texture inspection model

If parameters of a texture inspection model are manipulated after a successful call of train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel, the texture inspection model usually needs to be retrained. Depending on which parameters are changed, different parts of the training need to be recalculated.

A manipulation of the parameters 'gmm_*'"gmm_*""gmm_*""gmm_*""gmm_*" requires a new training of the classifiers. Since a new classifier yields different novelty scores, the novelty thresholds also need to be recalculated. The parameter 'patch_*'"patch_*""patch_*""patch_*""patch_*" requires a complete new training of the texture inspection model. The parameters 'num_levels'"num_levels""num_levels""num_levels""num_levels" and 'levels'"levels""levels""levels""levels" require a retraining if the number of levels is increased or levels are set which were not trained beforehand. For example, setting 'levels'"levels""levels""levels""levels" from [1,2,3] to [1,3] does not require a retraining. The operator 'gen_result_handle'"gen_result_handle""gen_result_handle""gen_result_handle""gen_result_handle" has no effect on a trained texture inspection model and can be manipulated without requiring any retraining.

Execution Information

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

TextureInspectionModelTextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModel (input_control, state is modified)  texture_inspection_model HTextureInspectionModel, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of the texture inspection model.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the model parameter to be adjusted.

Default value: 'gen_result_handle' "gen_result_handle" "gen_result_handle" "gen_result_handle" "gen_result_handle"

List of values: 'gen_result_handle'"gen_result_handle""gen_result_handle""gen_result_handle""gen_result_handle", '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", '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 (input_control)  attribute.value(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

New value of the model parameter.

Default value: 'true' "true" "true" "true" "true"

List of values: 5, 'auto'"auto""auto""auto""auto", 'false'"false""false""false""false", 'none'"none""none""none""none", 'normalization'"normalization""normalization""normalization""normalization", 'principal_components'"principal_components""principal_components""principal_components""principal_components", 'true'"true""true""true""true", 'weber'"weber""weber""weber""weber"

Example (HDevelop)

* Create texture inspection model
create_texture_inspection_model ('basic', TextureInspectionModel)
* Set parameters
set_texture_inspection_model_param (TextureInspectionModel, \
                                    'gen_result_handle', 'true')
* Make this short example fast:
set_texture_inspection_model_param (TextureInspectionModel, \
                                    'gmm_em_max_iter', 1)
* 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)
clear_texture_inspection_result (TextureInspectionResultID)

Result

The operator set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam 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

Possible Successors

add_texture_inspection_model_imageadd_texture_inspection_model_imageAddTextureInspectionModelImageAddTextureInspectionModelImageAddTextureInspectionModelImage, train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel

See also

get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParam

Module

Matching


ClassesClasses | | Operators