昇腾社区首页
中文
注册

函数:create_feature_info

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

x

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

x

Atlas 训练系列产品

x

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

x

Atlas 200/300/500 推理产品

x

功能说明

创建aclfvFeatureInfo类型的数据,表示创建特征描述信息。

如需销毁aclfvFeatureInfo类型的数据,请参见函数:destroy_feature_info

Atlas 推理系列产品 中的 Atlas 推理系列加速模块产品 不支持该接口。

函数原型

  • C函数原型
    1
    aclfvFeatureInfo *aclfvCreateFeatureInfo(uint32_t id0, uint32_t id1, uint32_t offset, uint32_t featureLen,uint32_t featureCount, uint8_t *featureData, uint32_t featureDataLen)
    
  • python函数
    1
    feature_info = acl.fv.create_feature_info(id0, id1, offset, feature_len, feature_count, feature_data, feature_len)
    

参数说明

参数名

说明

id0

int,一级库id,取值范围0-1023,N:M场景默认为0。通过id0、id1共同确定一个库。

id1

int,二级库id,取值范围0-1023,N:M场景默认为0。通过id0、id1共同确定一个库。

offset

int,添加的首个特征在库中的偏移,偏移值需要与库中已添加特征个数一致。N:M场景默认为0。

feature_len

int,单个特征长度,当前固定为36Byte,系统内部会校验。

feature_count

int,特征数量,1:N最大100万,N:M最大1000万。

feature_data

int,特征值,根据特征长度连续存储,每条特征前4Byte值为0。

feature_len

int,featureData申请的内存长度,用于校验。

返回值说明

返回值

说明

feature_info

int,指针地址。

  • 返回aclfvFeatureInfo类型,表示成功。
  • 返回0,表示失败。

资源参考

接口调用流程及示例代码,参见特征向量检索