0843e90a创建于 7月18日历史提交

文件	最后提交记录	最后更新时间
CMakeLists.txt	切换最低兼容版本为CANN 8.5.0；使用AscendC CMake构建系统编译 Co-authored-by: yuantao<taoyuan18@huawei.com> # message auto-generated for no-merge-commit merge: !461 merge asc into master 切换最低兼容版本为CANN 8.5.0；使用AscendC CMake构建系统编译 Created-by: yuantao_ Commit-by: yuantao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 适配asc+CMake编译系统。 2. 对于适配的调试特性(DumpTensor)，在新编译系统引入后不再需要，去除相关代码，相关编译选项添加Warning。 3. 更新对应相关文档。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue --> ## 原因 <!--说明此次改动的目的、解决的问题等，应与类型标签匹配 --> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/catlass!461	4 个月前
README.md	文档低错整改 Co-authored-by: sunhao_hw<sunhao203@huawei.com> # message auto-generated for no-merge-commit merge: !859 merge debug into master 文档低错整改 Created-by: sunhao_hw Commit-by: sunhao_hw Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 使用doc tools工具排查文档存在 - 代码块未指定语言 - 代码块前后换行 - 本地路径链接无法访问 - 列表前后换行 - 加粗符号空格 - 标签匹配失败 - 有序列表编号错误等问题基于大模型扫描修复文字描述中出现的低级错误 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> ## 原因 <!--说明此次改动的目的、解决的问题等，应与类型标签匹配 --> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/catlass!859	1 个月前
README_en.md	文档低错整改 Co-authored-by: sunhao_hw<sunhao203@huawei.com> # message auto-generated for no-merge-commit merge: !859 merge debug into master 文档低错整改 Created-by: sunhao_hw Commit-by: sunhao_hw Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 使用doc tools工具排查文档存在 - 代码块未指定语言 - 代码块前后换行 - 本地路径链接无法访问 - 列表前后换行 - 加粗符号空格 - 标签匹配失败 - 有序列表编号错误等问题基于大模型扫描修复文字描述中出现的低级错误 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> ## 原因 <!--说明此次改动的目的、解决的问题等，应与类型标签匹配 --> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/catlass!859	1 个月前
basic_conv2d.cpp	补充Conv类测试接口 Co-authored-by: init__zhb__<zhanghaobo6@huawei.com> # message auto-generated for no-merge-commit merge: !806 merge br.33convbasic.up into master 补充Conv类测试接口 Created-by: init__zhb__ Commit-by: init__zhb__ Merged-by: cann-robot Description: ## 描述 - 声明33和56的约束（在文档中补充），并补充CanImplement校验。 - 补充ConvBias的测试接口(pre-built模式) - 补充BasicConv2d的测试接口(pre-built模式)，对应于样例[33_basic_conv2d](https://gitcode.com/cann/catlass/tree/master/examples/33_basic_conv2d) - 补充56 Ascend950BasicConv2dTla的测试接口(pre-built模式) ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> ## 原因补充测试接口以便支持后续质量看护。 ## 测试 ### 24 conv_bias <span style="color:green">PASS</span> bash (catlass_py31) root@debian:/xxx/catlass/tests/optest# pytest tests/test_24_conv_bias.py ============================================================================ test session starts ============================================================================= platform linux -- Python 3.11.15, pytest-9.1.1, pluggy-1.6.0 rootdir: /home/z00951271/catlass/tests/optest configfile: pyproject.toml plugins: anyio-4.14.1 collected 4 items tests/test_24_conv_bias.py .... [100%] ============================================================================= 4 passed in 4.20s ============================================================================== ### 33_basic_conv2d <span style="color:green">PASS</span> bash (catlass_py311) root@debian:/xxx/catlass/tests/optest# pytest tests/test_33_basic_conv2d.py -sv ============================================================================ test session starts ============================================================================= platform linux -- Python 3.11.15, pytest-9.1.1, pluggy-1.6.0 -- /root/miniconda3/envs/catlass_py311/bin/python3.11 cachedir: .pytest_cache rootdir: /xxx/catlass/tests/optest configfile: pyproject.toml plugins: anyio-4.14.1 collecting ... Loading kernel libraries... ... Importing ops module collected 2 items tests/test_33_basic_conv2d.py::test_basic_conv2d [W713 21:37:38.130450008 TensorFactories.cpp:340] Warning: Cannot create tensor with interal format while allow_internel_format=False, tensor will be created with base format. (function operator()) PASSED tests/test_33_basic_conv2d.py::test_basic_conv2d_exceeds_cache yes, this is a should-fail case PASSED ============================================================================= 2 passed in 4.03s ============================================================================== ### 56 <span style="color:green">PASS</span> bash root@86c2ca9cbe72:/xxx/catlass.optest/tests/optest# pytest tests/test_56_ascend950_basic_conv2d_tla.py -sv =========================================================================== test session starts =========================================================================== platform linux -- Python 3.12.13, pytest-9.1.1, pluggy-1.6.0 -- /usr/local/python3.12.13/bin/python3 cachedir: .pytest_cache rootdir: /xxx/catlass.optest/tests/optest configfile: pyproject.toml collecting ... Loading kernel libraries... ... Importing ops module collected 2 items tests/test_56_ascend950_basic_conv2d_tla.py::test_ascend950_basic_conv2d_tla [W714 09:55:14.428526844 TensorFactories.cpp:340] Warning: Cannot create tensor with interal format while allow_internel_format=False, tensor will be created with base format. (function operator()) PASSED tests/test_56_ascend950_basic_conv2d_tla.py::test_ascend950_basic_conv2d_tla_exceeds_cache PASSED =========================================================================== 2 passed in 21.97s ============================================================================ ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新: 更新33和56样例的`README.md`(约束补充) - [ ] 其他，请描述： See merge request: cann/catlass!806	1 个月前

BasicConv2d Example Readme

代码组织

├── 33_basic_conv2d
│   ├── CMakeLists.txt   # CMake编译文件
│   ├── README.md
│   └── basic_conv2d.cpp # 主文件

功能介绍

该算子完成2D版本的卷积计算
昇腾亲和的特征图尺寸表达是：(N, C1, H, W, C0)，其中:
- N: 批量Batch大小
- C1: C1 = CeilDiv(C, C0)，其中C为输入特征图的通道数，C0为16
- H: 特征图高度
- W: 特征图宽度
- C0: C0为16
昇腾亲和的卷积核尺寸表达是：(Cin, Kh, Kw, Cout, C0)，其中:
Cin: C1 = CeilDiv(C, C0)
Kh: 卷积核高度
Kw: 卷积核宽度
Cout: 输出通道数
C0: C0为16
需满足以下基础约束：
- 膨胀系数dilations和卷积核计算步幅strides均不能为零
- 卷积核的有效感受野大小不能超过输入特征图的大小，需满足：
  - hi + padTop + padBottom > dilationH * (kh - 1) + 1
  - wi + padLeft + padRight > dilationW * (kw - 1) + 1
  其中hi，wi为输入特征图的高度和宽度，kh, kw为卷积核的高度和宽度，dilationH, dilationW为上述两方向上的膨胀系数，padTop, padBottom, padLeft, padRight为上、下、左、右填充大小。
考虑到空间分配，需满足下述条件（为做区分下述公式中小写的符号为运行时常量，反之是编译期常量）：
- L1_STAGES * FmapSize + L1_STAGES * FilterSize <= L1_SIZE 其中L1_STAGES在开double-buffer的情形下为2，不启用为1，L1_SIZE是512K（AtlasA2/A3），FmapSize和FilterSize的具体计算公式为：
  - FmapSize = Cin1 * hi * wi * C0 * sizeof(ElementFmap), Cin1为FmapL1TileShape下的Tiling常量（输入通道数），hi和wi由FmapL1TileShape下的Ho和Wo（输出特征尺寸）可反推得到，逆运算为：
    1. hi = (Ho - 1) * strideH + dilationH * (kh - 1) + 1
    2. wi = (Wo - 1) * strideW + dilationW * (kw - 1) + 1
  - FilterSize = Cin1 * kh * kw * Cout * C0，Cin1为FilterL1TileShape下的Tiling常量（输入通道数）, Cout是FilterL1TileShape下Cout（输出通道数）对齐到C0后的值
- L0A_STAGES * FmapL0ASize <= L0A_SIZE, 其中FmapL1ASize具体为Ho * Wo * max(L0K, kh * kw * C0) * sizeof(ElementFmap)，L0K为L0TileShape下的Tiling常量, L0A_SIZE等于64K（AtlasA2/A3）
- L0B_STAGES * FilterL0BSize <= L0B_SIZE, 其中FilterL0BSize具体为max(L0K, kh * kw * C0) * CoutL0 * sizeof(ElementFilter)，L0K为L0TileShape下的Tiling常量, CoutL0是L0N对齐到C0的大小，L0B_SIZE也等于64K（AtlasA2/A3）
- Ho * Wo * Cout * sizeof(ElementOut) <= L0C_SIZE, 其中L0C_SIZE等于128K（AtlasA2/A3），Ho, Wo, Cout均为FilterL1TileShape中的Tiling常量。（样例中ElementFmap，ElementFilter和ElementOutput为fp16类型）

使用示例

获取代码之后编译相应的算子可执行文件，可参考quickstart
执行算子

# 编译指定用例
bash scripts/build.sh 33_basic_conv2d
cd ./output/bin
# 可执行文件名 |Batch|Hi|Wi|Cin|Cout|kh|kw|padL|padR|padT|padB|strideH|strideW|dilationH|dilationW|Device ID
# Device ID可选，默认为0
./33_basic_conv2d 2 33 43 112 80 3 3 2 2 2 2 1 1 1 1 0

执行结果如下，表明精度验证通过。

Compare success.