Operator Reference

HALCON Operator Reference / Inspection / Texture Inspection
ClassesClasses | | Operators

deserialize_texture_inspection_modelT_deserialize_texture_inspection_modelDeserializeTextureInspectionModelDeserializeTextureInspectionModeldeserialize_texture_inspection_model (Operator)

deserialize_texture_inspection_modelT_deserialize_texture_inspection_modelDeserializeTextureInspectionModelDeserializeTextureInspectionModeldeserialize_texture_inspection_model — Deserialize a serialized texture inspection model.

Signature

deserialize_texture_inspection_model( : : SerializedItemHandle : TextureInspectionModel)

Herror T_deserialize_texture_inspection_model(const Htuple SerializedItemHandle, Htuple* TextureInspectionModel)

void DeserializeTextureInspectionModel(const HTuple& SerializedItemHandle, HTuple* TextureInspectionModel)

void HTextureInspectionModel::DeserializeTextureInspectionModel(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeTextureInspectionModel(HTuple serializedItemHandle, out HTuple textureInspectionModel)

void HTextureInspectionModel.DeserializeTextureInspectionModel(HSerializedItem serializedItemHandle)

def deserialize_texture_inspection_model(serialized_item_handle: HHandle) -> HHandle

Description

deserialize_texture_inspection_modeldeserialize_texture_inspection_modelDeserializeTextureInspectionModelDeserializeTextureInspectionModeldeserialize_texture_inspection_model deserializes a texture inspection model, that was serialized by serialize_texture_inspection_modelserialize_texture_inspection_modelSerializeTextureInspectionModelSerializeTextureInspectionModelserialize_texture_inspection_model (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized texture inspection model is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created texture inspection model with the handle TextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModeltexture_inspection_model.

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

Execution Information

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

This operator modifies the state of the following input parameter:

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

TextureInspectionModelTextureInspectionModelTextureInspectionModeltextureInspectionModeltexture_inspection_model (output_control, state is modified)  texture_inspection_model → HTextureInspectionModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the texture inspection model.

Example (HDevelop)

* Create texture inspection model
create_texture_inspection_model ('basic', TextureInspectionModel)
* Set parameters
set_texture_inspection_model_param (TextureInspectionModel, \
                                    'gen_result_handle', 'true')
* 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)
* Serialize texture inspection model
serialize_texture_inspection_model (TextureInspectionModel, \
                                    SerializedItemHandle)
* Deserialize in Model
deserialize_texture_inspection_model (SerializedItemHandle, \
                                      TextureInspectionModelSerialized)
* Read and apply a test image
read_image (TestImage, 'carpet/carpet_02')
apply_texture_inspection_model (TestImage, DefectCandidates, \
                                TextureInspectionModelSerialized, \
                                TextureInspectionResultID)

Result

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

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_texture_inspection_modelserialize_texture_inspection_modelSerializeTextureInspectionModelSerializeTextureInspectionModelserialize_texture_inspection_model

Possible Successors

apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model

See also

create_texture_inspection_modelcreate_texture_inspection_modelCreateTextureInspectionModelCreateTextureInspectionModelcreate_texture_inspection_model, write_texture_inspection_modelwrite_texture_inspection_modelWriteTextureInspectionModelWriteTextureInspectionModelwrite_texture_inspection_model, serialize_texture_inspection_modelserialize_texture_inspection_modelSerializeTextureInspectionModelSerializeTextureInspectionModelserialize_texture_inspection_model

Module

Matching

ClassesClasses | | Operators