跳到主要内容

函数:destroy_feature_info

函数: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表示成功。
- 返回其它值表示失败。
约束说明

父主题: 特征向量检索

函数:create_repo_range

C函数原型aclfvRepoRange *aclfvCreateRepoRange(uint32_t id0Min, uint32_t id0Max, uint32_t id1Min, uint32_t id1Max)
Python函数repo_range = acl.fv.create_repo_range(id0min, id0max, id1min, id1max)
函数功能创建aclfvRepoRange类型的数据,表示创建特征库范围的参数。同步接口。 如需销毁aclfvRepoRange类型的数据,请参见函数:destroy_repo_range。 Atlas 200/500 A2推理产品不支持该接口。
输入说明- id0min:int,id0起始值,取值范围:[0,1023],需小于等于id0Max。
- id0max:int,id0最大值,取值范围:[0,1023]。
- id1min:int,id1起始值,取值范围:[0,1023],需小于等于id1Max
- id1max:int,id1最大值,取值范围:[0,1023]。
返回值说明repo_range:int,指针地址。
- 返回aclfvRepoRange类型,表示成功。
- 返回0,表示失败。
约束说明

父主题: 特征向量检索

函数:destroy_repo_range

C函数原型aclError aclfvDestroyRepoRange(aclfvRepoRange *repoRange)
Python函数ret = acl.fv.destroy_repo_range(repo_range)
函数功能销毁通过acl.fv.create_repo_range接口创建的aclfvRepoRange类型的数据。同步接口。 Atlas 200/500 A2推理产品不支持该接口。
输入说明repo_range:int,指针地址,待销毁的aclfvRepoRange类型。
返回值说明ret:int,错误码。
- 返回0表示成功。
- 返回其它值表示失败。
约束说明

父主题: 特征向量检索

函数:create_query_table

C函数原型aclfvQueryTable *aclfvCreateQueryTable(uint32_t queryCnt, uint32_t tableLen, uint8_t *tableData, uint32_t tableDataLen)
Python函数query_table = acl.fv.create_query_table(query_cnt, table_len, table_data, table_data_len)
函数功能创建aclfvQueryTable类型的数据,表示创建检索输入表信息。同步接口。 如需销毁aclfvQueryTable类型的数据,请参见函数:destroy_query_table。 Atlas 200/500 A2推理产品不支持该接口。
输入说明- query_cnt:int,检索请求数量,1:N场景为1,N:M场景最大1024。
- table_len:int,单个表长度,长度固定为32KB,系统内部会校验。
- table_data:int,特征值列表,根据特征长度连续存储。
- table_data_len:int,tableData申请的内存长度,用于校验。
返回值说明**query_table:**int,指针地址。
- 返回aclfvQueryTable类型,表示成功。
- 返回0,表示失败。
约束说明

父主题: 特征向量检索

在线提单