函数：init

C函数原型

aclError aclInit(const char *configPath)

Python函数

ret = acl.init(config_path)

函数功能

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

输入说明

config_path：str，配置文件所在的路径，包含文件名。

配置文件内容为json格式（json文件内的“{”的层级最多为10，“[”的层级最多为10）。如果以下的默认配置已满足需求，无需修改，可直接调用acl.init接口不传入参数或者可将配置文件配置为空json串（即配置文件中只有{}）。

配置文件格式为json格式，当前支持以下配置：

  • Dump信息配置，包括3种配置：模型Dump配置、单算子Dump配置、溢出算子Dump配置。
    • 模型Dump配置（用于导出模型中每一层算子输入和输出数据）、单算子Dump配置（用于导出单个算子的输入和输出数据），导出的数据用于与指定模型或算子进行比对，定位精度问题，配置示例、说明及约束请参见《精度比对工具使用指南》中的“比对数据准备>推理场景数据准备>准备离线模型dump数据文件（AscendCL接口方式）”。默认不启用该dump配置。
    • 溢出算子Dump配置（用于导出模型中溢出算子的输入和输出数据），导出的数据用于分析溢出原因，定位模型精度的问题，配置示例、说明及约束请参见配置文件示例（溢出算子Dump配置）。默认不启用该dump配置。预留功能，暂不支持。
  • Profiling采集信息配置，示例、配置说明及约束请参见《性能分析工具使用指南》。默认不启用Profiling采集信息配置。
  • 算子缓存信息老化配置，为节约内存和平衡调用性能，可通过“max_opqueue_num”参数配置“算子类型-单算子模型”映射队列的最大长度，如果长度达到最大，则会先删除长期未使用的映射信息以及缓存中的单算子模型，再加载最新的映射信息以及对应的单算子模型。如果不配置映射队列的最大长度，则默认最大长度为“20000”。示例及约束说明请参见配置文件示例（算子缓存信息老化配置）。

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

返回值说明

ret：int，错误码。

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

约束说明

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

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

相关接口

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

参考资源

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

配置文件示例（溢出算子Dump配置）

溢出算子Dump配置的相关约束说明如下：
  • 将“dump_debug”配置为“on”表示开启溢出算子配置，不配置“dump_debug”或将“dump_debug”配置为“off”表示不开启溢出算子配置。
  • 若开启溢出算子配置，则“dump_path”必须配置，表示导出数据文件的存储路径。
    支持配置绝对路径或相对路径：
    • 绝对路径配置以“/”开头，例如：/home。
    • 相对路径配置直接以目录名开始，例如：output。

    获取导出的数据文件后，如何解析请参见溢出算子数据采集及分析。

  • 溢出算子Dump配置，不能与模型Dump配置或单算子Dump配置同时开启，否则会返回报错。
配置文件中的示例内容如下： 
{
    "dump":{
        "dump_path":"output",
        "dump_debug":"on"
    }
}

配置文件示例（算子缓存信息老化配置）

算子缓存信息老化配置的相关约束说明如下：

配置文件中的示例内容如下：

{
        "max_opqueue_num": "10000"
}
父主题： 系统配置