read_class_svmT_read_class_svmReadClassSvmReadClassSvm (Operator)

Name

read_class_svmT_read_class_svmReadClassSvmReadClassSvm — Read a support vector machine from a file.

Signature

read_class_svm( : : FileName : SVMHandle)

Description

read_class_svmread_class_svmReadClassSvmReadClassSvmReadClassSvm reads a support vector machine (SVM) that has been stored with write_class_svmwrite_class_svmWriteClassSvmWriteClassSvmWriteClassSvm. Since the training of an SVM can consume a relatively long time, the SVM is typically trained in an offline process and written to a file with write_class_svmwrite_class_svmWriteClassSvmWriteClassSvmWriteClassSvm. In the online process the SVM is read with read_class_svmread_class_svmReadClassSvmReadClassSvmReadClassSvm and subsequently used for classification with classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmClassifyClassSvm. The default HALCON file extension for the SVM classifier is 'gsc'.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

File name.

File extension: .gsc

SVMHandleSVMHandleSVMHandleSVMHandleSVMHandle (output_control) class_svm → (handle)

SVM handle.

Result

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