工具概述

功能描述

命令汇总

• 生成算子测试用例定义文件。

  表1 生成算子测试用例定义文件的参数说明

  参数名称	参数描述	是否必选
  create	用于生成算子测试用例定义文件（*.json）。	是
  -i，--input	host侧算子的实现文件路径（*.cpp文件），可配置为绝对路径或者相对路径。	是
  -out，--output	生成文件所在路径，可配置为绝对路径或者相对路径，并且工具执行用户具有可读写权限。 若不配置，则默认生成在执行命令的当前路径。	否
  -m，--model	配置为TensorFlow模型文件的路径，可配置为绝对路径或者相对路径。 若配置此参数，工具会从TensorFlow模型文件中获取首层算子的shape信息，并自动dump出算子信息库定义文件中算子的shape、dtype以及属性的value值，如果dump出的值在算子信息库定义文件所配置的范围内，则会自动填充到生成的算子测试用例定义文件中；否则会报错。 须知： 若配置此参数，系统中需要安装1.15或2.6.5版本的TensorFlow。	否
  -q，--quiet	当前版本仅针对-m参数生效，代表是否进行人机交互。 若不配置-q参数，则会提示用户修改获取到的模型中的首层shape信息。 若配置了-q参数，则不会提示用户更改首层shape信息。	否

• 生成/执行测试用例。

  表2 生成/执行测试用例的参数说明

  参数名称	参数描述	是否必选
  run	用于执行算子的ST测试用例。	是
  -i，--input	算子测试用例定义文件（*.json）的路径，可配置为绝对路径或者相对路径。 说明： json文件最多支持1000个用例。	是
  -soc，--soc_version	配置为昇腾AI处理器的类型。 说明： 在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，获取Chip Name信息。实际配置值为AscendChip Name，例如Chip Name取值为xxxyy，实际配置值为Ascendxxxyy。当Ascendxxxyy为代码样例的路径时，需要配置为ascendxxxyy。	是
  -out，--output	生成文件所在路径，可配置为绝对路径或者相对路径，并且工具执行用户具有可读写权限。若不配置该参数，则默认生成在执行命令的当前路径。	否
  -c，--case_name	配置为需要执行的case的名字，若需要同时运行多个case，多个case之间使用逗号分隔。 若配置为“all”，或者不配置此参数，代表执行所有case。	否
  -d，--device_id	NPU设备ID，设置运行ST测试用例的昇腾AI处理器的ID。 若未设置此参数，默认为：0。	否
  -err_thr，--error_threshold	配置自定义精度标准，取值为含两个元素的列表："[threshold1，threshold2]"。 threshold1：算子输出结果与标杆数据误差阈值，若误差大于该值则记为误差数据。 threshold2：误差数据在全部数据占比阈值。若误差数据在全部数据占比小于该值，则精度达标，否则精度不达标。 若未设置此参数，默认值为："[0.01,0.05]"。 取值范围为："[0.0,1.0]"。 说明： 配置的列表需加引号以避免一些问题。例如配置为：-err_thr "[0.01,0.05]"。 若测试用例json文件和执行msOpST命令时均配置该参数，以执行msOpST命令时配置的精度标准进行比对。 若均未配置，则以执行msOpST命令时默认精度标准[0.01,0.05]进行比对。	否
  -conf，--config_file	ST测试高级功能配置文件（msopst.ini）存储路径，可配置为绝对路径或者相对路径。 用户可通过修改msopst.ini配置文件，实现如下高级功能： ST测试源码可编辑。 已编辑的ST测试源码可执行。 设置host日志级别环境变量。 设置日志是否在控制台显示。 设置atc模型转换的日志级别。 设置atc模型转换运行环境的操作系统类型及架构。 设置模型精度。 读取算子在昇腾AI处理器上运行的性能数据。 若未配置--config_file文件，模型将强制使用FP16类型精度，msopst.ini配置文件的详细说明请参见表1。	否
  -err_report，--error_report	针对比对失败的用例，获取算子期望数据与实际用例执行结果不一致的数据。若未设置此参数，默认为：“false”。 true：针对比对失败的用例，将算子期望数据与实际用例执行结果不一致的数据保存在{case.name}_error_report.csv文件中。 false：不保存比对失败的数据结果。 说明： 设置此参数为“true”时，获取的比对数据会根据每个case_name生成独立的csv文件，{case.name}_error_report.csv文件所在目录为{output_path}/{time_stamp}/{op_type}/run/out/test_data/data/st_error_reports。 单个csv文件保存数据的上限为5万行，超过则依次生成新的.csv文件，文件命名如：{case.name}_error_report0.csv。	否

补充说明

msOpST工具其他参数说明可参考表4。