aclfvRepoAdd

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Function

Adds a repository, or add features to an existing repository. In this section, 1:N indicates the ratio of the number of search requests to the number of repositories, and N:M indicates the similarity between two repositories.

Atlas inference accelerator module does not support this API.

Prototype

1
aclError aclfvRepoAdd(aclfvSearchType type, aclfvFeatureInfo *featureInfo)

Parameters

Parameter

Input/Output

Description

type

Input

Search type. For details about the type definition, see aclfvSearchType.

featureInfo

Input

Pointer to the feature description. For details about the type definition, see aclfvFeatureInfo.

Call the aclfvCreateFeatureInfo API to create data of the aclfvFeatureInfo type in advance.

Returns

0 on success; otherwise, failure. For details, see aclError.

Restrictions

  • For 1:N addition, ensure that the offsets in the aclfvFeatureInfo structure are consecutive for each library. For N:M addition, if the offset is not 0, an error is reported.
  • In N:M mode, multithreaded adding, search, or deletion is not allowed.
  • This API call automatically creates a stream for synchronous task execution within the API. When the tasks are complete, the stream is automatically destroyed.

    Due to hardware restrictions, the total number of streams is limited. For details, see the description of aclrtCreateStream.