write_dl_classifierT_write_dl_classifierWriteDlClassifierWriteDlClassifier (Operator)
Name
write_dl_classifierT_write_dl_classifierWriteDlClassifierWriteDlClassifier
— Write a deep-learning-based classifier in a file.
Warning
write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierWriteDlClassifier
is obsolete and is only provided for
reasons of backward compatibility. New applications should use the common
CNN-based operator write_dl_modelwrite_dl_modelWriteDlModelWriteDlModelWriteDlModel
instead.
Signature
Description
write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierWriteDlClassifier
writes the deep-learning-based classifier
DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandle
to the file given by FileNameFileNameFileNameFileNamefileName
.
write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierWriteDlClassifier
is typically called after the classifier has
been trained with train_dl_classifier_batchtrain_dl_classifier_batchTrainDlClassifierBatchTrainDlClassifierBatchTrainDlClassifierBatch
. The classifier can be
read with read_dl_classifierread_dl_classifierReadDlClassifierReadDlClassifierReadDlClassifier
.
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'".hdl"".hdl"".hdl"".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
DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandle
(input_control) dl_classifier →
HDlClassifier, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the deep-learning-based classifier.
FileNameFileNameFileNameFileNamefileName
(input_control) filename.write →
HTupleHTupleHtuple (string) (string) (HString) (char*)
File name.
File extension: .hdl
Result
If the parameters are valid, the operator
write_dl_classifierwrite_dl_classifierWriteDlClassifierWriteDlClassifierWriteDlClassifier
returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
Possible Predecessors
read_dl_classifierread_dl_classifierReadDlClassifierReadDlClassifierReadDlClassifier
,
train_dl_classifier_batchtrain_dl_classifier_batchTrainDlClassifierBatchTrainDlClassifierBatchTrainDlClassifierBatch
,
set_dl_classifier_paramset_dl_classifier_paramSetDlClassifierParamSetDlClassifierParamSetDlClassifierParam
Alternatives
write_dl_modelwrite_dl_modelWriteDlModelWriteDlModelWriteDlModel
Module
Deep Learning Inference