add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data添加样本标识符准备数据（算子）

名称

add_sample_identifier_preparation_dataT_add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data — 将准备数据添加到现有的样本标识符中。

警告

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data 已过时，仅出于向后兼容性考虑而保留。新应用程序应改用基于深度学习的分类算子，详情请参阅深度学习 / 分类。

签名

add_sample_identifier_preparation_data(SampleImage : : SampleIdentifier, ObjectIdx, GenParamName, GenParamValue : ObjectSampleIdx)

描述

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data 向现有样本标识符添加准备数据。这是使用 prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier 算子准备样本标识符的先决条件。

有关基于样本的识别概念的说明，请参阅遗留 / 识别一章的引言。

为实现最高识别率，样本标识符的内部数据结构必须适应待识别的对象。为此，提供各类待识别对象的样本图像将大有裨益。

每次调用 add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data 时，都会将一个 SampleImageSampleImageSampleImageSampleImagesampleImagesample_image 的特征添加到 SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier 中。完整的准备数据包含所有样本图像的特征，这些特征通过多次调用 add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data 添加到样本标识符中，必须涵盖

所有待识别的对象类型以及
识别过程中可能出现的对象所有不同视角，采样角度至少为45度。

SampleImageSampleImageSampleImageSampleImagesampleImagesample_image 的区域应缩小至图像中可见的对象范围。此举旨在避免 SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier 被图像背景所干扰。

若无法提供满足上述所有要求的准备数据，样本标识符仍可进行准备，但识别率可能会略有下降。

请注意，若在 create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 中将通用参数 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info" 设置为 'true'"true""true""true""true""true"，则必须提供 RGB 彩色图像。

理想情况下，用于准备和训练的图像（参见 add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataadd_sample_identifier_training_data 和 train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifiertrain_sample_identifier）应完全一致。这可通过复用准备数据来训练 SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier 轻松实现。为复用准备数据，必须在 ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdxobject_idx 中指定对象索引。否则，ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdxobject_idx 可设置为 'unknown'"unknown""unknown""unknown""unknown""unknown"。有关如何复用准备数据进行样本标识符训练的说明，请参阅 prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier。

以下通用参数可用于影响算子 add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data 的行为。这些参数及其对应值可分别通过 GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 和 GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value 进行指定。GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 的有效取值如下：

'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method"：

有关此参数的说明，请参阅 create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier。

值列表： 'none'"none""none""none""none""none", 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor""scale_factor", 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step", 'image_area'"image_area""image_area""image_area""image_area""image_area"

默认值： 如果该算子未显式设置 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method" 参数，则将使用通过 create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 或 set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param 设置的值。

'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value"：

有关此参数的说明，请参阅 create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier。

建议值： 0.25, 0.5, 1.0, 2, 3, 4

默认值： 如果该算子未显式设置 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value" 参数，则将使用通过 create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 或 set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param 设置的值。

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data 返回由 SampleImageSampleImageSampleImageSampleImagesampleImagesample_image 指定的制备样本的对象样本索引。该索引可用于从制备数据中移除此样本，例如当样本标识符需基于另一组制备数据进行准备时。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
在内部数据级别上自动并行化。

参数

SampleImageSampleImageSampleImageSampleImagesampleImagesample_image (输入对象) (multichannel-)image → object (byte)

显示对象的图像。

SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier (输入控制) sample_identifier → (handle)

样本标识符的句柄。

ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdxobject_idx (输入控制) integer → (integer / string)

SampleImageSampleImageSampleImageSampleImagesampleImagesample_image 中可见对象的索引。

默认值： 'unknown' "unknown" "unknown" "unknown" "unknown" "unknown"

建议值： 'unknown'"unknown""unknown""unknown""unknown""unknown", 0, 1, 2, 3, 4, 5

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (输入控制) attribute.name-array → (string)

通用参数名称。

默认值： []

值列表： 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method", 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (输入控制) attribute.value-array → (real / string / integer)

通用参数值。

默认值： []

建议值： 'none'"none""none""none""none""none", 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor""scale_factor", 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step", 'image_area'"image_area""image_area""image_area""image_area""image_area", 0.25, 0.5, 0.75, 1.0, 2, 3, 4

ObjectSampleIdxObjectSampleIdxObjectSampleIdxObjectSampleIdxobjectSampleIdxobject_sample_idx (输出控制) integer → (integer)

对象样本索引。

结果

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