Operator Reference

HALCON Operator Reference / Legacy / DL Classification

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

write_dl_classifierT_write_dl_classifierWriteDlClassifierWriteDlClassifierwrite_dl_classifier (Operator)

write_dl_classifierT_write_dl_classifierWriteDlClassifierWriteDlClassifierwrite_dl_classifier — Write a deep-learning-based classifier in a file.

Warning

write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierwrite_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 write_dl_modelwrite_dl_modelWriteDlModelWriteDlModelwrite_dl_model instead.

Signature

write_dl_classifier( : : DLClassifierHandle, FileName : )

Herror T_write_dl_classifier(const Htuple DLClassifierHandle, const Htuple FileName)

void WriteDlClassifier(const HTuple& DLClassifierHandle, const HTuple& FileName)

void HDlClassifier::WriteDlClassifier(const HString& FileName) const

void HDlClassifier::WriteDlClassifier(const char* FileName) const

void HDlClassifier::WriteDlClassifier(const wchar_t* FileName) const   ( Windows only)

static void HOperatorSet.WriteDlClassifier(HTuple DLClassifierHandle, HTuple fileName)

void HDlClassifier.WriteDlClassifier(string fileName)

def write_dl_classifier(dlclassifier_handle: HHandle, file_name: str) -> None

Description

write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierwrite_dl_classifier writes the deep-learning-based classifier DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandledlclassifier_handle to the file given by FileNameFileNameFileNamefileNamefile_name.

write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierwrite_dl_classifier is typically called after the classifier has been trained with train_dl_classifier_batchtrain_dl_classifier_batchTrainDlClassifierBatchTrainDlClassifierBatchtrain_dl_classifier_batch. The classifier can be read with read_dl_classifierread_dl_classifierReadDlClassifierReadDlClassifierread_dl_classifier.

Please note that the runtime specific parameter 'gpu'"gpu""gpu""gpu""gpu" of the classifier is not written.

The default HALCON file extension for deep learning classifiers is '.hdl'.

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 → HDlClassifier, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the deep-learning-based classifier.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

File name.

File extension: .hdl

Result

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

Possible Predecessors

read_dl_classifierread_dl_classifierReadDlClassifierReadDlClassifierread_dl_classifier, train_dl_classifier_batchtrain_dl_classifier_batchTrainDlClassifierBatchTrainDlClassifierBatchtrain_dl_classifier_batch, set_dl_classifier_paramset_dl_classifier_paramSetDlClassifierParamSetDlClassifierParamset_dl_classifier_param

Alternatives

write_dl_modelwrite_dl_modelWriteDlModelWriteDlModelwrite_dl_model

Module

Deep Learning Enhanced

---

ClassesClasses | | Operators