Reference Manual HALCON/C

8 CHAPTER 1. CLASSIFICATION
º SampKey (output control) .......................................................featureset long *
Identification of the data set to train.
Result
read sampset returns H MSG TRUE. An exception handling is raised if it is not possible to open the file or it
contains syntax errors or there is not enough memory.
Parallelization Information
read sampset is local and processed completely exclusively without parallelization.
create class box
Possible Predecessor Functions
Possible Successor Functions
test sampset box, T enquire class box, write class box, close class box,
clear sampset
See Also
test sampset box, clear sampset, learn sampset box
Tools
Module
set class box param ( long ClassifHandle, const char *Flag,
double Value )
Set system parameters for classification.
set class box param modifies parameter which manipulate the training sequence while calling
T learn class box. Only parameters of the classificator are modified, all other classificators remain unmodified.
’min samples for split’ is the number of examples at least which have to train in one cuboid of this
classificator, before the cuboid is allowed to divide itself. ’split error’ indicates the critical error. By its exceeding
the cuboid divides itself, if there are more than ’min samples for split’ examples to train. ’prop constant’ manipulates
the extension of the cuboids. It is proportional to the average distance of the training examples in this cuboid
to the center of the cuboid. More detailed:
extension ¢ prop = average distance of the expectation value.
This relation is valid in every dimension. Hence inside a cuboid the dimensions of the feature space are supposed
to be independent.
The parameters are set with problem independent default values, which must not modified without any reason.
Parameters are only important during a learning sequence. They do not influence on the behavior of
T enquire class box.
Default setting:
’min samples for split’ = 80,
’split error’ = 0.1,
’prop constant’ = 0.25
Parameter
º ClassifHandle (input control) ...................................................class box long
Classificator’s handle number.
º Flag (input control) ............................................................string const char *
Name of the wanted parameter.
Default Value : ’split error’
Value Suggestions : Flag ¾’min samples for split’, ’split error’, ’prop constant’
º Value (input control) .......................................................number double / long
Value of the parameter.
Default Value : 0.1
read sampset returns H MSG TRUE.
Result
Parallelization Information
set class box param is local and processed completely exclusively without parallelization.
HALCON/C Reference Manual / 2000-11-15