Reference Manual HALCON/C

6 CHAPTER 1. CLASSIFICATION
Result
T learn class box returns H MSG TRUE for a normal case. An exception handling is raised if there are
memory allocation problems. The number of classes is constrained. If this limit is passed, an exception handling
is raised, too.
Parallelization Information
T learn class box is local and processed completely exclusively without parallelization.
Possible Predecessor Functions
create class box, T enquire class box
Possible Successor Functions
test sampset box, T learn class box, T enquire class box, write class box,
close class box, clear sampset
See Also
test sampset box, close class box, create class box, T enquire class box,
learn sampset box
Module
Tools
learn sampset box ( long ClassifHandle, long SampKey,
const char *Outfile, long NSamples, double StopError, long ErrorN )
Train the classificator with one data set.
learn sampset box trains the classificator with data for the key SampKey (see read sampset). The training
sequence is terminated at least after NSamples examples. If NSamples is bigger than the number of examples
in SampKey, then a cyclic start at the beginning occurs. If the error underpasses the value StopError,
then the training sequence is prematurely terminated. StopError is calculated with N / ErrorN. Whereby N
significates the number of examples which were wrong classified during the last ErrorN training examples. Typically
ErrorN is the number of examples in SampKey and NSamples is a multiple of it. If you want a data set
with 100 examples to run 5 times at most and if you want it to terminate with an error lower than 5%, then the
corresponding values are NSamples = 500, ErrorN = 100 and StopError = 0.05. A protocol of the training
activity is going to be written in file Outfile.
Parameter
º ClassifHandle (input control) ...................................................class box long
Classificator’s handle number.
º SampKey (input control) ..........................................................featureset long
Number of the data set to train.
º Outfile (input control) .....................................................filename const char *
Name of the protocol file.
Default Value : ’training prot’
º NSamples (input control) ............................................................integer long
Number of arrays of attributes to learn.
Default Value : 500
º StopError (input control) ...........................................................real double
Classification error for termination.
Default Value : 0.05
º ErrorN (input control) ...............................................................integer long
Error during the assignment.
Default Value : 100
Result
learn sampset box returns H MSG TRUE. An exception handling is raised if key SampKey does not exist
or there are problems while opening the file.
Parallelization Information
learn sampset box is local and processed completely exclusively without parallelization.
create class box
Possible Predecessor Functions
HALCON/C Reference Manual / 2000-11-15