get_support_vector_class_svmT_get_support_vector_class_svmGetSupportVectorClassSvmget_support_vector_class_svmGetSupportVectorClassSvmGetSupportVectorClassSvm (Operator)

Name

get_support_vector_class_svmT_get_support_vector_class_svmGetSupportVectorClassSvmget_support_vector_class_svmGetSupportVectorClassSvmGetSupportVectorClassSvm — Return the index of a support vector from a trained support vector machine.

Signature

get_support_vector_class_svm( : : SVMHandle, IndexSupportVector : Index)

Description

The operator get_support_vector_class_svmget_support_vector_class_svmGetSupportVectorClassSvmget_support_vector_class_svmGetSupportVectorClassSvmGetSupportVectorClassSvm maps a support vector of a trained SVM (given in SVMHandleSVMHandleSVMHandleSVMHandleSVMHandleSVMHandle) to the original training data set. The index of the SV is specified with IndexSupportVectorIndexSupportVectorIndexSupportVectorIndexSupportVectorIndexSupportVectorindexSupportVector. The index is counted from 0, i.e., IndexSupportVectorIndexSupportVectorIndexSupportVectorIndexSupportVectorIndexSupportVectorindexSupportVector must be a number between 0 and NumSupportVectors - 1, where NumSupportVectors can be determined with get_support_vector_num_class_svmget_support_vector_num_class_svmGetSupportVectorNumClassSvmget_support_vector_num_class_svmGetSupportVectorNumClassSvmGetSupportVectorNumClassSvm. The index of this SV in the training data is returned in IndexIndexIndexIndexIndexindex. This IndexIndexIndexIndexIndexindex can be used for a query with get_sample_class_svmget_sample_class_svmGetSampleClassSvmget_sample_class_svmGetSampleClassSvmGetSampleClassSvm to obtain the feature vectors that become support vectors. get_sample_class_svmget_sample_class_svmGetSampleClassSvmget_sample_class_svmGetSampleClassSvmGetSampleClassSvm can, for example, be used to visualize the support vectors.

Note that when using train_class_svmtrain_class_svmTrainClassSvmtrain_class_svmTrainClassSvmTrainClassSvm with a mode different from 'default' or reducing the SVM with reduce_class_svmreduce_class_svmReduceClassSvmreduce_class_svmReduceClassSvmReduceClassSvm, the returned IndexIndexIndexIndexIndexindex will always be -1, i.e., it will be invalid. The reason for this is that a consistent mapping between SV and training data becomes impossible.

Parallelization

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

Parameters

SVMHandleSVMHandleSVMHandleSVMHandleSVMHandleSVMHandle (input_control) class_svm → (integer)

SVM handle.

IndexSupportVectorIndexSupportVectorIndexSupportVectorIndexSupportVectorIndexSupportVectorindexSupportVector (input_control) integer-array → (integer)

Index of the stored support vector.

IndexIndexIndexIndexIndexindex (output_control) real → (real)

Index of the support vector in the training set.

Result

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

Possible Predecessors

train_class_svmtrain_class_svmTrainClassSvmtrain_class_svmTrainClassSvmTrainClassSvm, get_support_vector_num_class_svmget_support_vector_num_class_svmGetSupportVectorNumClassSvmget_support_vector_num_class_svmGetSupportVectorNumClassSvmGetSupportVectorNumClassSvm

Possible Successors

get_sample_class_svmget_sample_class_svmGetSampleClassSvmget_sample_class_svmGetSampleClassSvmGetSampleClassSvm

Module

Foundation

Operators