read_texture_inspection_model — Read a texture inspection model from a file.
read_texture_inspection_model reads a texture inspection model that
has been stored with
write_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_model. In the online
process the texture inspection model is read with
read_texture_inspection_model and subsequently used for evaluation
The default HALCON file extension for the texture inspection model is
After reading a trained texture inspection model, it is possible to
classify test images using
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.
File extension: .
Handle of 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) * 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)
If the parameters are valid, the operator
read_texture_inspection_model returns the value 2 (H_MSG_TRUE). If necessary
an exception is raised.