Function: repo_add

Applicability

Product	Supported (√/x)
Atlas A3 training products / Atlas A3 inference products	x
Atlas A2 training products / Atlas A2 inference products	x
Atlas training products	x
Atlas inference products	√
Atlas 200I/500 A2 inference products	x

Function Usage

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.

The Atlas inference accelerator modules in the Atlas inference products does not support this API.

Prototype

C Prototype

        
             aclError aclfvRepoAdd(aclfvSearchType type, aclfvFeatureInfo *featureInfo)

Python Function

        
             ret = acl.fv.repo_add(type, feature_info)

Parameter Description

Parameter	Description
type	Int, search type. For details, see aclfvSearchType.
feature_info	Int, address of the pointer that points to feature description. Call acl.fv.create_feature_info to create data of the aclfvFeatureInfo type in advance.

Return Value Description

Return Value	Description
ret	Int, error code. 0: success. Other values: failures.

Restrictions

In 1:N mode, ensure that the offsets in the aclfvFeatureInfo dictionary 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 Function: create_stream.

Reference

For details about the API call sequence and sample code, see Feature Vector Search.

Parent topic: Feature Vector Search