write_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelwrite_texture_inspection_modelT_write_texture_inspection_model🔗

Short description🔗

write_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelwrite_texture_inspection_modelT_write_texture_inspection_model — Write a texture inspection model to a file.

Signature🔗

write_texture_inspection_model( texture_inspection_model TextureInspectionModel, filename.write FileName )

Description🔗

write_texture_inspection_modelWriteTextureInspectionModel writes the texture inspection model TextureInspectionModeltextureInspectionModeltexture_inspection_model to the file given by FileNamefileNamefile_name. The default HALCON file extension for the texture inspection model is 'htim'. write_texture_inspection_modelWriteTextureInspectionModel is typically called after the texture inspection model has been trained with train_texture_inspection_modelTrainTextureInspectionModel. However, it can also be used to save an untrained model. The texture inspection model can be read with read_texture_inspection_modelReadTextureInspectionModel. It should be noted that write_texture_inspection_modelWriteTextureInspectionModel does not write any training samples that possibly have been stored in the texture inspection model. Instead, only the currently set parameters of the model, possibly added images and, if trained, the classifiers of the single pyramid levels are written.

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

Execution information🔗

Execution information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters🔗

TextureInspectionModeltextureInspectionModeltexture_inspection_model (input_control) texture_inspection_model → (handle)HTuple (HHandle)HHandleHtuple (handle)

Handle of the texture inspection model.

FileNamefileNamefile_name (input_control) filename.write → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name.

File extension: .htim

Example🔗

(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')

Result🔗

If the parameters are valid, the operator write_texture_inspection_modelWriteTextureInspectionModel returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

train_texture_inspection_modelTrainTextureInspectionModel

Possible successors

clear_texture_inspection_modelClearTextureInspectionModel

Module🔗

Matching