add_samples_image_class_knnT_add_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnn (Operator)

Name

add_samples_image_class_knnT_add_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnn — Hinzufügen von Trainingsmustern aus einem Bild zu den Trainingsdaten eines k-Nearest-Neighbor-Klassifikators.

Signatur

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)

Beschreibung

add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn fügt Trainingsmuster aus dem Bild ImageImageImageImageimage zu dem durch KNNHandleKNNHandleKNNHandleKNNHandleKNNHandle gegebenen k-Nearest-Neighbor-Klassifikator (k-NN) hinzu. add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn wird dazu verwendet, die Trainingsmuster bereitzustellen, um einen Klassifikator zur Pixelklassifikation von mehrkanaligen Bildern mit classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnn zu trainieren. Die Funktionsweise von add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn ist analog zu add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnn. Da der k-NN hier aber immer zur Klassifikation verwendet wird, muss bei create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnn die korrekte Anzahl an Kanälen angegeben worden sein. Das Bild ImageImageImageImageimage muss so viele Kanäle besitzen, wie mit NumDim in create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnn festgelegt worden ist. In ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions werden die Trainingsgebiete für die Pixelklassen angegeben. ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions muss also ein Tupel mit mindestens 2 Regionen beinhalten. Die Reihenfolge der Regionen in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions legt die Klassen der Pixel fest. Falls in ImageImageImageImageimage eine zu trainierende Klasse nicht vorkommt, muss an der entsprechenden Stelle des Tupels eine leere Region übergeben werden. Durch diesen Mechanismus können mehrere Bilder verwendet werden, um mit mehrmaligem Aufruf von add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn Trainingsmuster für alle relevanten Pixelklassen bereitzustellen. Die Regionen in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions sollten repräsentative Trainingsmuster für die jeweiligen Klassen enthalten. Sie brauchen deshalb das Eingabebild nicht zu überdecken. Die Regionen in ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions sollten sich nicht überlappen, da dies dazu führen würde, dass in den Trainingsdaten die Merkmalsvektoren in den Überlappungsbereichen mehreren Klassen zugeordnet wären, was zu einer langsameren Konvergenz des Trainings und einer schlechteren Klassifikationsleistung führen kann.

Ausführungsinformationen

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

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

Trainingsbild.

ClassRegionsClassRegionsClassRegionsClassRegionsclassRegions (input_object)  region-array objectHRegionHRegionHobject

Regionen der zu trainierenden Klassen.

KNNHandleKNNHandleKNNHandleKNNHandleKNNHandle (input_control, Zustand wird modifiziert)  class_knn HClassKnn, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des k-NN-Klassifikators.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnn den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnn

Nachfolger

train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnn

Alternativen

add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnn

Siehe auch

classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnn, add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnn, add_samples_image_class_svmadd_samples_image_class_svmAddSamplesImageClassSvmAddSamplesImageClassSvmAddSamplesImageClassSvm

Modul

Foundation