Operator Reference

clear_dl_classifierT_clear_dl_classifierClearDlClassifierClearDlClassifierclear_dl_classifier (Operator)

clear_dl_classifierT_clear_dl_classifierClearDlClassifierClearDlClassifierclear_dl_classifier — Clear a deep-learning-based classifier.

Warning

clear_dl_classifierclear_dl_classifierClearDlClassifierClearDlClassifierclear_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_modelclear_dl_modelClearDlModelClearDlModelclear_dl_model instead.

Signature

clear_dl_classifier( : : DLClassifierHandle : )

Herror T_clear_dl_classifier(const Htuple DLClassifierHandle)

void ClearDlClassifier(const HTuple& DLClassifierHandle)

static void HDlClassifier::ClearDlClassifier(const HDlClassifierArray& DLClassifierHandle)

void HDlClassifier::ClearDlClassifier() const

static void HOperatorSet.ClearDlClassifier(HTuple DLClassifierHandle)

static void HDlClassifier.ClearDlClassifier(HDlClassifier[] DLClassifierHandle)

void HDlClassifier.ClearDlClassifier()

def clear_dl_classifier(dlclassifier_handle: MaybeSequence[HHandle]) -> None

Description

clear_dl_classifierclear_dl_classifierClearDlClassifierClearDlClassifierclear_dl_classifier clears the handle of the deep-learning-based classifier given by DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandledlclassifier_handle, that was created with read_dl_classifierread_dl_classifierReadDlClassifierReadDlClassifierread_dl_classifier, and frees all memory required for the classifier. After calling clear_dl_classifierclear_dl_classifierClearDlClassifierClearDlClassifierclear_dl_classifier, the classifier can no longer be used. The handle DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandledlclassifier_handle 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

DLClassifierHandleDLClassifierHandleDLClassifierHandleDLClassifierHandledlclassifier_handle (input_control, state is modified)  dl_classifier(-array) HDlClassifier, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the deep-learning-based classifier.

Result

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

Possible Predecessors

read_dl_classifierread_dl_classifierReadDlClassifierReadDlClassifierread_dl_classifier, apply_dl_classifierapply_dl_classifierApplyDlClassifierApplyDlClassifierapply_dl_classifier, train_dl_classifier_batchtrain_dl_classifier_batchTrainDlClassifierBatchTrainDlClassifierBatchtrain_dl_classifier_batch

Module

Deep Learning Enhanced