函数：destroy_query_table
函数：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，表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：destroy_query_table
| C函数原型 | aclError aclfvDestroyQueryTable(aclfvQueryTable *queryTable) |
|---|---|
| Python函数 | ret = acl.fv.destroy_query_table(query_table) |
| 函数功能 | 销毁通过acl.fv.create_query_table接口创建的aclfvQueryTable类型的数据。同步接口。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | query_table：int，指针地址，待销毁的aclfvQueryTable类型。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：create_search_input
| C函数原型 | aclfvSearchInput *aclfvCreateSearchInput(aclfvQueryTable *queryTable, aclfvRepoRange *repoRange, uint32_t topk) |
|---|---|
| Python函数 | search_input = acl.fv.create_search_input(query_table, repo_range, topk) |
| 函数功能 | 创建aclfvSearchInput类型的数据，表示创建检索任务输入信息。同步接口。 如需销毁aclfvSearchInput类型的数据，请参见函数：destroy_search_input。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | - query_table：int，指针地址，检索的输入表信息。 调用acl.fv.create_query_table接口创建aclfvQueryTable类型的数据。 - repo_range：int，指针地址，检索的特征库范围。 调用acl.fv.create_repo_range接口创建aclfvRepoRange类型的数据。 - topk：单个检索请求需要返回的结果数量。 |
| 返回值说明 | **search_input：**int，指针地址。 - 返回aclfvSearchInput类型，表示成功。 - 返回0，表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：destroy_search_input
| C函数原型 | aclError aclfvDestroySearchInput(aclfvSearchInput *searchInput) |
|---|---|
| Python函数 | ret = acl.fv.destroy_search_input(search_input) |
| 函数功能 | 销毁通过acl.fv.create_search_input接口创建的aclfvSearchInput类型的数据。同步接口。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | search_input：int，指针地址，待销毁的aclfvSearchInput类型。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
函数：create_search_result
| C函数原型 | aclfvSearchResult *aclfvCreateSearchResult(uint32_t queryCnt, uint32_t *resultNum, uint32_t resultNumDataLen, uint32_t *id0, uint32_t *id1, uint32_t *resultOffset, float *resultDistance, uint32_t dataLen) |
|---|---|
| Python函数 | search_result = acl.fv.create_search_result(query_cnt, result_num, result_num_data_len, id_0, id_1, result_offset, result_distance, data_len) |
| 函数功能 | 创建aclfvSearchResult类型的数据，表示创建检索结果信息。同步接口。 如需销毁aclfvSearchResult类型的数据，请参见函数：destroy_search_result。 Atlas 200/500 A2推理产品不支持该接口。 |
| 输入说明 | - query_cnt：int，检索请求个数，1:N场景为1。 - result_num：int，每个检索请求的结果个数。 - result_num_data_len：int，resultNum的内存总长度。 - id_0：int，一级库id，总个数为topK*queryCnt。 - id_1：int，二级库id，总个数为topK*queryCnt。 - result_offset：int，每个检索请求的检索结果对应底库的偏移，总个数为topK*queryCnt。 - result_distance：int，每个检索结果与检索请求间的距离，总个数为topK*queryCnt。 - data_len：int，申请的内存大小，计算公式为：topK*queryCnt*4Byte。 |
| 返回值说明 | search_result：int，指针地址。 - 返回aclfvSearchResult类型，表示成功。 - 返回0，表示失败。 |
| 约束说明 | 无 |
父主题： 特征向量检索
在线提单