---
title: 比对操作和分析
description: "- 本节涉及的.json文件、目录等名称均为举例，请根据实际环境替换。其中，-out指定的结果存放路径，需确保操作用户具有读写权限。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/devaids/ModelAccuracyAnalyzer/atlasaccuracy_16_0024.html
sourcePath: /source/zh/canncommercial/900/devaids/ModelAccuracyAnalyzer/atlasaccuracy_16_0024.html
indexId: 7af7c6acc78b944a1887e724a39dbc68e36c503d102edb4125d8eed111125b8986
---
# 比对操作和分析

#### 说明

- 本节涉及的.json文件、目录等名称均为举例，请根据实际环境替换。其中，-out指定的结果存放路径，需确保操作用户具有读写权限。
- 如果执行过程中报“MemoryError”，则表示数据量过大导致了内存溢出，请将NPU的dump数据文件拆分到多个目录后，再逐一进行比对。
- 当指定的比对数据文件大小超过1GB或.json文件大小超过100MB时，比对过程可能耗时较长，系统提示：'The size (%d) of %s more than the XX, it needs more time to run.'。


#### 前提条件

- 请确保完成  使用前准备
。
- 根据  总体说明
中的场景准备比对文件。


#### 操作步骤

本节以非量化AI处理器运行生成的dump数据与非量化ONNX模型npy文件比对为例进行介绍，下文中参数说明均以该示例介绍，请根据您的实际情况进行替换。

1. 登录Ascend-cann-toolkit环境。
2. 进入${INSTALL_DIR}/tools/operator_cmp/compare，${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。
3. 执行比对命令。
  由于dump和npy比对数据文件是由多个文件组成，故下文操作步骤中-m和-g参数须指定数据文件所在的父目录。如：$HOME/MyApp/resnet50，其中resnet50文件夹下直接保存比对数据文件。 目录结构示例如下： 1 2 3 4 5 6 root@xxx:$HOME/MyApp/resnet50# tree . ├── BatchMatMul.bert_encoder_layer_0_attention_self_MatMul_1.24.1614717261785536 ├── BatchMatMul.bert_encoder_layer_0_attention_self_MatMul.21.1614717261768864 ├── BatchMatMul.bert_encoder_layer_10_attention_self_MatMul_1.235.1614717263664916 # 仅为示例，此处省略剩余文件名。

```
python3 msaccucmp.py compare -m
$HOME/MyApp/npu_dump/20230216155330/0/resnet50/1/0/
-g
$HOME/MyApp/onnx_dump/
-f
$HOME/module/out/onnx_resnet50.json
-out
$HOME/result
-advisor
```


  上述命令仅展示当前场景所需参数的示例，若需要配置更多参数，比如已知可能出现精度问题的范围或因大型网络模型输出结果文件数据量过大，通过配置参数来减少输出结果的数据量，请参见命令格式说明获取更多参数详细介绍。 需要安装pandas 1.3或更高版本依赖，否则无法执行-advisor参数输出专家建议。

**表1 整网比对命令行参数说明**

| 参数名 | 参数说明 | 是否必选 |
| --- | --- | --- |
| \-m \-\-my\_dump\_path | 基于AI处理器运行生成的数据文件所在目录。 | 是 |
| \-g \-\-golden\_dump\_path | 基于GPU运行生成的原始网络数据文件所在目录。 | 是 |
| \-f \-\-fusion\_rule\_file | 全网层信息文件。 通过ATC转换.om模型文件生成的.json文件，文件包含整网算子的映射关系，用于精度比对时算子匹配。 | 否 |
| \-out \-\-output | 比对数据结果存放路径，默认为当前路径。 不建议配置与当前用户不一致的其它用户目录，避免提权风险。 | 否 |
| \-advisor | 在Tensor比对结束后，针对比对结果进行数据分析，给出专家建议。详情请参见比对结果专家建议 | 否 |


  比对结果如图1所示。

  图1 比对结果示例

  以上比对结果字段解释请参见完整比对结果参数说明。

4. 比对结果分析。
  请参见比对结果分析。对于比对结果中可能存在部分无法比对或异常情况（例如结果中的NaN），请参见比对结果说明。