昇腾社区首页
中文
注册

函数:init

C函数原型

aclError aclInit(const char *configPath)

Python函数

ret = acl.init(config_path)

函数功能

pyACL初始化函数,同步接口。

输入说明

config_path:str,配置文件所在的路径,包含文件名,配置文件内容为json格式(json文件内的“{”的层级最多为10,“[”的层级最多为10)。如果以下的默认配置已满足需求,无需修改,可向acl.init接口中传空,或者可将配置文件配置为空json串(即配置文件中只有{})。

返回值说明

ret:int,错误码。

  • 返回0表示成功。
  • 返回其它值表示失败。

约束说明

  • 一个进程内只能调用一次acl.init接口。

  • 使用pyACL接口开发应用时,必须先调用acl.init接口,否则可能会导致后续系统内部资源初始化出错,进而导致其它业务异常。

注意事项

配置文件格式为json格式,当前支持以下配置:

  • 配置dump信息,示例请参见配置文件示例,详细配置说明请参见CANN 开发工具指南》中的“精度比对工具使用指南”章节中的“比对数据准备>准备离线模型dump数据文件”。默认不启动dump配置。

  • 配置Profiling采集信息,示例请参见配置文件示例,详细配置说明请参见CANN 开发工具指南》中的“精度比对工具使用指南”章节中的“比对数据准备>准备离线模型dump数据文件”。默认不启动dump配置。

  • 算子缓存信息老化配置,为节约内存和平衡调用性能,可通过max_opqueue_num参数配置“算子类型-单算子模型”映射队列的最大长度,如果长度达到最大,则会先删除长期未使用的映射信息以及缓存中的单算子模型,再加载最新的映射信息以及对应的单算子模型。如果不配置映射队列的最大长度,则默认最大长度为10000。示例及约束说明请参见配置文件示例

建议不要同时配置dump信息和Profiling采集信息,否则dump操作会影响系统性能,导致Profiling采集的性能数据指标不准确。

相关接口

pyACL还提供了其它使能Dump或Profiling的接口,如下,与acl.init不同的是,以下这些接口相对灵活,可以在一个进程内调用多次接口,每次调用接口时可以基于不同的Dump配置或Profiling配置。

参考资源

接口调用示例,参见pyACL初始化与去初始化

配置文件示例

  • 算子缓存信息老化配置相关约束说明如下:
    • 对于静态加载的算子,调用acl.op.set_model_dir接口加载指定目录下的单算子模型或调用acl.op.load接口加载指定单算子模型时,老化配置无效,不会对该部分的算子信息做老化。
    • AscendCL内部分开维护固定Shape和动态Shape算子的映射队列,最大长度都为max_opqueue_num参数值。
    • max_opqueue_num参数值为静态加载算子的单算子模型个数和在线编译算子的单算子模型个数的总和,因此max_opqueue_num参数值应大于当前进程中可用的、静态加载算子的单算子模型个数,否则会导致在线编译算子的信息无法老化。
    配置文件中的示例内容如下:
    {
            "max_opqueue_num": "10000"
    }