get_sample_class_knnT_get_sample_class_knnGetSampleClassKnnGetSampleClassKnnget_sample_class_knn (算子)
名称
get_sample_class_knnT_get_sample_class_knnGetSampleClassKnnGetSampleClassKnnget_sample_class_knn — 从 k-最近邻（k-NN）分类器的训练数据中返回训练样本。
签名
描述
get_sample_class_knnget_sample_class_knnGetSampleClassKnnGetSampleClassKnnGetSampleClassKnnget_sample_class_knn reads a training sample from the
k-nearest neighbors (k-NN) classifier given by KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle that was
added with add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn or
read_class_knnread_class_knnReadClassKnnReadClassKnnReadClassKnnread_class_knn。The index of the sample is
specified with IndexSampleIndexSampleIndexSampleIndexSampleindexSampleindex_sample. The index is counted from 0,
i.e., IndexSampleIndexSampleIndexSampleIndexSampleindexSampleindex_sample must be a number between 0 and
NumSamplesNumSamplesNumSamplesNumSamplesnumSamplesnum_samples - 1, where NumSamplesNumSamplesNumSamplesNumSamplesnumSamplesnum_samples can be
determined with get_sample_num_class_knnget_sample_num_class_knnGetSampleNumClassKnnGetSampleNumClassKnnGetSampleNumClassKnnget_sample_num_class_knn。The training
sample is returned in FeaturesFeaturesFeaturesFeaturesfeaturesfeatures and ClassIDClassIDClassIDClassIDclassIDclass_id.
FeaturesFeaturesFeaturesFeaturesfeaturesfeatures is a feature vector of length
NumDimNumDimNumDimNumDimnumDimnum_dim (see create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn), while ClassIDClassIDClassIDClassIDclassIDclass_id
is the class label, which is a number between 0 and the
number of classes.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle (输入控制) class_knn → HClassKnn, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
k-NN 分类器的句柄。
IndexSampleIndexSampleIndexSampleIndexSampleindexSampleindex_sample (输入控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the training sample.
FeaturesFeaturesFeaturesFeaturesfeaturesfeatures (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
训练样本的特征向量。
ClassIDClassIDClassIDClassIDclassIDclass_id (输出控制) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
训练样本的类。
结果
如果参数有效，算子 get_sample_class_knnget_sample_class_knnGetSampleClassKnnGetSampleClassKnnGetSampleClassKnnget_sample_class_knn 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
可能的前趋
add_sample_class_train_dataadd_sample_class_train_dataAddSampleClassTrainDataAddSampleClassTrainDataAddSampleClassTrainDataadd_sample_class_train_data
另见
create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn
模块
基础