add_sample_class_knnT_add_sample_class_knnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn (Operator)

Name

add_sample_class_knnT_add_sample_class_knnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn — Fügt ein Trainingsmuster zu einem k-NN-Klassifikator hinzu.

Signatur

add_sample_class_knn( : : KNNHandle, Features, ClassID : )

Herror T_add_sample_class_knn(const Htuple KNNHandle, const Htuple Features, const Htuple ClassID)

void AddSampleClassKnn(const HTuple& KNNHandle, const HTuple& Features, const HTuple& ClassID)

void HClassKnn::AddSampleClassKnn(const HTuple& Features, const HTuple& ClassID) const

void HClassKnn::AddSampleClassKnn(double Features, Hlong ClassID) const

static void HOperatorSet.AddSampleClassKnn(HTuple KNNHandle, HTuple features, HTuple classID)

void HClassKnn.AddSampleClassKnn(HTuple features, HTuple classID)

void HClassKnn.AddSampleClassKnn(double features, int classID)

def add_sample_class_knn(knnhandle: HHandle, features: MaybeSequence[float], class_id: MaybeSequence[int]) -> None

Beschreibung

add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn fügt ein Trainingsmuster zu dem durch KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle gegebenen k-Nearest-Neighbor-Klassifikators (k-NN) hinzu. Die Länge des angegebenen Trainingsmusters muss mit der in create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn angegebenen Dimension NumDim übereinstimmen.

Das Trainingsmuster wird durch FeaturesFeaturesFeaturesFeaturesfeaturesfeatures und ClassIDClassIDClassIDClassIDclassIDclass_id beschrieben. FeaturesFeaturesFeaturesFeaturesfeaturesfeatures ist ein Merkmalsvektor des Musters und muss folglich die Länge NumDim besitzen, die in create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn angegeben worden ist. ClassIDClassIDClassIDClassIDclassIDclass_id ist die Klasse des Musters, eine ganze Zahl, größer oder gleich 0. Bei der Verwendung von nur einer Klasse muss die Zahl 0 verwendet werden. Ebenso sollte bei der geplanten Verwendung des Operators classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnnclassify_image_class_knn darauf geachtet werden, dass alle Klassenlabel von 0 bis zur Anzahl der verwendeten Klassen vergeben werden, da sonst für nicht benutzte Label leere Regionen erzeugt werden.

Es ist erlaubt weitere Trainingsdaten nach einem bereits erfolgten Training hinzuzufügen. Die Veränderungen werden erst wirksam, wenn train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnntrain_class_knn erneut aufgerufen wird.

Falls der k-NN Klassifikator mit automatischer Merkmals-Normalisierung trainiert wurde interpretiert add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn das übergebene Muster als nicht normalisiert und intern wird eine Normalisierung durchgeführt, die durch den letzten Aufruf von train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnntrain_class_knn definiert ist. Die Referenz-Dokumentation des train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnntrain_class_knn Operators enthält weitere Informationen zur automatischen Merkmals-Normalisierung.

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

KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle (input_control, Zustand wird modifiziert)  class_knn HClassKnn, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des k-NN-Klassifikators.

FeaturesFeaturesFeaturesFeaturesfeaturesfeatures (input_control)  number(-array) HTupleMaybeSequence[float]HTupleHtuple (real) (double) (double) (double)

Liste der hinzuzufügenden Merkmalsvektoren.

ClassIDClassIDClassIDClassIDclassIDclass_id (input_control)  integer(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Klassenlabel der Merkmalsvektoren.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnntrain_class_knn, read_class_knnread_class_knnReadClassKnnReadClassKnnReadClassKnnread_class_knn

Siehe auch

create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn, read_class_knnread_class_knnReadClassKnnReadClassKnnReadClassKnnread_class_knn

Literatur

Marius Muja, David G. Lowe: „Fast Approximate Nearest Neighbors with Automatic Algorithm Configuration“; International Conference on Computer Vision Theory and Applications (VISAPP 09); 2009.

Modul

Foundation