Function: set_1n_top_num

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

Sets the maximum number of results (topK) returned in the 1:N search mode. If it is not set, top 4800 results are returned by default.

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

C Prototype

        
             aclError aclfvSet1NTopNum(aclfvInitPara *initPara, uint32_t maxTopNumFor1N)

Python Function

        
             ret = acl.fv.set_1n_top_num(init_para, max_top_num_for_1n)

Parameter	Description
init_para	Int, initialization configuration for feature vector search. Call acl.fv.create_init_para to create data of the aclfvInitPara type in advance.
max_top_num_for_1n	Int, maximum number of results (topK) returned in 1:N mode. Must be in the range of [2, 4800].

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

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

Parent topic: Feature Vector Search