read_texture_inspection_modelT_read_texture_inspection_modelReadTextureInspectionModelReadTextureInspectionModelread_texture_inspection_model (算子名称)

名称

read_texture_inspection_modelT_read_texture_inspection_modelReadTextureInspectionModelReadTextureInspectionModelread_texture_inspection_model — Read a texture inspection model from a file.

参数签名

描述

read_texture_inspection_modelread_texture_inspection_modelReadTextureInspectionModelReadTextureInspectionModelReadTextureInspectionModelread_texture_inspection_model reads a texture inspection model that has been stored with write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModelwrite_texture_inspection_model. Since the training of a texture inspection model can consume a relatively long time, the texture inspection model is typically trained in an offline process and written to a file with write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModelwrite_texture_inspection_model. In the online process the texture inspection model is read with read_texture_inspection_modelread_texture_inspection_modelReadTextureInspectionModelReadTextureInspectionModelReadTextureInspectionModelread_texture_inspection_model and subsequently used for evaluation with apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model. The default HALCON file extension for the texture inspection model is 'htim'.

After reading a trained texture inspection model, it is possible to classify test images using apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model. However, retraining this model can only be done, if the read model has images. Furthermore, modifying parameters of the model leads to an entire retraining.

For an explanation of the concept of the texture inspection see the introduction of chapter Inspection / Texture Inspection.

运行信息

• 多线程类型:可重入(与非独占操作符并行运行)。
• 多线程作用域:全局(可以从任何线程调用)。
• 未经并行化处理。

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

参数表

例程 (HDevelop)

* 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)
* Write out texture inspection model
write_texture_inspection_model (TextureInspectionModel, \
                                'ExampleModel.htim')
* Read in Model
read_texture_inspection_model ('ExampleModel.htim', \
                               TextureInspectionModelRead)
* Read and apply a test image
read_image (TestImage, 'carpet/carpet_02')
apply_texture_inspection_model (TestImage, DefectCandidates, \
                                TextureInspectionModelRead, \
                                TextureInspectionResultID)

结果

如果参数均有效，算子 read_texture_inspection_modelread_texture_inspection_modelReadTextureInspectionModelReadTextureInspectionModelReadTextureInspectionModelread_texture_inspection_model 返回值 2 ( H_MSG_TRUE) . If necessary an exception is raised.

可能的前置算子

write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModelwrite_texture_inspection_model

可能的后置算子

apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model

参考其它

create_texture_inspection_modelcreate_texture_inspection_modelCreateTextureInspectionModelCreateTextureInspectionModelCreateTextureInspectionModelcreate_texture_inspection_model, clear_texture_inspection_modelclear_texture_inspection_modelClearTextureInspectionModelClearTextureInspectionModelClearTextureInspectionModelclear_texture_inspection_model, set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParamset_texture_inspection_model_param, get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParamget_texture_inspection_model_param, add_texture_inspection_model_imageadd_texture_inspection_model_imageAddTextureInspectionModelImageAddTextureInspectionModelImageAddTextureInspectionModelImageadd_texture_inspection_model_image

模块

Matching

---