ClassesClassesClassesClasses | | | | Operators

create_class_knnT_create_class_knnCreateClassKnncreate_class_knnCreateClassKnnCreateClassKnn (Operator)

Name

create_class_knnT_create_class_knnCreateClassKnncreate_class_knnCreateClassKnnCreateClassKnn — Create a k-nearest neighbors (k-NN) classifier.

Signature

create_class_knn( : : NumDim : KNNHandle)

Herror T_create_class_knn(const Htuple NumDim, Htuple* KNNHandle)

Herror create_class_knn(const HTuple& NumDim, Hlong* KNNHandle)

void HClassKnn::CreateClassKnn(const HTuple& NumDim)

void CreateClassKnn(const HTuple& NumDim, HTuple* KNNHandle)

void HClassKnn::HClassKnn(const HTuple& NumDim)

void HClassKnn::CreateClassKnn(const HTuple& NumDim)

void HOperatorSetX.CreateClassKnn(
[in] VARIANT NumDim, [out] VARIANT* KNNHandle)

void HClassKnnX.CreateClassKnn([in] VARIANT NumDim)

static void HOperatorSet.CreateClassKnn(HTuple numDim, out HTuple KNNHandle)

public HClassKnn(HTuple numDim)

void HClassKnn.CreateClassKnn(HTuple numDim)

Description

create_class_knncreate_class_knnCreateClassKnncreate_class_knnCreateClassKnnCreateClassKnn creates a k-nearest neighbors (k-NN) data structure. This can be either used to classify data or to approximately locate nearest neighbors in a NumDimNumDimNumDimNumDimNumDimnumDim-dimensional space.

Most of the operators described in Classification/K-Nearest-Neighbor use the resulting handle KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleKNNHandle.

The k-NN classifies by searching approximately the nearest neighbors and returning their classes as result. With the used approximation, the search time is logarithmically to the number of samples and dimensions.

The dimension of the feature vectors is the only parameter that necessarily has to be set in NumDimNumDimNumDimNumDimNumDimnumDim.

Parallelization

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

NumDimNumDimNumDimNumDimNumDimnumDim (input_control)  number-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of dimensions of the feature.

Default value: 10

KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleKNNHandle (output_control)  class_knn HClassKnn, HTupleHTupleHClassKnn, HTupleHClassKnnX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the k-NN classifier.

Result

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

Possible Successors

add_sample_class_knnadd_sample_class_knnAddSampleClassKnnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnn, train_class_knntrain_class_knnTrainClassKnntrain_class_knnTrainClassKnnTrainClassKnn

Alternatives

create_class_svmcreate_class_svmCreateClassSvmcreate_class_svmCreateClassSvmCreateClassSvm, create_class_mlpcreate_class_mlpCreateClassMlpcreate_class_mlpCreateClassMlpCreateClassMlp

See also

select_feature_set_knnselect_feature_set_knnSelectFeatureSetKnnselect_feature_set_knnSelectFeatureSetKnnSelectFeatureSetKnn, read_class_knnread_class_knnReadClassKnnread_class_knnReadClassKnnReadClassKnn

References

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

Module

Foundation


ClassesClassesClassesClasses | | | | Operators