add_sample_class_svm (Operator)

Name

add_sample_class_svm — Add a training sample to the training data of a support vector machine.

Synopsis

add_sample_class_svm( : : SVMHandle, Features, Class : )

Description

add_sample_class_svm adds a training sample to the support vector machine (SVM) given by SVMHandle. The training sample is given by Features and Class. Features is the feature vector of the sample, and consequently must be a real vector of length NumFeatures, as specified in create_class_svm. Class is the target of the sample, which must be in the range of 0 to NumClasses-1 (see create_class_svm). Before the SVM can be trained with train_class_svm, training samples must be added to the SVM with add_sample_class_svm. The usage of support vectors of an already trained SVM as training samples is described in train_class_svm.

The number of currently stored training samples can be queried with get_sample_num_class_svm. Stored training samples can be read out again with get_sample_class_svm.

Normally, it is useful to save the training samples in a file with write_samples_class_svm to facilitate reusing the samples and to facilitate that, if necessary, new training samples can be added to the data set, and hence to facilitate that a newly created SVM can be trained with the extended data set.

Parameters

SVMHandle (input_control)	class_svm → (integer)
SVM handle.

Features (input_control)	real-array → (real)
Feature vector of the training sample to be stored.

Class (input_control)	number → (integer / real)
Class of the training sample to be stored.

Result

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

Parallelization Information

add_sample_class_svm is processed completely exclusively without parallelization.

Possible Predecessors

create_class_svm

Possible Successors

train_class_svm, write_samples_class_svm, get_sample_num_class_svm, get_sample_class_svm

Alternatives

read_samples_class_svm

See also

clear_samples_class_svm, get_support_vector_class_svm

Module

Foundation