命令格式说明

-m

--my_dump_path

My Output模型的比对数据文件目录。

由于dump数据文件是多个二进制文件，故须指定dump数据文件所在的父目录。如：/home/HwHiAiUser/MyApp_mind/resnet50，其中resnet50文件夹下直接保存dump数据文件。

是

-g

--golden_dump_path

Ground Truth模型的比对数据文件目录。

缺省情况下，该参数指定的就是模型转换开启算子融合下dump数据文件的目录；当指定-cf参数时，该参数指定的就是模型转换关闭算子融合下dump数据文件的目录。

由于npy数据文件是多个npy文件，故须指定npy数据文件所在的父目录。如：/home/HwHiAiUser/Standard_caffe/resnet50 ，其中resnet50文件夹下直接保存npy数据文件。

是

-f

--fusion_rule_file

离线模型全网层信息文件（通过使用ATC转换.om模型文件生成的json文件，文件包含整网算子的映射关系）。

该参数指定的是默认开启算子融合情况下进行模型转换时生成的json文件；指定关闭算子融合情况下进行模型转换时生成的json文件使用-cf参数。

否

-cf

--close_fusion_rule_file

离线模型全网层信息文件（通过使用ATC转换.om模型文件生成的json文件，文件包含关闭算子融合功能情况下整网算子的映射关系）。

本参数详细使用指导请参见比对步骤（融合算子精度问题排查）

否

-q

--quant_fusion_rule_file

量化算子映射关系文件（昇腾模型压缩输出的的json文件）。

否

-out

--output

比对数据结果存放路径，默认为当前路径。

否

-map

--mapping

输出GPU/NPU的映射表。

一般情况下GPU/NPU的映射表需要在完成精度比对之后，才能从csv中获取。本参数实现在精度比对前，直接提取GPU/NPU的映射表。建议在比对数据量太大，需要提前获取GPU/NPU的映射表的场景下使用。详细操作请参见获取GPU/NPU的映射表。

否

-c

--custom_script_path

用户自定义脚本文件存放路径，包括自定义算法.py文件和自定义Format转换.py文件，需指定到脚本目录的上一层目录。指定本参数时判断是否存在以下文件目录：

• 存在自定义算法.py文件目录，目录格式为“algorithm”，则读取“algorithm”目录下的自定义算法.py文件，生成自定义算法，可通过-alg参数指定为比对算法。自定义算法.py文件相关要求参见准备自定义算法.py文件。
• 存在自定义Format转换.py文件目录，目录格式为“format_convert”，则读取“format_convert”目录下的自定义Format转换.py文件。自定义Format转换.py文件相关要求参见准备自定义Format转换.py文件。

不建议调用与当前用户不一致的其它用户目录下的自定义脚本文件，避免提权风险。

否

-alg

--algorithm

比对维度，取值为：

• 0：CosineSimilarity，表示余弦相似度算法。
• 1：MaxAbsoluteError，表示最大绝对误差算法。
• 2：AccumulatedRelativeError，表示累积相对误差算法。
• 3：RelativeEuclideanDistance，表示欧氏相对距离算法。
• 4：KullbackLeiblerDivergence，表示KL散度算法。
• 5：StandardDeviation，表示标准差算法。
• 6：MeanAbsoluteError，表示平均绝对误差。
• 7：RootMeanSquareError，表示均方根误差。
• 8：MaxRelativeError，表示最大相对误差。
• 9：MeanRelativeError，表示平均相对误差。
• all：比对全部算法（包含自定义和内置算法）。

配置不同的取值则使用该取值对应维度的算法进行比对，也可指定-c参数的自定义算法名algorithm_name，例如自定义算法名为alg_RelativeError.py，可多选，all为默认取值，配置格式为各取值间用逗号分隔，可配置为数字或算法名，例如0,1,2,RelativeError。

若只选择比对部分维度，则比对结果同样只展示对应维度。

否

-a

--algorithm_options

比对算法的高级选项，可为指定的算法设置参数，指定的算法必须是-alg参数的内置算法或者-c参数的自定义算法，被本参数设置后的算法以本参数设置的值执行运算。

输入格式为：算法名:参数名=值,参数名=值;算法名:参数名=值,参数名=值。参数之间是逗号分隔，不同算法是分号分隔，例如："CosineSimilarity:max=1,min=0;aa:max=1,min=0"。其中算法名与-c参数自定义算法.py文件的algorithm_name（参见准备自定义算法.py文件）一致。

否

-v

--version

dump文件类型，1代表protobuf序列化后的数据文件，2代表自定义格式的数据文件。默认取2。

否

-r

--range

设定算子比对范围。配置方式如下：

• start：第一个比对的算子，取值范围为[1, 参与计算的算子个数]，默认值为1。
• end：最后一个比对的算子，取值范围为-1或[start, 参与计算的算子个数]，默认值为-1（动态获取网络模型中最后一个参与计算的算子）。
• step：第start+step*n个比对的算子，step取值范围为[1, 参与计算的算子个数)，默认值为1，n为从1开始的正整数。

配置格式为：“start,end,step”。比如：-r 1,101,20，表示算子1,21,41,61,81,101的Tensor参与比对。

不配置本参数时，比对网络模型中的所有参与计算的算子。

比对场景中的5、7场景不支持配置本参数。

否

-overflow_detection

整网算子溢出检测。进行整网比对时可检测溢出算子。

默认未配置本参数。

当算子的Tensor数据类型是fp16时，tensor中的任意一个数值的绝对值 >= 65504，认为算子溢出。

比对场景中的5景配置本参数不生效。

否