write_texture_inspection_modelT_write_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModel (Operator)

Name

write_texture_inspection_modelT_write_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModel — Write a texture inspection model to a file.

Signature

write_texture_inspection_model( : : TextureInspectionModel, FileName : )

Herror T_write_texture_inspection_model(const Htuple TextureInspectionModel, const Htuple FileName)

void WriteTextureInspectionModel(const HTuple& TextureInspectionModel, const HTuple& FileName)

void HTextureInspectionModel::WriteTextureInspectionModel(const HString& FileName) const

void HTextureInspectionModel::WriteTextureInspectionModel(const char* FileName) const

void HTextureInspectionModel::WriteTextureInspectionModel(const wchar_t* FileName) const   (Windows only)

static void HOperatorSet.WriteTextureInspectionModel(HTuple textureInspectionModel, HTuple fileName)

void HTextureInspectionModel.WriteTextureInspectionModel(string fileName)

Description

write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModel writes the texture inspection model TextureInspectionModelTextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModel to the file given by FileNameFileNameFileNameFileNamefileName. The default HALCON file extension for the texture inspection model is 'htim'. write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModel is typically called after the texture inspection model has been trained with train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel. However, it can also be used to save an untrained model. The texture inspection model can be read with read_texture_inspection_modelread_texture_inspection_modelReadTextureInspectionModelReadTextureInspectionModelReadTextureInspectionModel. It should be noted that write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModel 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 Inspection.

Execution Information

Parameters

TextureInspectionModelTextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModel (input_control)  texture_inspection_model HTextureInspectionModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the texture inspection model.

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write HTupleHTupleHtuple (string) (string) (HString) (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_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelWriteTextureInspectionModel returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

train_texture_inspection_modeltrain_texture_inspection_modelTrainTextureInspectionModelTrainTextureInspectionModelTrainTextureInspectionModel

Possible Successors

clear_texture_inspection_modelclear_texture_inspection_modelClearTextureInspectionModelClearTextureInspectionModelClearTextureInspectionModel

See also

create_texture_inspection_modelcreate_texture_inspection_modelCreateTextureInspectionModelCreateTextureInspectionModelCreateTextureInspectionModel, clear_texture_inspection_modelclear_texture_inspection_modelClearTextureInspectionModelClearTextureInspectionModelClearTextureInspectionModel, set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam, get_texture_inspection_model_paramget_texture_inspection_model_paramGetTextureInspectionModelParamGetTextureInspectionModelParamGetTextureInspectionModelParam, add_texture_inspection_model_imageadd_texture_inspection_model_imageAddTextureInspectionModelImageAddTextureInspectionModelImageAddTextureInspectionModelImage

Module

Matching