create_class_knnT_create_class_knnCreateClassKnnCreateClassKnncreate_class_knn创建类K-最近邻(算子)
名称
create_class_knnT_create_class_knnCreateClassKnnCreateClassKnncreate_class_knn — 创建一个 k-最近邻(k-NN)分类器。
签名
def create_class_knn(num_dim: Sequence[int]) -> HHandle
描述
create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn 创建一个 k-最近邻 (k-NN) 数据结构。该结构既可用于数据分类,也可用于在 NumDimNumDimNumDimNumDimnumDimnum_dim 维空间中近似定位最近邻。
分类/k-最近邻中描述的大多数算子均使用生成的句柄 KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle。
k-NN 通过近似搜索最近邻并返回其类别作为结果来实现分类。采用该近似方法时,搜索时间呈样本数与维度的对数级增长。
特征向量的维度是唯一必须在 NumDimNumDimNumDimNumDimnumDimnum_dim 中设置的参数。
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
此算子返回一个句柄。请注意,即使该句柄被用作特定算子的输入参数,这些算子仍可能改变此句柄类型的实例状态。
参数
NumDimNumDimNumDimNumDimnumDimnum_dim (输入控制) number-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
特征的维数。
默认值:
10
KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle (输出控制) class_knn → HClassKnn, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
k-NN 分类器的句柄。
结果
如果参数有效,算子 create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn 返回值 2 (H_MSG_TRUE)。如有必要,则抛出异常。
可能的后继
add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn,
train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnntrain_class_knn
替代
create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmCreateClassSvmcreate_class_svm,
create_class_mlpcreate_class_mlpCreateClassMlpCreateClassMlpCreateClassMlpcreate_class_mlp
另见
select_feature_set_knnselect_feature_set_knnSelectFeatureSetKnnSelectFeatureSetKnnSelectFeatureSetKnnselect_feature_set_knn,
read_class_knnread_class_knnReadClassKnnReadClassKnnReadClassKnnread_class_knn
参考文献
Marius Muja, David G. Lowe: “Fast Approximate Nearest Neighbors with
Automatic Algorithm Configuration”;
International Conference on Computer Vision Theory
and Applications (VISAPP 09); 2009.
模块
基础