Skip to content

serialize_dl_modelSerializeDlModelSerializeDlModelserialize_dl_modelT_serialize_dl_model🔗

Short description🔗

serialize_dl_modelSerializeDlModelSerializeDlModelserialize_dl_modelT_serialize_dl_model — Serialize a deep learning model.

Signature🔗

serialize_dl_model( dl_model DLModelHandle, out serialized_item SerializedItemHandle )void SerializeDlModel( const HTuple& DLModelHandle, HTuple* SerializedItemHandle )static void HOperatorSet.SerializeDlModel( HTuple DLModelHandle, out HTuple serializedItemHandle )def serialize_dl_model( dlmodel_handle: HHandle ) -> HHandle

Herror T_serialize_dl_model( const Htuple DLModelHandle, Htuple* SerializedItemHandle )

HSerializedItem HDlModel::SerializeDlModel( ) const

HSerializedItem HDlModel.SerializeDlModel( )

Description🔗

serialize_dl_modelSerializeDlModel serializes the deep learning model defined by the handle DLModelHandleDLModelHandledlmodel_handle. The serialized model is returned by the handle SerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by deserialize_dl_modelDeserializeDlModel. See fwrite_serialized_itemFwriteSerializedItem for an introduction of the basic principle of serialization.

The operator acts the same as write_dl_modelWriteDlModel except that the output is a serialized item instead of a file. For a detailed description please refer to the documentation of write_dl_modelWriteDlModel.

For further explanations to deep learning models in HALCON, see the chapter Deep Learning / Model.

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🔗

DLModelHandleDLModelHandledlmodel_handle (input_control) dl_model → (handle)HTuple (HHandle)HDlModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the deep learning model.

SerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → (handle)HTuple (HHandle)HSerializedItem, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the serialized item.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

train_dl_model_batchTrainDlModelBatch, train_dl_model_anomaly_datasetTrainDlModelAnomalyDataset

Possible successors

train_dl_model_batchTrainDlModelBatch, train_dl_model_anomaly_datasetTrainDlModelAnomalyDataset, fwrite_serialized_itemFwriteSerializedItem, send_serialized_itemSendSerializedItem

See also

deserialize_dl_modelDeserializeDlModel, apply_dl_modelApplyDlModel, train_dl_model_batchTrainDlModelBatch, train_dl_model_anomaly_datasetTrainDlModelAnomalyDataset

Module🔗

This operator uses dynamic licensing (see the ‘Installation Guide’). Which of the following modules is required depends on the specific usage of the operator:

3D Metrology, OCR/OCV, Deep Learning Enhanced, Deep Learning Professional, Matching