Search

APP_ERROR Search(const AscendIndexSearchParams& params) const;

Retrieves feature vectors and returns IDs of the most similar topK features based on the input feature vectors.

const AscendIndexSearchParams& params: search parameter. For details, see AscendIndexSearchParams.

size_t n: number of feature vectors to be queried.

std::vector<float>& queryData: feature vector data.

int topK: number of the most similar results to be returned.

std::vector<float>& dists: distance between a vector and the topK nearest vectors.

std::vector<int64_t>& labels: IDs of the topK nearest vectors that are queried.

APP_ERROR: return status. For details, see Return Code Reference.

• n ∈ (0, 10000]. Ensure that the value of n × dim × sizeof(float) is less than the remaining memory of the card. Otherwise, the retrieval may fail due to insufficient memory.
• Length of queryData ≥ n × dim
• topK ∈ (0, 4096]
• Length of dists and labels ≥ n × topK