Operator Reference
clear_dl_classifier (Operator)
clear_dl_classifier
— Clear a deep-learning-based classifier.
Warning
clear_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 used CNN-based operator clear_dl_model
instead.
Signature
clear_dl_classifier( : : DLClassifierHandle : )
Description
clear_dl_classifier
clears the handle of the deep-learning-based
classifier given by DLClassifierHandle
, that was created with
read_dl_classifier
, and frees all memory required for the
classifier.
After calling clear_dl_classifier
, the classifier can no longer be
used. The handle DLClassifierHandle
becomes invalid.
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: local (may only be called from the same thread in which the window, model, or tool instance was created).
- 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
DLClassifierHandle
(input_control, state is modified) dl_classifier(-array) →
(handle)
Handle of the deep-learning-based classifier.
Result
If the parameters are valid, the operator
clear_dl_classifier
returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
read_dl_classifier
,
apply_dl_classifier
,
train_dl_classifier_batch
Module
Deep Learning Enhanced