add_samples_image_class_knnT_add_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnn (Operator)

Name

add_samples_image_class_knnT_add_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnn — Add training samples from an image to the training data of a k-Nearest-Neighbor classifier.

Signature

add_samples_image_class_knn(Image, ClassRegions : : KNNHandle : )

Herror T_add_samples_image_class_knn(const Hobject Image, const Hobject ClassRegions, const Htuple KNNHandle)

void AddSamplesImageClassKnn(const HObject& Image, const HObject& ClassRegions, const HTuple& KNNHandle)

void HImage::AddSamplesImageClassKnn(const HRegion& ClassRegions, const HClassKnn& KNNHandle) const

void HClassKnn::AddSamplesImageClassKnn(const HImage& Image, const HRegion& ClassRegions) const

static void HOperatorSet.AddSamplesImageClassKnn(HObject image, HObject classRegions, HTuple KNNHandle)

void HImage.AddSamplesImageClassKnn(HRegion classRegions, HClassKnn KNNHandle)

void HClassKnn.AddSamplesImageClassKnn(HImage image, HRegion classRegions)

Description

add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn adds training samples from the ImageImageImageImageimage to the k-Nearest-Neighbor (k-NN) given by KNNHandleKNNHandleKNNHandleKNNHandleKNNHandle. add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn is used to store the training samples before a classifier is used for the pixel classification of multichannel images with classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnn. add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn works analogously to add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnn. The ImageImageImageImageimage must have a number of channels equal to NumDimNumDimNumDimNumDimnumDim, as specified with create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnn. ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions must be a tuple containing of at least 2 regions. The order of the regions in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions determines the class of the pixels. If there are no samples for a particular class in ImageImageImageImageimage an empty region must be passed at the position of the class in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions. With this mechanism it is possible to use multiple images to add training samples for all relevant classes to the k-NN classifier by calling add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn multiple times with different images and suitably chosen regions. The regions in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions should contain representative training samples for the respective classes. Hence, they do not need to cover the entire image. The regions in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions should not overlap each other, as these samples from overlapping areas would be assigned to multiple classes in the training data, which may lead to a lower classification performance.

Execution Information

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.

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image objectHImageHImageHobject (byte / cyclic / direction / int1 / int2 / uint2 / int4 / real)

Training image.

ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions (input_object)  region-array objectHRegionHRegionHobject

Regions of the classes to be trained.

KNNHandleKNNHandleKNNHandleKNNHandleKNNHandle (input_control, state is modified)  class_knn HClassKnn, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the k-NN classifier.

Result

If the parameters are valid, the operator add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnn

Possible Successors

train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnn

Alternatives

add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnn

See also

classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnn, add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnn, add_samples_image_class_svmadd_samples_image_class_svmAddSamplesImageClassSvmAddSamplesImageClassSvmAddSamplesImageClassSvm

Module

Foundation