aclfvRepoAdd

Applicable Products

Product

Supported

Ascend 950PR / Ascend 950DT

X

Atlas A3 training products / Atlas A3 inference products

X

Atlas A2 training products / Atlas A2 inference products

X

Atlas 200I/500 A2 inference products

X

Atlas inference products

√

Atlas training products

X

Function

Adds a repository, or adds 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 : This API is not supported.

Prototype

1
aclError aclfvRepoAdd(aclfvSearchType type, aclfvFeatureInfo *featureInfo)

Parameters

Parameter

Input/Output

Description

type

Input

Search type. For the type definition, see aclfvSearchType.

featureInfo

Input

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

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

Returns

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

Restrictions

  • In 1:N mode, ensure that the offsets in the aclfvFeatureInfo struct are consecutive for each repository. In N:M mode, 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.

    Hardware has restrictions on the total number of streams. For details, see aclrtCreateStream.