函数：set_nm_top_num
函数：destory_init_para
| C函数原型 | aclError aclfvDestroyInitPara(aclfvInitPara *initPara) |
|---|---|
| Python函数 | ret = acl.fv.destory_init_para(init_para) |
| 函数功能 | 销毁通过acl.fv.create_init_para接口创建的aclfvInitPara类型的数据。同步接口。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | init_para：int，待销毁的aclfvInitPara类型。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：set_1n_top_num
| C函数原型 | aclError **aclfvSet1NTopNum(**aclfvInitPara *initPara, uint32_t maxTopNumFor1N) |
|---|---|
| Python函数 | ret = acl.fv.set_1n_top_num(init_para, max_top_num_for_1n) |
| 函数功能 | 设置1:N场景下返回的topK结果数量的最大值，如果不设置，默认topK结果数量的最大值为4800。同步接口。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | - init_para：int，指定特征向量检索的初始化参数。 需提前调用acl.fv.create_init_para接口创建aclfvInitPara类型的数据。 - max_top_num_for_1n：int，1:N场景下返回的topK结果的最大值，取值范围：[2, 4800]。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：set_nm_top_num
| C函数原型 | **aclError****aclfvSetNMTopNum(**aclfvInitPara *initPara, uint32_t maxTopNumForNM) |
|---|---|
| Python函数 | ret = acl.fv.set_nm_top_num(init_para, max_top_num_for_nm) |
| 函数功能 | 设置N:M场景下返回的topK结果数量的最大值，如果不设置，默认topK结果数量的最大值为500。同步接口。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | - init_para：int，指定特征向量检索的初始化参数。 需提前调用acl.fv.create_init_para接口创建aclfvInitPara类型的数据。 - max_top_num_for_nm：int，N:M场景下返回的topK结果的最大值，取值范围：[500,4800]。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：create_feature_info
| C函数原型 | aclfvFeatureInfo *aclfvCreateFeatureInfo(uint32_t id0, uint32_t id1, uint32_t offset, uint32_t featureLen, uint32_t featureCount, uint8_t *featureData, uint32_t featureDataLen) |
|---|---|
| Python函数 | feature_info = acl.fv.create_feature_info(id0, id1, offset, feature_len, feature_count, feature_data, feature_len) |
| 函数功能 | 创建aclfvFeatureInfo类型的数据，表示创建特征描述信息。同步接口。 如需销毁aclfvFeatureInfo类型的数据，请参见函数：destroy_feature_info。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | - id0：int，一级库id，取值范围0-1023，N:M场景默认为0。通过id0、id1共同确定一个库。 - id1：int，二级库id，取值范围0-1023，N:M场景默认为0。通过id0、id1共同确定一个库。 - offset：int，添加的首个特征在库中的偏移，偏移值需要与库中已添加特征个数一致。N:M场景默认为0。 - feature_len：int，单个特征长度，当前固定为36Byte，系统内部会校验。 - feature_count：int，特征数量，1:N最大100万，N:M最大1000万。 - feature_data：int，特征值，根据特征长度连续存储，每条特征前4Byte值为0。 - feature_len：int，featureData申请的内存长度，用于校验。 |
| 返回值说明 | **feature_info：**int，指针地址。 - 返回aclfvFeatureInfo类型，表示成功。 - 返回0，表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：destroy_feature_info
| C函数原型 | aclError aclfvDestroyFeatureInfo(aclfvFeatureInfo *featureInfo) |
|---|---|
| Python函数 | ret = acl.fv.destroy_feature_info(feature_info) |
| 函数功能 | 销毁通过acl.fv.create_feature_info接口创建的aclfvFeatureInfo类型的数据。同步接口。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | feature_info：int，指针地址，待销毁的aclfvFeatureInfo类型。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
在线提单