serialize_dl_classifierT_serialize_dl_classifierSerializeDlClassifierSerializeDlClassifierserialize_dl_classifier (Operator)

Name

serialize_dl_classifierT_serialize_dl_classifierSerializeDlClassifierSerializeDlClassifierserialize_dl_classifier — Serialize a deep-learning-based classifier.

Warning

serialize_dl_classifierserialize_dl_classifierSerializeDlClassifierSerializeDlClassifierserialize_dl_classifier is obsolete and is only provided for reasons of backward compatibility. The operator will be removed with HALCON 25.05. New applications should use the common CNN-based operator serialize_dl_modelserialize_dl_modelSerializeDlModelSerializeDlModelserialize_dl_model.

Signature

serialize_dl_classifier( : : DLClassifierHandle : SerializedItemHandle)

Description

serialize_dl_classifierserialize_dl_classifierSerializeDlClassifierSerializeDlClassifierserialize_dl_classifier serializes a deep-learning-based classifier (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The classifier is defined by the handle DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandledlclassifier_handle. The serialized classifier is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by deserialize_dl_classifierdeserialize_dl_classifierDeserializeDlClassifierDeserializeDlClassifierdeserialize_dl_classifier.

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

For an explanation of the concept of deep-learning-based classification see the introduction of chapter Deep Learning / Classification. The workflow involving this legacy operator is described in the chapter Legacy / DL Classification.

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

DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandledlclassifier_handle (input_control) dl_classifier → (handle)

Handle of the deep-learning-based classifier.

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → (handle)

Handle of the serialized item.

Result

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