apply_deep_counting_modelT_apply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model应用深度计数模型（算子）

名称

apply_deep_counting_modelT_apply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model — 对一组图像应用深度计数模型进行推理。

签名

apply_deep_counting_model(Image : : DeepCountingHandle : Count, DeepCountingResult)

描述

apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model 对输入图像元组 ImageImageImageImageimageimage 应用由 DeepCountingHandleDeepCountingHandleDeepCountingHandleDeepCountingHandledeepCountingHandledeep_counting_handle 提供的深度计数模型。返回元组 CountCountCountCountcountcount，其中包含每张输入图像中找到的实例数量。额外信息通过 DeepCountingResultDeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_counting_result 返回，该结果包含一个字典元组，同样对应每张输入图像。请注意，待计数对象的模板必须事先通过 prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model 进行设置。需注意 apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model 的推理时间取决于 prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model 中定义的模板数量。

更多信息请参阅匹配 / 深度计数一章。

可使用 dev_display_deep_count_results 函数来可视化检测到的实例。

'min_score'"min_score""min_score""min_score""min_score""min_score" 和 'max_overlap'"max_overlap""max_overlap""max_overlap""max_overlap""max_overlap" 参数可用于设置实例与模板的最小相似度阈值以及实例允许的重叠范围。具体细节请参阅 get_deep_counting_model_paramget_deep_counting_model_paramGetDeepCountingModelParamGetDeepCountingModelParamGetDeepCountingModelParamget_deep_counting_model_param。

DeepCountingResultDeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_counting_result 返回的字典包含关于检测到并计数的对象实例的附加信息。该字典包含以下键，每个键都包含一个元组，其中每个检测结果对应一个值。若未检测到任何实例（即计数为 0 ），则这些元组为空。

'area'"area""area""area""area""area"：: 检测到的模板的近似面积（单位：像素）。
'row'"row""row""row""row""row", 'column'"column""column""column""column""column"：: 输入图像中实例的行和列坐标的大致位置。
'score'"score""score""score""score""score"：: 检测到的实例的相似度分数，即它们与提供给 prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model 的最相似模板的近似相似度。
'template_index'"template_index""template_index""template_index""template_index""template_index"：: 与检测到的实例相似度最高的模板索引。可用于查明哪些模板被计入统计。
'angle'"angle""angle""angle""angle""angle", 'scale'"scale""scale""scale""scale""scale"：: 与检测到的实例相似度最高的模板的角度和比例。若在调用 prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model 时启用了旋转或比例增强，可通过这些数值确定产生与检测实例最相似模板的旋转角度和比例。

注意

系统要求：要在 GPU 上运行此算子（参见 get_deep_counting_model_paramget_deep_counting_model_paramGetDeepCountingModelParamGetDeepCountingModelParamGetDeepCountingModelParamget_deep_counting_model_param），需安装 cuDNN 和 cuBLAS。更多详情请参阅 “安装指南” 中“深度学习及基于深度学习方法的要求”一章。此外，该算子也可在 CPU 上运行。

执行信息

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

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

参数

ImageImageImageImageimageimage (输入对象) (multichannel-)image(-array) → object (byte / real)

输入图像。

DeepCountingHandleDeepCountingHandleDeepCountingHandleDeepCountingHandledeepCountingHandledeep_counting_handle (输入控制) deep_counting → (handle)

深度计数模型的句柄。

CountCountCountCountcountcount (输出控制) integer(-array) → (integer)

计数对象的数量。

DeepCountingResultDeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_counting_result (输出控制) dict(-array) → (handle)

结果字典的元组。

结果

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

可能的前趋

create_deep_counting_modelcreate_deep_counting_modelCreateDeepCountingModelCreateDeepCountingModelCreateDeepCountingModelcreate_deep_counting_model, set_deep_counting_model_paramset_deep_counting_model_paramSetDeepCountingModelParamSetDeepCountingModelParamSetDeepCountingModelParamset_deep_counting_model_param, get_deep_counting_model_paramget_deep_counting_model_paramGetDeepCountingModelParamGetDeepCountingModelParamGetDeepCountingModelParamget_deep_counting_model_param, prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model

另见

prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model

模块

匹配

算子