add_texture_inspection_model_image — Add training images to the texture inspection model.
add_texture_inspection_model_image adds training images
to the texture inspection model (
The domain of the training images is considered in all further calculations.
Since the feature extraction considers a certain
neighborhood of each pixel, no features can be extracted for pixels at the
border of the domain. The border size () depends on the
'patch_size' and computes to
All images which are added to the texture inspection model are used within
the training process (see
train_texture_inspection_model for more
information). Furthermore, it is possible to query all of the images passed
to the texture inspection model with
Every added image receives an index (
Indices), which allows the user
to generate an assignment between the added images and his image data.
By calls of
remove_texture_inspection_model_image, the index can
further be used to delete images from the model that are not needed anymore.
It is possible to add either gray-scale images or multichannel images. However, all of the passed images should have the same number of channels.
For an explanation of the concept of the texture inspection see the introduction of chapter Inspection / Texture Inspection.
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.
→object (byte / uint2 / real)
Image of flawless texture.
TextureInspectionModel(input_control, state is modified) texture_inspection_model
Handle of the texture inspection model.
Indices of the images that have been added to the texture inspection model.
* 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) * 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 (TrainImage, 'carpet/carpet_02') apply_texture_inspection_model (TestImage, DefectCandidates, \ TextureInspectionModel, \ TextureInspectionResultID)
add_texture_inspection_model_image returns the value
TRUE if the given parameters are valid and within acceptable range.
Otherwise, an exception will be raised.