add_samples_image_class_knnT_add_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn添加样本图像类K-最近邻(算子)

名称

add_samples_image_class_knnT_add_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn — 将图像中的训练样本添加到 k-最近邻(K-NN)分类器的训练数据中。

签名

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)

def add_samples_image_class_knn(image: HObject, class_regions: HObject, knnhandle: HHandle) -> None

描述

add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn 将来自 ImageImageImageImageimageimage 的训练样本添加到由 KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle 指定的 k-最近邻(k-NN)模型中。add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn 用于存储训练样本,以便后续使用 classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnnclassify_image_class_knn 对多通道图像进行像素分类时调用分类器。add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn 的工作原理与 add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn 类似。图像 ImageImageImageImageimageimage 必须拥有与 create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn 中指定的 NumDimNumDimNumDimNumDimnumDimnum_dim 相等的通道数。ClassRegionsClassRegionsClassRegionsClassRegionsclassRegionsclass_regions 必须是一个包含至少 2 个区域的元组。ClassRegionsClassRegionsClassRegionsClassRegionsclassRegionsclass_regions 中区域的顺序决定了像素的类。如果图像 ImageImageImageImageimageimage 中某类的样本为空,则必须在 ClassRegionsClassRegionsClassRegionsClassRegionsclassRegionsclass_regions 中该类的位置传递一个空区域。通过此机制,可多次调用 add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn,使用不同图像及适宜选取的区域,为 k-NN 分类器添加所有相关类的训练样本。ClassRegionsClassRegionsClassRegionsClassRegionsclassRegionsclass_regions 中的区域应包含各自类具有代表性的训练样本。因此,它们不必覆盖整个图像。ClassRegionsClassRegionsClassRegionsClassRegionsclassRegionsclass_regions 中的区域不应相互重叠,因为这将导致训练数据中来自重叠区域的样本被分配到多个类,从而可能降低分类性能。

执行信息

此算子修改后续输入参数的状态:

在执行此算子时,若该参数值需在多个线程间使用,则必须对其访问进行同步。

参数

ImageImageImageImageimageimage (输入对象)  (multichannel-)image objectHImageHObjectHImageHobject (byte / cyclic / direction / int1 / int2 / uint2 / int4 / real)

训练图像。

ClassRegionsClassRegionsClassRegionsClassRegionsclassRegionsclass_regions (输入对象)  region-array objectHRegionHObjectHRegionHobject

待训练的类区域。

KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleknnhandle (输入控制,状态被修改)  class_knn HClassKnn, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

k-NN 分类器的句柄。

结果

如果参数有效,算子 add_samples_image_class_knnadd_samples_image_class_knnAddSamplesImageClassKnnAddSamplesImageClassKnnAddSamplesImageClassKnnadd_samples_image_class_knn 返回值 2 ( H_MSG_TRUE )。如有必要,则抛出异常。

可能的前趋

create_class_knncreate_class_knnCreateClassKnnCreateClassKnnCreateClassKnncreate_class_knn

可能的后继

train_class_knntrain_class_knnTrainClassKnnTrainClassKnnTrainClassKnntrain_class_knn

替代

add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn

另见

classify_image_class_knnclassify_image_class_knnClassifyImageClassKnnClassifyImageClassKnnClassifyImageClassKnnclassify_image_class_knn, add_sample_class_knnadd_sample_class_knnAddSampleClassKnnAddSampleClassKnnAddSampleClassKnnadd_sample_class_knn, add_samples_image_class_svmadd_samples_image_class_svmAddSamplesImageClassSvmAddSamplesImageClassSvmAddSamplesImageClassSvmadd_samples_image_class_svm

模块

基础