当前位置：首页 > news >正文

CANN算子测试赛作品提交规范

news 2026/5/9 13:16:51

作品提交规范

【免费下载链接】cann-competitions本仓库用于 CANN 开源社区各类竞赛、开源课题、社区任务等课题发布、开发者作品提交和展示。项目地址: https://gitcode.com/cann/cann-competitions

本规范适用于preliminary/submissions/与final/submissions/目录下的所有团队提交。请各参赛队伍严格按照本规范组织提交内容，不符合规范的提交可能导致 PR 无法合并，进而影响后续奖金与证书的发放。

一、目录命名规范

在对应赛事阶段的submissions/目录下创建团队目录：

{submissions}/{school}_{team-name}/

命名规则：

school：学校代码缩写（如nju、seu、hitsz、tju）
team-name：团队自定名称，使用短横线分隔（如op-pioneers），若是中文则可以使用拼音代替

示例：

preliminary/submissions/nju_op-pioneers/ preliminary/submissions/hitsz_test-masters/ final/submissions/nju_op-pioneers/

注意：文件与文件夹命名请使用英文，可以使用拼音来进行代替

预选赛与决赛的提交目录相互独立，晋级决赛的队伍需在final/submissions/下另建目录。

二、目录结构要求

每个团队的提交目录仅需包含以下三部分：

team01_nju_op-pioneers/ ├── README.md # 必选：团队信息、环境要求、文件说明 ├── code/ # 必选：测试代码（按算子组织） └── report/ # 必选：测试报告

1. code/（测试代码）

按算子建立子目录，每个子目录包含针对该算子的测试代码源文件。预选赛与决赛的算子不同，请按当前阶段的赛题组织。

预选赛示例：

code/ ├── Add/ │ └── test_aclnn_add.cpp ├── Mul/ │ └── test_aclnn_mul.cpp └── Pow/ └── test_aclnn_pow.cpp

决赛示例：

code/ ├── Add/ │ └── test_aclnn_add.cpp └── Cumsum/ └── test_aclnn_cumsum.cpp

说明：

仅提交源代码与必要的构建脚本（如CMakeLists.txt），不提交build/目录、目标文件、覆盖率数据（.gcda/.gcno）等编译产物
评测时由组委会按统一环境重新编译运行
若有多个测试文件，请保持目录扁平、命名清晰

2. report/（测试报告）

测试报告用于说明测试设计思路、覆盖率统计与问题发现情况。格式与组织方式：

接受 PDF 或 Markdown 格式
可按算子分别提交（如report/Add.pdf、report/Mul.pdf），也可合并为一份总报告（如report/report.pdf）
若包含图片附件，统一放在report/assets/下

3. README.md（团队说明）

格式与内容详见下一节。

三、README.md 内容规范

每个提交目录下的README.md必须包含以下三个部分：

1. 团队信息

## 团队信息 - 团队名称：[团队名称] - 所属单位：[学校全称] - 团队成员： - [姓名]，[在团队中的分工] - [姓名]，[在团队中的分工] - 联系人：[姓名] - 联系邮箱：[邮箱地址]

2. 环境要求

## 环境要求 - CANN 版本：[如 8.0.RC1] - 操作系统：[如 Ubuntu 20.04 x86_64] - 编译器：[如 g++ 9.4.0] - 测试框架：[如 GoogleTest 1.12.1] - 其他依赖：[如有，逐项列出]

如使用大赛提供的 Docker 镜像（yeren666/cann-ops-test:v1.0），请在此处注明并标注镜像版本。

3. 文件说明

## 文件说明 - `code/`：测试代码源文件，按算子分子目录组织 - `code/Add/`：Add 算子测试代码 - `code/Mul/`：Mul 算子测试代码 - ... - `report/`：测试报告 - `report/report.pdf`：测试报告主文档 ## 编译与运行 [简要说明如何编译运行测试代码，例如：] 1. 进入对应算子目录：`cd code/Add` 2. 编译：`mkdir build && cd build && cmake .. && make` 3. 运行：`./test_aclnn_add`