cannsim改名为npusim-ops-cv-AtomGit

已合并

cannsim改名为npusim #1241

liangbinglong创建于 19 天前从liangbinglong/ops-cv： master 合入到 cann/ops-cv： master

cannsim改名为npusim #1241

已合并

liangbinglong创建于 19 天前

从liangbinglong/ops-cv master合入到cann/ops-cv master

共 4 个文件变更+39-34

MREADME.md+1-1

	@@ -3,7 +3,7 @@
3	## 🔥Latest News	3	## 🔥Latest News
4		4
5	- [2026/01] 新增[QuickStart](docs/QUICKSTART.md)，指导新手零基础入门算子项目部署（支持Docker环境）、算子开发和贡献流程。	5	- [2026/01] 新增[QuickStart](docs/QUICKSTART.md)，指导新手零基础入门算子项目部署（支持Docker环境）、算子开发和贡献流程。
6	-- [2025/12] 开源算子支持Ascend 950PR/Ascend 950DT/KirinX90，可以通过[CANN Simulator](docs/zh/debug/cann_sim.md)仿真工具开发调试；优化指南类文档，聚焦[算子开发指南](docs/zh/develop/aicore_develop_guide.md)，明确最小交付件和关键示例代码，针对Ascend/samples仓算子提供迁移本项目的指导；新增onnx算子插件支持。	6	+- [2025/12] 开源算子支持Ascend 950PR/Ascend 950DT/KirinX90，可以通过[NPU Simulator](docs/zh/debug/npu_sim.md)仿真工具开发调试；优化指南类文档，聚焦[算子开发指南](docs/zh/develop/aicore_develop_guide.md)，明确最小交付件和关键示例代码，针对Ascend/samples仓算子提供迁移本项目的指导；新增onnx算子插件支持。
7	- [2025/11] [three_interpolate_backward](image/three_interpolate_backward/docs/aclnnThreeInterpolateBackward.md)算子新增确定性计算特性；新增[opgen](docs/zh/develop/aicore_develop_guide.md#工程创建)支持自动生成算子工程。	7	- [2025/11] [three_interpolate_backward](image/three_interpolate_backward/docs/aclnnThreeInterpolateBackward.md)算子新增确定性计算特性；新增[opgen](docs/zh/develop/aicore_develop_guide.md#工程创建)支持自动生成算子工程。
8	- [2025/10] 新增experimental目录，完善[贡献指南](CONTRIBUTING.md)，支持开发者调试并贡献自定义算子。	8	- [2025/10] 新增experimental目录，完善[贡献指南](CONTRIBUTING.md)，支持开发者调试并贡献自定义算子。
9	- [2025/09] ops-cv项目首次上线，开源算子支持Atlas A2/A3系列产品。	9	- [2025/09] ops-cv项目首次上线，开源算子支持Atlas A2/A3系列产品。

Mdocs/README.md+1-1

	@@ -54,7 +54,7 @@ Docs目录结构说明如下：
54		54
55	\| 文档 \| 说明 \|	55	\| 文档 \| 说明 \|
56	\| ----------------------- \| ---------------------- \|	56	\| ----------------------- \| ---------------------- \|
57	-\| [Simulator仿真工具](zh/debug/cann_sim.md) \| 面向算子开发场景的SoC级仿真工具，用于分析运行在AI仿真器上AI任务在各阶段精度和性能数据。 \|	57	+\| [Simulator仿真工具](zh/debug/npu_sim.md) \| 面向算子开发场景的SoC级仿真工具，用于分析运行在AI仿真器上AI任务在各阶段精度和性能数据。 \|
58		58
59	### 更多文档	59	### 更多文档
60		60

Rdocs/zh/debug/cann_sim.md→docs/zh/debug/npu_sim.md+33-28

	@@ -1,6 +1,6 @@
1	# 简介	1	# 简介
2		2
3	-CANN Simulator是一款面向算子开发场景的SoC级芯片仿真工具，用于分析运行在AI仿真器上的AI任务在各阶段的精度和性能数据（如指令执行情况等）。该工具有助于用户进行深度性能调优，使研发人员在无法获取或芯片资源紧缺的情况下，也能获得与真实芯片几乎一致的验证效果和性能反馈。	3	+NPU Simulator是一款面向算子开发场景的SoC级芯片仿真工具，用于分析运行在AI仿真器上的AI任务在各阶段的精度和性能数据（如指令执行情况等）。该工具有助于用户进行深度性能调优，使研发人员在无法获取或芯片资源紧缺的情况下，也能获得与真实芯片几乎一致的验证效果和性能反馈。
4		4
5	# 主要功能	5	# 主要功能
6		6
	@@ -21,12 +21,17 @@ CANN Simulator是一款面向算子开发场景的SoC级芯片仿真工具，用
21	* 本工具为开发工具，不建议在生产环境使用。	21	* 本工具为开发工具，不建议在生产环境使用。
22	* 工具的仿真功能仅支持单卡场景，无法仿真多卡环境，代码中只能设置为0卡。若修改可见卡号，将导致仿真失败。	22	* 工具的仿真功能仅支持单卡场景，无法仿真多卡环境，代码中只能设置为0卡。若修改可见卡号，将导致仿真失败。
23	* 仿真环境仅支持AI Core计算类算子（不支持MC2和HCCL类型的算子）。	23	* 仿真环境仅支持AI Core计算类算子（不支持MC2和HCCL类型的算子）。
24	-* CANN Simulator工具目前处于尝鲜版本阶段，仅支持Ascend950PR芯片，建议仿真器运行环境配置为16核CPU和32GB以上内存。	24	+* NPU Simulator工具仅支持Ascend950PR和Ascend950DT芯片，建议仿真器运行环境配置为16核CPU和32GB以上内存。
25	* 目前不支持arm环境仿真。	25	* 目前不支持arm环境仿真。
26		26
		27	+```
		28	+名称变更通知：
		29	+自2026年7月30号版本起，仿真器名称cannsim正式更名为npusim，所有命令行工具名称同步变更。旧命令cannsim作为别名保留一段时间，建议尽快迁移到npusim
		30	+```
		31	+
27	## 环境准备	32	## 环境准备
28		33
29	-CANN Simulator集成在CANN toolkit包里，参考[环境部署](../install/quick_install.md)完成软件包的安装	34	+NPU Simulator集成在CANN toolkit包里，参考[环境部署](../install/quick_install.md)完成软件包的安装
30		35
31	# 快速开始	36	# 快速开始
32		37
	@@ -48,10 +53,10 @@ bash build.sh --pkg --soc=Ascend950 --vendor_name=custom --ops=add_example
48	## 执行仿真命令	53	## 执行仿真命令
49		54
50	```bash	55	```bash
51	-cannsim record ./test_aclnn_add_example -s Ascend950 --gen-report	56	+npusim record ./test_aclnn_add_example -s Ascend950 --gen-report
52	```	57	```
53		58
54	-仿真工具执行日志文件在examples/add_example/examples/build/bin/cannsim_*目录，执行日志文件为cannsim.log。	59	+仿真工具执行日志文件在examples/add_example/examples/build/bin/npusim_*目录，执行日志文件为npusim.log。
55		60
56	从仿真工具日志文件可以看到示例中的打印信息：	61	从仿真工具日志文件可以看到示例中的打印信息：
57		62
	@@ -67,7 +72,7 @@ add_example first input[6] is: 1.000000, second input[6] is: 1.000000, result[6]
67		72
68	## 查看性能流水	73	## 查看性能流水
69		74
70	-仿真性能流水文件在本项目`examples/add_example/examples/build/bin/cannsim_/report/results/kernel_/core_*`目录，流水相关文件为：	75	+仿真性能流水文件在本项目`examples/add_example/examples/build/bin/npusim_/report/results/kernel_/core_*`目录，流水相关文件为：
71		76
72	```bash	77	```bash
73	trace_core0.json	78	trace_core0.json
	@@ -83,7 +88,7 @@ trace_core0.json
83		88
84	## 命令格式	89	## 命令格式
85		90
86	-cannsim record [options] user_app	91	+npusim record [options] user_app
87		92
88	## 参数说明	93	## 参数说明
89		94
	@@ -104,21 +109,21 @@ cannsim record [options] user_app
104	2. 执行仿真命令，可参考以下使用示例	109	2. 执行仿真命令，可参考以下使用示例
105		110
106	```bash	111	```bash
107	- 方式一：启用仿真，并将输出保存至./output目录，/path/to/app为算子程序	112	+ # 方式一：启用仿真，并将输出保存至./output目录，/path/to/app为算子程序
108	- $ cannsim record /path/to/app -o ./output -s Ascend950	113	+ $ npusim record /path/to/app -o ./output -s Ascend950
109		114
110	- 方式二：启用仿真并生成报告，用于后续性能分析	115	+ # 方式二：启用仿真并生成报告，用于后续性能分析
111	- $ cannsim record /path/to/app -o ./output -s Ascend950 --gen-report	116	+ $ npusim record /path/to/app -o ./output -s Ascend950 --gen-report
112	```	117	```
113		118
114	-3. 命令完成后，会在默认路径或指定的“output”目录下生成以“cannsim_{timestamp}_${user_app}”命名的文件夹，结构示例如下：	119	+3. 命令完成后，会在默认路径或指定的“output”目录下生成以“npusim_{timestamp}_${user_app}”命名的文件夹，结构示例如下：
115		120
116	```bash	121	```bash
117	- ├─cannsim_{timestamp}_${user_app}	122	+ ├─npusim_{timestamp}_${user_app}
118	- ├── cannsim.log	123	+ ├── npusim.log
119	```	124	```
120		125
121	-4. 用户可以获取算子执行结果，并进行精度的对比，结果展示在cannsim.log，示例如下	126	+4. 用户可以获取算子执行结果，并进行精度的对比，结果展示在npusim.log，示例如下
122		127
123	以下输出仅为Ascend C单算子直调精度比较结果举例，因版本不同略有差异，请以实际输出为准。	128	以下输出仅为Ascend C单算子直调精度比较结果举例，因版本不同略有差异，请以实际输出为准。
124		129
	@@ -139,7 +144,7 @@ cannsim record [options] user_app
139		144
140	## 命令格式	145	## 命令格式
141		146
142	-cannsim report [options]	147	+npusim report [options]
143		148
144	## 参数说明	149	## 参数说明
145		150
	@@ -147,7 +152,7 @@ cannsim report [options]
147		152
148	\|参数 \| 可选/必选 \| 说明\|	153	\|参数 \| 可选/必选 \| 说明\|
149	\| --- \| --- \| --- \|	154	\| --- \| --- \| --- \|
150	-\|-e或--export \| 必选 \| 仿真执行结果目录，指定到cannsim_{timestamp}_${user_app}层，可配置为绝对路径或者相对路径，且执行用户需具有读写权限。\|	155	+\|-e或--export \| 必选 \| 仿真执行结果目录，指定到npusim_{timestamp}_${user_app}层，可配置为绝对路径或者相对路径，且执行用户需具有读写权限。\|
151	\|-o或--output \| 可选 \| 指令流水图输出目录，可配置为绝对路径或者相对路径，且执行用户需具有读写权限。若未指定路径，默认与export目录相同。\|	156	\|-o或--output \| 可选 \| 指令流水图输出目录，可配置为绝对路径或者相对路径，且执行用户需具有读写权限。若未指定路径，默认与export目录相同。\|
152	\|-n或--core-id \| 可选 \| 指定生成指令流水的核ID，支持格式：'all'、'0-2,12-14'、'5'。不指定默认生成0核的指令流水。\|	157	\|-n或--core-id \| 可选 \| 指定生成指令流水的核ID，支持格式：'all'、'0-2,12-14'、'5'。不指定默认生成0核的指令流水。\|
153	\|-f或--object-file \| 可选 \| 设备对象文件路径，用于辅助生成报告。\|	158	\|-f或--object-file \| 可选 \| 设备对象文件路径，用于辅助生成报告。\|
	@@ -158,11 +163,11 @@ cannsim report [options]
158	2. 执行仿真结果解析命令，可参考以下执行用例。	163	2. 执行仿真结果解析命令，可参考以下执行用例。
159		164
160	```bash	165	```bash
161	- 在当前目录下生成性能分析报告（默认仅分析核0）	166	+ # 在当前目录下生成性能分析报告（默认仅分析核0）
162	- cannsim report -e /path/to/cannsim_{timestamp}_${user_app}	167	+ npusim report -e /path/to/npusim_{timestamp}_${user_app}
163		168
164	- 在指定目录下生成核0、核1、核11、核12的性能分析报告	169	+ # 在指定目录下生成核0、核1、核11、核12的性能分析报告
165	- cannsim report -e /path/to/cannsim_{timestamp}_${user_app} -o /path/to/report -n '0-1, 11-12'	170	+ npusim report -e /path/to/npusim_{timestamp}_${user_app} -o /path/to/report -n '0-1, 11-12'
166	```	171	```
167		172
168	3. 命令执行完后，会在output配置的目录下生成对应的流水文件，文件格式为json格式，输出结果示例如下：	173	3. 命令执行完后，会在output配置的目录下生成对应的流水文件，文件格式为json格式，输出结果示例如下：
	@@ -202,20 +207,20 @@ cannsim report [options]
202	查询工具帮助信息：	207	查询工具帮助信息：
203		208
204	```bash	209	```bash
205	-cannsim --help	210	+npusim --help
206	```	211	```
207		212
208	查询工具record子命令的帮助信息：	213	查询工具record子命令的帮助信息：
209		214
210	```bash	215	```bash
211	-cannsim record --help	216	+npusim record --help
212	```	217	```
213		218
214	查询工具report子命令的帮助信息：	219	查询工具report子命令的帮助信息：
215		220
216	- ```bash	221	+```bash
217	- cannsim report --help	222	+npusim report --help
218	- ```	223	+```
219		224
220	## 参数说明	225	## 参数说明
221		226
	@@ -227,13 +232,13 @@ cannsim record --help
227	2. 执行以下命令。	232	2. 执行以下命令。
228		233
229	```bash	234	```bash
230	- cannsim --help	235	+ npusim --help
231	```	236	```
232		237
233	## 输出说明	238	## 输出说明
234		239
235	```bash	240	```bash
236	-usage: cannsim [-h] {record,report} ...	241	+usage: npusim [-h] {record,report} ...
237		242
238	Command-line tool for performance simulation analysis on Ascend hardware.	243	Command-line tool for performance simulation analysis on Ascend hardware.
239		244

Mdocs/zh/debug/op_debug_prof.md+4-4

	@@ -157,21 +157,21 @@
157		157
158	完成算子开发和编译后，假设采用aclnn接口方式调用，生成的算子可执行文件（test_aclnn_add_example）所在目录为本项目`examples/add_example/examples/build/bin/`。	158	完成算子开发和编译后，假设采用aclnn接口方式调用，生成的算子可执行文件（test_aclnn_add_example）所在目录为本项目`examples/add_example/examples/build/bin/`。
159		159
160	- - 针对Ascend 950PR，可使用[CANN Simulator](./cann_sim.md)仿真工具，执行仿真命令，生成仿真数据	160	+ - 针对Ascend 950PR，可使用[NPU Simulator](./npu_sim.md)仿真工具，执行仿真命令，生成仿真数据
161		161
162	执行仿真命令，生成仿真数据	162	执行仿真命令，生成仿真数据
163		163
164	```bash	164	```bash
165	- cannsim record ./test_aclnn_add_example -s Ascend950 --gen-report	165	+ npusim record ./test_aclnn_add_example -s Ascend950 --gen-report
166	```	166	```
167		167
168	- 仿真结果在本项目`examples/add_example/examples/build/bin/cannsim_/report/results/kernel_/core_*`目录，流水相关文件为：	168	+ 仿真结果在本项目`examples/add_example/examples/build/bin/npusim_/report/results/kernel_/core_*`目录，流水相关文件为：
169		169
170	```bash	170	```bash
171	trace_core0.json	171	trace_core0.json
172	```	172	```
173		173
174	- 在Chrome浏览器中输入“chrome://tracing”地址，并将生成的指令流水图文件（trace_core0.json）拖到空白处打开，具体参数介绍参考CANN Simulator中[“仿真结果解析说明”](./cann_sim.md#仿真结果解析说明)章节。	174	+ 在Chrome浏览器中输入“chrome://tracing”地址，并将生成的指令流水图文件（trace_core0.json）拖到空白处打开，具体参数介绍参考NPU Simulator中[“仿真结果解析说明”](./npu_sim.md#仿真结果解析说明)章节。
175		175
176	- 针对Atlas A2/A3系列产品，可使用[msProf](https://www.hiascend.com/document/redirect/CannCommunityToolMsprof)工具，执行仿真命令，生成仿真数据	176	- 针对Atlas A2/A3系列产品，可使用[msProf](https://www.hiascend.com/document/redirect/CannCommunityToolMsprof)工具，执行仿真命令，生成仿真数据
177		177