Operator Reference

reduce_class_svmT_reduce_class_svmReduceClassSvmReduceClassSvmreduce_class_svm (Operator)

reduce_class_svmT_reduce_class_svmReduceClassSvmReduceClassSvmreduce_class_svm — Approximate a trained support vector machine by a reduced support vector machine for faster classification.

Signature

Herror T_reduce_class_svm(const Htuple SVMHandle, const Htuple Method, const Htuple MinRemainingSV, const Htuple MaxError, Htuple* SVMHandleReduced)

void ReduceClassSvm(const HTuple& SVMHandle, const HTuple& Method, const HTuple& MinRemainingSV, const HTuple& MaxError, HTuple* SVMHandleReduced)

HClassSvm HClassSvm::ReduceClassSvm(const HString& Method, Hlong MinRemainingSV, double MaxError) const

HClassSvm HClassSvm::ReduceClassSvm(const char* Method, Hlong MinRemainingSV, double MaxError) const

HClassSvm HClassSvm::ReduceClassSvm(const wchar_t* Method, Hlong MinRemainingSV, double MaxError) const   ( Windows only)

static void HOperatorSet.ReduceClassSvm(HTuple SVMHandle, HTuple method, HTuple minRemainingSV, HTuple maxError, out HTuple SVMHandleReduced)

HClassSvm HClassSvm.ReduceClassSvm(string method, int minRemainingSV, double maxError)

def reduce_class_svm(svmhandle: HHandle, method: str, min_remaining_sv: int, max_error: float) -> HHandle

Description

As described in create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmcreate_class_svm, the classification time of a SVM depends on the number of kernel evaluations between the support vectors and the feature vectors. While the length of the data vectors can be reduced in a preprocessing step like 'principal_components'"principal_components""principal_components""principal_components""principal_components" or 'canonical_variates'"canonical_variates""canonical_variates""canonical_variates""canonical_variates" (see create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmcreate_class_svm for details), the number of resulting SV depends on the complexity of the classification problem. The number of SVs is determined during training. To further reduce classification time, the number of SVs can be reduced by approximating the original separating hyperplane with fewer SVs than originally required. For this purpose, a copy of the original SVM provided by SVMHandleSVMHandleSVMHandleSVMHandlesvmhandle is created and returned in SVMHandleReducedSVMHandleReducedSVMHandleReducedSVMHandleReducedsvmhandle_reduced. This new SVM has the same parametrization as the original SVM, but a different SV expansion. The training samples that are included in SVMHandleSVMHandleSVMHandleSVMHandlesvmhandle are not copied. The original SVM is not modified by reduce_class_svmreduce_class_svmReduceClassSvmReduceClassSvmreduce_class_svm.

The reduction method is selected with MethodMethodMethodmethodmethod. Currently, only a bottom up approach is supported, which iteratively merges SVs. The algorithm stops if either the minimum number of SVs is reached (MinRemainingSVMinRemainingSVMinRemainingSVminRemainingSVmin_remaining_sv) or if the accumulated maximum error exceeds the threshold MaxErrorMaxErrorMaxErrormaxErrormax_error. Note that the approximation reduces the complexity of the hyperplane and thereby leads to a deteriorated classification rate. A common approach is therefore to start from a small MaxErrorMaxErrorMaxErrormaxErrormax_error e.g., 0.001, and to increase its value step by step. To control the reduction ratio, at each step the number of remaining SVs is determined with get_support_vector_num_class_svmget_support_vector_num_class_svmGetSupportVectorNumClassSvmGetSupportVectorNumClassSvmget_support_vector_num_class_svm and the classification rate is checked on a separate test data set with classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmclassify_class_svm.

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

SVMHandleSVMHandleSVMHandleSVMHandlesvmhandle (input_control)  class_svm HClassSvm, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Original SVM handle.

MethodMethodMethodmethodmethod (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Type of postprocessing to reduce number of SV.

Default: 'bottom_up' "bottom_up" "bottom_up" "bottom_up" "bottom_up"

List of values: 'bottom_up'"bottom_up""bottom_up""bottom_up""bottom_up"

MinRemainingSVMinRemainingSVMinRemainingSVminRemainingSVmin_remaining_sv (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Minimum number of remaining SVs.

Default: 2

Suggested values: 2, 3, 4, 5, 7, 10, 15, 20, 30, 50

Restriction: MinRemainingSV >= 2

MaxErrorMaxErrorMaxErrormaxErrormax_error (input_control)  real HTuplefloatHTupleHtuple (real) (double) (double) (double)

Maximum allowed error of reduction.

Default: 0.001

Suggested values: 0.0001, 0.0002, 0.0005, 0.001, 0.002, 0.005, 0.01, 0.02, 0.05

Restriction: MaxError > 0.0

SVMHandleReducedSVMHandleReducedSVMHandleReducedSVMHandleReducedsvmhandle_reduced (output_control)  class_svm HClassSvm, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

SVMHandle of reduced SVM.

Example (HDevelop)

* Train an SVM
create_class_svm (NumFeatures, 'rbf', 0.01, 0.01, NumClasses,\
                  'one-versus-all', 'normalization', NumFeatures,\
                  SVMHandle)
read_samples_class_svm (SVMHandle, 'samples.mtf')
train_class_svm (SVMHandle, 0.001, 'default')
* Create a reduced SVM
reduce_class_svm (SVMHandle, 'bottom_up', 2, 0.01, SVMHandleReduced)
write_class_svm (SVMHandleReduced, 'classifier.svm')

Result

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

Possible Predecessors

train_class_svmtrain_class_svmTrainClassSvmTrainClassSvmtrain_class_svm, get_support_vector_num_class_svmget_support_vector_num_class_svmGetSupportVectorNumClassSvmGetSupportVectorNumClassSvmget_support_vector_num_class_svm

Possible Successors

classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmclassify_class_svm, write_class_svmwrite_class_svmWriteClassSvmWriteClassSvmwrite_class_svm, get_support_vector_num_class_svmget_support_vector_num_class_svmGetSupportVectorNumClassSvmGetSupportVectorNumClassSvmget_support_vector_num_class_svm

See also

train_class_svmtrain_class_svmTrainClassSvmTrainClassSvmtrain_class_svm

Module

Foundation