remove_texture_inspection_model_image — 清除纹理检查模型的所有图像或用户定义的图像子集。
remove_texture_inspection_model_image( : : TextureInspectionModel, Indices : RemainingIndices)
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。
有关纹理检查概念的说明，请参阅 检查 / 纹理检查 一章的引言。
此算子修改后续输入参数的状态：
在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。
TextureInspectionModel (输入控制，状态被修改) texture_inspection_model(-array) → (handle)
纹理检查模型的句柄。
Indices (输入控制) integer-array → (integer)
Indices of the images to be deleted from the texture inspection model.
RemainingIndices (输出控制) integer-array → (integer)
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)
如果参数有效，算子
remove_texture_inspection_model_image 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
train_texture_inspection_model
create_texture_inspection_model,
clear_texture_inspection_model,
set_texture_inspection_model_param,
get_texture_inspection_model_param,
add_texture_inspection_model_image
匹配