enquire_reject_class_box ( : : ClassifHandle, FeatureList : Class )

Classify a tuple of attributes with rejection class.

FeatureList 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_box) classificator. 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_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_box for more details about the functionality of the classificator.

You may call the procedures learn_class_box and enquire_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.


Parameters

ClassifHandle (input_control)
class_box -> integer
Classificator's handle number.

FeatureList (input_control)
real-array -> real / integer / string
Array of attributes which has to be classified.
Default value: 1.0

Class (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_box returns 2 (H_MSG_TRUE).


Parallelization Information

enquire_reject_class_box is local and processed completely exclusively without parallelization.


Possible Predecessors

create_class_box, learn_class_box, set_class_box_param


Possible Successors

learn_class_box, write_class_box, close_class_box


Alternatives

enquire_class_box


See also

test_sampset_box, learn_class_box, learn_sampset_box


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH