Reference Manual HALCON/C

4 CHAPTER 1. CLASSIFICATION
See Also
test sampset box, T learn class box, learn sampset box
Tools
Module
T enquire reject class box ( Htuple ClassifHandle, Htuple FeatureList,
Htuple *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 (T 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 T 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 T learn class box for more details about the functionality of the classificator.
You may call the procedures T learn class box and T 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.
Parameter
º ClassifHandle (input control) ...........................................class box Htuple . long
Classificator’s handle number.
º FeatureList (input control) ........................real-array Htuple . double / long / const char *
Array of attributes which has to be classfied.
Default Value : 1.0
º Class (output control) .....................................................integer Htuple . long *
Number of the class, to which the array of attributes had been assigned or -1 for the rejection class.
Result
T enquire reject class box returns H MSG TRUE.
Parallelization Information
T enquire reject class box is local and processed completely exclusively without parallelization.
Possible Predecessor Functions
create class box, T learn class box, set class box param
Possible Successor Functions
T learn class box, write class box, close class box
T enquire class box
Alternatives
See Also
test sampset box, T learn class box, learn sampset box
Tools
Module
get class box param ( long ClassifHandle, const char *Flag,
double *Value )
Get information about the current parameter.
get class box param gets the parameter of the classificator. The meaning of the parameter is explained in
set class box param.
Default values:
’min samples for split’ = 80,
HALCON/C Reference Manual / 2000-11-15