remove_texture_inspection_model_image — Clear all or a user-defined subset of the images of a
texture inspection model.
remove_texture_inspection_model_image clears all or certain selected
images that have been stored in a texture inspection model
On the one hand, the usage of
is recommended to reduce the storage space of a saved texture inspection
model. This is especially of advantage if the texture inspection model has
been trained in an offline process and written with
write_texture_inspection_model. In this case, test images
can still be classified using
while the required storage space is reduced to a minimum.
On the other hand, it offers a simple way to delete certain selected images
of the texture inspection model that are not needed (anymore) for a
subsequent classification process.
This allows the user to proceed with an entirely configured model, while
only the used image data has to be tuned to solve the underlying inspection
problem. Please note that after removing images from the model a retraining
In order to specifically delete images from the texture inspection model,
the indices of the respective images have to be specified in the
Indices. A validation of all images that are still in the
texture inspection model can be made using the value 'image_indices'
If the user still passes unassigned indices to delete images, these indices
Besides the above mentioned option,
remove_texture_inspection_model_image also allows to set the
Indices to the value 'all'. In this case,
all images of the texture inspection model are deleted.
It should be noted that after deleting all images, the model can only be
(re)trained, if new images are added using
In the case that only a subset of all images has been deleted, a call of
train_texture_inspection_model requires all steps of the training to
be executed, since potentially still available training data does not match
the used data.
remove_texture_inspection_model_image, the remaining
indices of the images that are still in the texture inspection model are
returned in the parameter
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.
TextureInspectionModel(input_control, state is modified) texture_inspection_model(-array)
Handle of the texture inspection model.
Indices of the images to be deleted from the texture inspection model.
Indices of the images that remain in the texture inspection model.
* Create texture inspection model create_texture_inspection_model ('basic', TextureInspectionModel) * Read and add training images read_image (TrainImage, 'carpet/carpet_01') add_texture_inspection_model_image (TrainImage, TextureInspectionModel, \ Indices) * Get added training images get_texture_inspection_model_image (TrainImageOut, TextureInspectionModel) * Remove training images remove_texture_inspection_model_image (TextureInspectionModel, Indices, \ RemainingIndices)
If the parameters are valid, the operator
remove_texture_inspection_model_image returns the value 2 (H_MSG_TRUE). If
necessary an exception is raised.