昇腾社区首页
中文
注册

命令格式说明

专家系统执行分析命令行格式如下:

./msadvisor -d data [-c conf] [-h help]

命令行参数说明如表1所示。

表1 专家系统命令行参数说明

参数名

参数说明

是否必选

-d

--data

用户指定的分析数据的路径。

须指定到数据目录根路径data,例如/home/HwHiAiUser/data/

专家系统分析过程较为复杂,会产生较多的临时文件,因此执行专家系统分析前,需预留足够大的内存空间,否则可能造成进程终止。例如指定路径下的数据文件为100MB时,需要预留1GB的内存空间。

指定的分析数据文件:算子仿真文件、Profiling数据文件和CCE文件的每个文件大小均不能超过100MB;OM模型离线文件大小不能超过1GB。

-c

--conf

用户指定工程配置文件或用户指定三个参数之一读取默认的工程配置文件,取值为:

  • path:指定工程模型配置文件,如${install_path}/ascend-toolkit/latest/tools/msadvisor/conf/model.json。

    json配置文件文件默认保存路径为${install_path}/ascend-toolkit/latest/tools/msadvisor/conf/,${install_path}为CANN-toolkit包的指定安装路径。

  • op:读取算子场景的默认op.json配置文件。
  • model:读取模型场景的默认model.json配置文件。
  • all:读取全场景(包括算子和模型)的all.json配置文件。

不指定-c参数时,默认执行op.json文件。

工程配置文件内配置了专家系统执行的具体分析操作,由系统自带,用户只需根据场景指定对应的配置文件即可。

-s

--soc_version

设置待分析文件所属设备的芯片版本。取值为:

  • ascend310:表示待分析文件所属设备的芯片版本为ascend310。

默认值为ascend310。

当专家系统工具安装环境与待分析文件在同一环境下时,无需配置本参数,专家系统会自动识别设备芯片版本;专家系统工具安装环境为远端环境时,需要将待分析文件拷贝到远端环境,并根据待分析文件所属设备的芯片版本配置本参数。

当前仅基于Roofline模型的算子瓶颈识别与优化建议功能支持本参数。

-h

--help

命令行用户使用的帮助信息,解释使用方式。

专家系统支持多进程执行,可配置最大进程数,以及单进程最长运行时间。配置方式如下:

  1. 进入专家系统工具安装目录下的conf目录,例如:

    cd Ascend-cann-toolkit安装目录/ascend-toolkit/latest/tools/msadvisor/conf

  2. 编辑目录下的advisor.conf文件,设置max_run_time(单进程最长运行时间,默认值20s)参数值。例如:

    max_run_time = 20