learn_class_boxT_learn_class_boxlearn_class_boxLearnClassBoxLearnClassBox (Operator)

Name

learn_class_boxT_learn_class_boxlearn_class_boxLearnClassBoxLearnClassBox — Train the classifier.

Signature

learn_class_box( : : ClassifHandle, Features, Class : )

FeaturesFeaturesFeaturesFeaturesfeatures is a tuple of any floating point numbers or integers (attributes) which has to be assigned to the class ClassClassClassClassclassVal. This class is specified by an integer. You may use operator enquire_class_boxenquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBox later to find the most probable class for any array (=tupel). The algorithm tries to describe the set of arrays of one class by hyper cuboids in the feature space. On demand you may even create several cuboids per class. Hence it is possible to learn disjunct concepts, too. I.e such concepts which split in several “cluster” of points in the feature space. The data structure is hidden to the user and only accessible with such operators which are described in this chapter.

It is possible to specify attributes as unknown by indicating the symbol '*' instead of a number. If you specify n values, then all following values, i.e. the attributes n+1 until 'max', are automatically supposed to be undefined.

You may call the operators learn_class_boxlearn_class_boxlearn_class_boxLearnClassBoxLearnClassBox and enquire_class_boxenquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBox alternately, so that it is possible to classify already in the phase of learning. By this means you could see when a satisfying behavior had been reached.

The classifier is going to be bigger using further training. This means, that it is not advisable to continue training after reaching a satisfactory behavior.

Parallelization

Multithreading type: exclusive (runs in parallel only with independent 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.

Parameters

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandle (input_control) class_box → (integer)

Handle of the classifier.

FeaturesFeaturesFeaturesFeaturesfeatures (input_control) number-array → (real / integer / string)

Array of attributes to learn.

Default value: [1.0,1.5,2.0]

ClassClassClassClassclassVal (input_control) integer → (integer)

Class to which the array has to be assigned.

Default value: 1

Result

learn_class_boxlearn_class_boxlearn_class_boxLearnClassBoxLearnClassBox returns 2 (H_MSG_TRUE) for a normal case. An exception is raised if there are memory allocation problems. The number of classes is constrained. If this limit is passed, an exception is raised, too.