enquire_reject_class_boxT_enquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box (Operator)

Name

enquire_reject_class_boxT_enquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box — Classify a tuple of attributes with rejection class.

Warning

enquire_reject_class_boxenquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box is obsolete and is only provided for reasons of backward compatibility. New applications should use the MLP, SVM, KNN or GMM operators instead.

Signature

enquire_reject_class_box( : : ClassifHandle, FeatureList : Class)

Description

FeatureListFeatureListFeatureListFeatureListfeatureListfeature_list is a tuple of any floating point- or integer numbers (attributes) which has to be assigned to a class with assistance of a previous trained (learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxLearnClassBoxlearn_class_box) classifier. 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.

If the array of attributes cannot be assigned to a class, i.e. the array does not reside inside of one of the hyper boxes, then in contrary to enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxEnquireClassBoxenquire_class_box not the next class is going to be returned, but the rejection class -1 as a result is going to be passed.

See learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxLearnClassBoxlearn_class_box for more details about the functionality of the classifier.

You may call the operators learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxLearnClassBoxlearn_class_box and enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxEnquireClassBoxenquire_class_box 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.

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

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandleclassif_handle (input_control) class_box → (handle)

Handle of the classifier.

FeatureListFeatureListFeatureListFeatureListfeatureListfeature_list (input_control) real-array → (real / integer / string)

Array of attributes which has to be classified.

Default value: 1.0

ClassClassClassClassclassValclass (output_control) integer → (integer)

Number of the class, to which the array of attributes had been assigned or -1 for the rejection class.

Result

enquire_reject_class_boxenquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box returns 2 (H_MSG_TRUE).