learn_ndim_box — Train a classificator using a multi-channel image.
learn_ndim_box is obsolete and is only provided for
reasons of backward compatibility.
learn_ndim_box trains the classificator
with the gray values of
MultiChannelImage using the
Foreground as training sample. The points in
Background are to be rejected by the classificator. The
classificator trained thus can be used in
segment multi-channel images.
Foreground are the points that should be found,
contains the points that should not be found.
Each pixel is trained once during the training process. For points
Foreground the class “0” is used, while for
Background “1” is used. Pixels are trained by
alternating points from
Foreground with points from
Background. If one region is smaller than the other,
pixels are taken cyclically from the smaller region until the larger
region is exhausted.
learn_ndim_box later accepts only
points that can be classified into class “0”.
From a user's point of view the key difference between
learn_ndim_box is that in the
latter case the rejection class affects the classification process
itself. Here, a hyper plane is generated that separates
Background classes, so that no
points in feature space are classified incorrectly.
learn_ndim_norm, however, an overlap between
Background class is allowed.
This has its effect on the return value Quality.
The larger the overlap, the smaller this value.
All channels must be of the same type.
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Foreground pixels to be trained.
Background pixels to be trained (rejection class).
→object (byte / direction / cyclic / int1 / int2 / int4 / real)
Multi-channel training image.
ClassifHandle(input_control, state is modified) class_box
Handle of the classifier.
Let N be the number of generated hyper-cuboids and A be the area of the larger input region. Then the runtime complexity is O(N * A).
learn_ndim_box returns 2 (H_MSG_TRUE) if all parameters are
correct and there is an active classificator. The behavior with
respect to the input images can be determined by setting the values
of the flags 'no_object_result' and
If necessary, an exception is raised.