aclfvInit

产品支持情况

产品	是否支持
Atlas 350 加速卡	☓
Atlas A3 训练系列产品/Atlas A3 推理系列产品	☓
Atlas A2 训练系列产品/Atlas A2 推理系列产品	☓
Atlas 200I/500 A2 推理产品	☓
Atlas 推理系列产品	√
Atlas 训练系列产品	☓

功能说明

初始化特征检索模块。一个进程内只能调用一次aclfvInit接口，且需与aclfvRelease接口配套使用。

特征向量检索功能依赖的头文件为“${INSTALL_DIR}/include/acl/ops/acl_fv.h”目录下，库文件为“${INSTALL_DIR}/lib64/libacl_retr.so”目录下。${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。

Atlas 推理系列加速模块产品不支持本接口。

函数原型

aclError aclfvInit(aclfvInitPara *initPara)

参数说明

参数名	输入/输出	说明
initPara	输入	特征向量检索初始化参数的指针。类型定义请参见aclfvInitPara。调用aclfvCreateInitPara接口创建aclfvInitPara类型的数据。 1:N场景下调用aclfvSet1NTopNum接口设置返回的topK结果数量的最大值，不设置时，默认返回的topK结果数量的最大值为4800。 N:M场景下调用aclfvSetNMTopNum接口设置返回的topK结果数量的最大值，不设置时，默认返回的topK结果数量的最大值为500。

参数名

输入/输出

说明

initPara

输入

特征向量检索初始化参数的指针。类型定义请参见aclfvInitPara。

调用aclfvCreateInitPara接口创建aclfvInitPara类型的数据。
1:N场景下调用aclfvSet1NTopNum接口设置返回的topK结果数量的最大值，不设置时，默认返回的topK结果数量的最大值为4800。
N:M场景下调用aclfvSetNMTopNum接口设置返回的topK结果数量的最大值，不设置时，默认返回的topK结果数量的最大值为500。

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

父主题： 特征向量检索 API(C)