create_sample_identifierT_create_sample_identifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier创建样本标识符（算子）

名称

create_sample_identifierT_create_sample_identifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier — 创建新的样本标识符。

警告

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

签名

描述

算子 create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 用于创建一个新的样本标识符。此外，还可以使用算子 read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifierread_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" 来明确指定。

泛型参数可用于影响样本标识符的行为。通常情况下，只需考虑 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info" 这一项。这些参数及其对应值可分别通过 GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 和 GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value 进行指定。GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 的可能取值如下：

'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info"：

此参数决定是否在识别过程中使用颜色信息。如果将 '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_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info" 设置为 'false'"false""false""false""false""false"，则不使用颜色信息。如果待识别的物体具有不同的颜色，且照明条件在一定程度上可以控制，请使用颜色信息。在这种情况下，使用颜色信息可以提高识别的稳健性。

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"

默认值： 'false'"false""false""false""false""false"

'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info""add_texture_info"：

此参数决定是否使用纹理信息进行识别。如果将 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info""add_texture_info" 设置为 'true'"true""true""true""true""true"，则使用纹理信息；如果将 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info""add_texture_info" 设置为 'false'"false""false""false""false""false"，则不使用纹理信息。通常应将 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info""add_texture_info" 设置为 'true'"true""true""true""true""true"，因为基于样本的识别需要带有纹理的对象。请注意，两个通用参数 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info" 和 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info""add_texture_info" 中至少有一个必须设置为 'true'"true""true""true""true""true"。

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"

默认值： 'true'"true""true""true""true""true"

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

为了加快识别过程，系统会将图像在内部调整为指定尺寸或按指定比例进行缩放。如果选择 '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_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value" 进行设置（见下文）。

为加快识别过程，请选择能生成较小内部图像的参数，即使用较小的缩放因子或图像尺寸，或较大的子采样步长。如果待识别的对象具有高频纹理，使用较大的内部图像尺寸可能会获得更好的识别结果，否则纹理可能会在调整大小的图像中丢失。

值列表： '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_area'"image_area""image_area""image_area""image_area""image_area"

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

通过此参数，可以对所选的 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method" 进行参数化设置。如果 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method" 设置为 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor""scale_factor"，则 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value" 的值将定义要使用的缩放因子。如果将 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method" 设置为 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step"，则 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value" 的值定义了子采样步长，即缩放系数的倒数。如果 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method" 设置为 'image_area'"image_area""image_area""image_area""image_area""image_area"，则 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value" 的值定义了缩放后图像的面积（以百万像素为单位）。

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

默认值： 默认值取决于所选的 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method"。

• 对于 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor""scale_factor"，其值为 0.5；

• 对于 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step"，其值为 2.0；

• 对于 'image_area'"image_area""image_area""image_area""image_area""image_area"，其值为 0.5。

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。

参数

结果

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

可能的后继

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data, set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param

替代

read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifierread_sample_identifier

另见

prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier, add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataadd_sample_identifier_training_data, train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifiertrain_sample_identifier, apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier, get_sample_identifier_paramget_sample_identifier_paramGetSampleIdentifierParamGetSampleIdentifierParamGetSampleIdentifierParamget_sample_identifier_param, get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info, remove_sample_identifier_preparation_dataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationDataremove_sample_identifier_preparation_data, remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataremove_sample_identifier_training_data, write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierWriteSampleIdentifierwrite_sample_identifier, serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier, deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifierDeserializeSampleIdentifierdeserialize_sample_identifier, clear_sample_identifierclear_sample_identifierClearSampleIdentifierClearSampleIdentifierClearSampleIdentifierclear_sample_identifier, set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoset_sample_identifier_object_info

模块

匹配