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 TextureInspectionModel.
On the one hand, the usage of remove_texture_inspection_model_image 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 apply_texture_inspection_model, 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 is required.
In order to specifically delete images from the texture inspection model, the indices of the respective images have to be specified in the parameter Indices. A validation of all images that are still in the texture inspection model can be made using the value 'image_indices' in get_texture_inspection_model_param. If the user still passes unassigned indices to delete images, these indices are ignored. Besides the above mentioned option, remove_texture_inspection_model_image also allows to set the parameter 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 add_texture_inspection_model_image. 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.
After calling remove_texture_inspection_model_image, the remaining indices of the images that are still in the texture inspection model are returned in the parameter RemainingIndices.
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:
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) * Clean up clear_texture_inspection_model (TextureInspectionModel)
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.
create_texture_inspection_model, clear_texture_inspection_model, set_texture_inspection_model_param, get_texture_inspection_model_param, add_texture_inspection_model_image