| 修复 ops-nn torch 接口文档扫描问题(67处) Co-authored-by: liujing987913<liujing407@h-partners.com> # message auto-generated for no-merge-commit merge: !14426 merge docs/torch-api-list-1113 into master 修复 ops-nn torch 接口文档扫描问题(67处) Created-by: liujing987913 Commit-by: liujing987913 Merged-by: cann-robot Description: ## 描述 - 背景:AIDD/文档质量扫描发现 ops-nn 仓 torch 接口文档问题 67 处 - 修改分类:表头括号全角化、标点(括号全角/引导句补冒号/句末补句号/并列顿号/断句/引号)、术语单位(末轴→尾轴、32B→32字节、K→k、quant mode→quant_mode)、漏字补字、错别字、默认值补冒号 - 涉及文件:docs/zh/torch_api_list.md + 21 个 torchapi 算子文档(共 22 个文件) - 验证:git diff 确认为纯文本修改,无代码内容误改;已人工核对预览格式正常 ## 关联的Issue https://gitcode.com/cann/ops-nn/issues/8790 ## 测试 ## 文档更新 本次 PR 更新 ops-nn torch 接口文档 22 个文件,修正标点/术语/单位/错别字/表头格式问题 67 处,详见 diff。示例代码内的标点问题按规则未处理(已转人工确认)。 ## 类型标签 - 文档更新 See merge request: cann/ops-nn!14426 | 7 days ago |
| 修复codecheck问题 Co-authored-by: demoauguste<zhanghao418@huawei.com> # message auto-generated for no-merge-commit merge: !10024 merge master into master 修复codecheck问题 Created-by: demoauguste Commit-by: demoauguste Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 该 PR 主要针对 dequant_situ_quant 与 situ_mx_quant 算子的 host/tiling/kernel 代码修复 codecheck(静态检查)问题,核心手段包括:将魔法数字替换为具名 constexpr 常量或 sizeof 表达式、修正对外接口 aclnnSituMxQuantGetWorkspaceSize 的 const 修饰并移除冗余 const_cast、清理未使用的 include 与 using namespace、修正日志格式说明符等;此外按 PR 描述更新了 aclnnSituMxQuant.md 文档中的示例代码,并同步为示例/单测补充了 ACLNN_ERR_PARAM_INVALID 错误码的兜底定义。 主要改动 修正 aclnnSituMxQuantGetWorkspaceSize 接口签名: 在 aclnn_situ_mx_quant.h 与 aclnn_situ_mx_quant.cpp 中,将输出参数 yOut、yScaleOut 由 const aclTensor* 改为 aclTensor*,并删除实现中的 const_cast 转换,使接口 const 语义正确。 魔法数字替换为具名常量/枚举: dequant_situ_quant_def.cpp 将 beta/linear_beta 默认值提取为 DEFAULT_BETA、DEFAULT_LINEAR_BETA;situ_mx_quant_def.cpp 将 dst_type 的魔法值 40 替换为 ge::DT_FLOAT4_E2M1;dequant_situ_quant_tiling.cpp 用 sizeof(int8_t) 等及新增的 BYTES_DEQUANT_BIAS_PER_ELEM、BYTES_QUANT_SCALE_DYNAMIC、BYTES_QUANT_SCALE_STATIC 等常量替代硬编码字节数。 替换 kernel 与 tiling 中的硬编码数值: dequant_situ_quant.h 中 Duplicate、BinaryRepeatParams、WholeReduceMax 调用的 8 分别改为 BLOCK_ELEM、MASK_BLK_STRIDE;dequant_situ_quant_tiling.cpp 中 ubMinBlockLen、cacheLineLen 改为由 ALIGN_UINT_IN_CACHE_32B、PACK_UINT_IN_CACHE_512B 与 inputDTypeLen 推导。 清理头文件与类型/格式问题: 移除 dequant_situ_quant_tiling.h 中未使用的 using namespace Ops::NN::Optiling;、situ_mx_quant_tiling_arch35.h 中未使用的 <vector> include,并为 situ_mx_quant_tiling_data.h 补充 <cstdint>;situ_mx_quant_tiling_arch35.cpp 中 tilingKey 改为 uint64_t 且日志格式符由 %ld 修正为 %lu,TilingPrepare4SituMxQuant 未使用参数改为注释形式 /*context*/。 示例与文档同步: test_aclnn_situ_mx_quant.cpp 在公共头不可见 aclnn 错误码枚举时补充 ACLNN_ERR_PARAM_INVALID(错误码 161002)的兜底宏定义;按 PR 描述更新 aclnnSituMxQuant.md 示例代码以修复其问题。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。例如:关联Issue #000--> https://gitcode.com/cann/ops-nn/issues/5658 ## 测试 <!--描述进行了哪些测试来验证你的改动。--> ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> 更新了aclnnSituMxQuant.md,修复示例代码问题。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他,请描述:修复代码codecheck问题 ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [ ] AI辅助编写 See merge request: cann/ops-nn!10024 | 2 months ago |
| DequantSituQuant和SituMxQuant算子实现及torch extension适配 Co-authored-by: demoauguste<zhanghao418@huawei.com> # message auto-generated for no-merge-commit merge: !8798 merge master into master DequantSituQuant和SituMxQuant算子实现及torch extension适配 Created-by: demoauguste Commit-by: demoauguste Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 实现DequantSituQuant和SituMxQuant算子,并适配torch extension接口。 torch接口评审:https://gitcode.com/cann/ops-nn/issues/4749 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。例如:关联Issue #000--> https://gitcode.com/cann/ops-nn/issues/4850 ## 测试 <!--描述进行了哪些测试来验证你的改动。--> 自测试结果如下:  ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [ ] AI辅助编写 See merge request: cann/ops-nn!8798 | 3 months ago |
| feat: SwiGluQuant 等 7 算子补充 ascend960dt 平台注册适配 Co-authored-by: wychencc_<wangyuchen53@huawei.com> # message auto-generated for no-merge-commit merge: !12748 merge 960DT into master feat: SwiGluQuant 等 7 算子补充 ascend960dt 平台注册适配 Created-by: wychencc_ Commit-by: wychencc_ Merged-by: cann-robot Description: ## 描述 为 7 个算子补充 ascend960dt(Ascend960DT,NpuArch DAV_9201)平台注册适配,复用 ascend950 同族 regbase kernel/tiling,按 950 已登记面同步登记: - SwiGluQuant / SituGlu / SituGluGrad / SituMxQuant / GroupNorm / SwigluGroupQuantWithDualAxis / SwigluBackwardGroupQuantWithDualAxis:def.cpp 紧随 ascend950 追加 AddConfig("ascend960dt"),复用同一 config 对象 - SwiGluQuant / SituGlu / SituGluGrad / SituMxQuant / GroupNorm:ascend950 binary json 原样拷贝至 op_host/config/ascend960dt(逐字节一致;Swiglu 双轴两算子 950 侧无 per-SoC json,按规跳过) - SwiGluQuant:scripts/kernel/binary_config/ascendc_config.json compute_units 紧随 ascend950 登记 ascend960dt - SituGlu / SituGluGrad:tiling IsCapable 复用公共 IsRegbaseSocVersion 支持 DAV_9201(960dt 无独立 SocVersion 枚举) - 相关 CMakeLists SUPPORT_COMPUTE_UNIT 追加 ascend960dt、SUPPORT_TILING_DIR 补位同值 arch35、op_kernel COMPUTE_UNITS 同步 op_api 复核:GroupNorm 与 aclnnBinaryCrossEntropyWithLogits 均走公共 IsRegbase()(common/inc/op_api/aclnn_util.h 集合已含 DAV_9201/9202),无需新增芯片判断;其余算子无平台门控。 ## 关联的Issue 关联 Issue #7214 ## 测试 - 5 个拷贝的 binary json 与 ascend950 版哈希校验一致 - ascendc_config.json 修改后 JSON 解析校验通过(704 条目) - 待 CI:Linux 环境 build.sh --soc=ascend960dt 出包冒烟、全量 UT ## 文档更新 无(960dt 文档条目待 npu 标签码值统一定义后另行批量补齐) ## 类型标签 - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 - [x] AI辅助编写 See merge request: cann/ops-nn!12748 | 15 days ago |
| feat: SwiGluQuant 等 7 算子补充 ascend960dt 平台注册适配 Co-authored-by: wychencc_<wangyuchen53@huawei.com> # message auto-generated for no-merge-commit merge: !12748 merge 960DT into master feat: SwiGluQuant 等 7 算子补充 ascend960dt 平台注册适配 Created-by: wychencc_ Commit-by: wychencc_ Merged-by: cann-robot Description: ## 描述 为 7 个算子补充 ascend960dt(Ascend960DT,NpuArch DAV_9201)平台注册适配,复用 ascend950 同族 regbase kernel/tiling,按 950 已登记面同步登记: - SwiGluQuant / SituGlu / SituGluGrad / SituMxQuant / GroupNorm / SwigluGroupQuantWithDualAxis / SwigluBackwardGroupQuantWithDualAxis:def.cpp 紧随 ascend950 追加 AddConfig("ascend960dt"),复用同一 config 对象 - SwiGluQuant / SituGlu / SituGluGrad / SituMxQuant / GroupNorm:ascend950 binary json 原样拷贝至 op_host/config/ascend960dt(逐字节一致;Swiglu 双轴两算子 950 侧无 per-SoC json,按规跳过) - SwiGluQuant:scripts/kernel/binary_config/ascendc_config.json compute_units 紧随 ascend950 登记 ascend960dt - SituGlu / SituGluGrad:tiling IsCapable 复用公共 IsRegbaseSocVersion 支持 DAV_9201(960dt 无独立 SocVersion 枚举) - 相关 CMakeLists SUPPORT_COMPUTE_UNIT 追加 ascend960dt、SUPPORT_TILING_DIR 补位同值 arch35、op_kernel COMPUTE_UNITS 同步 op_api 复核:GroupNorm 与 aclnnBinaryCrossEntropyWithLogits 均走公共 IsRegbase()(common/inc/op_api/aclnn_util.h 集合已含 DAV_9201/9202),无需新增芯片判断;其余算子无平台门控。 ## 关联的Issue 关联 Issue #7214 ## 测试 - 5 个拷贝的 binary json 与 ascend950 版哈希校验一致 - ascendc_config.json 修改后 JSON 解析校验通过(704 条目) - 待 CI:Linux 环境 build.sh --soc=ascend960dt 出包冒烟、全量 UT ## 文档更新 无(960dt 文档条目待 npu 标签码值统一定义后另行批量补齐) ## 类型标签 - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 - [x] AI辅助编写 See merge request: cann/ops-nn!12748 | 15 days ago |
| test(quant): 补齐 DequantSituQuant 与 SituMxQuant 的 ST 测试(ATK) Co-authored-by: demoauguste<zhanghao418@huawei.com> # message auto-generated for no-merge-commit merge: !14275 merge master into master test(quant): 补齐 DequantSituQuant 与 SituMxQuant 的 ST 测试(ATK) Created-by: demoauguste Commit-by: demoauguste Merged-by: cann-robot Description: # PR 信息 > 对应提交:959dc5b71 test(quant): 补齐 DequantSituQuant 与 SituMxQuant 的 ST 测试(ATK) > 变更规模:4 个文件、+53541 行(两个算子各 1 个 ATK 用例集 + 1 个执行器) ## 描述 为 quant/dequant_situ_quant(aclnnDequantSituQuant)与 quant/situ_mx_quant(aclnnSituMxQuant)两个算子补齐 ST 测试资产。此前两个算子的 tests/ 下只有 ut/,缺少 st/,无法覆盖 aclnn 接口与 kernel 的端到端精度验证。 **改动原因**:两个算子均为融合类量化算子(Dequant+Situ+Quant / Situ+MX Quant),接口分支多、精度边界敏感(量化取整、E8M0 scale、MX 32 元素块、group_index 尾行、多核尾块等),需要通过 ST 用例在真实设备上做接口级精度回归。 **改动方法**:严格按仓内已有 ATK ST 样例(quant/dequant_swiglu_quant/tests/st/aclnnDequantSwigluQuantV2/)的目录与文件结构交付——**每个算子仅 tests/st/aclnn<Op>/ 下 2 个文件**(atk_aclnn<Op>.json 用例集 + executor_aclnn<Op>.py 执行器),不新增 README/辅助模块等额外交付件。 ### 1. DequantSituQuant(Atlas A2/A3) quant/dequant_situ_quant/tests/st/aclnnDequantSituQuant/ - atk_aclnnDequantSituQuant.json:200 条 ATK 用例(7 字段结构,与 quant 样例一致),覆盖: - 4 条 dtype 路径:INT8 / INT32 / BF16 / FP16(含各自的必选/禁用参数组合); - INT8 rank 2–8、静态/动态量化、quant_scale 标量/向量(smooth)、bias 有/无、quant_offset 有/无; - INT32 group_index 分组(含死尾行)、activation_scale 按行;BF16/FP16 预反量化; - 形状覆盖 H 1~65537(含列分块两趟阈值以上、多核行切分)、M 1~161280。 - executor_aclnnDequantSituQuant.py: - @register("ascend_method_dequant_situ_quant"):CPU golden + NPU cann_ops_nn 通道; - @register("aclnn_dequant_situ_quant"):PyAclnn 直通 aclnn C-API 通道(可选输入空指针处理); - CPU golden 与 kernel 严格对齐:fp32 → int32(TRUNC) → fp16(ROUND) → int8(TRUNC) 三段式取整、INT8 static 不写 y_scale、dynamic 全零行 scale=0、group_index 尾行置 0。 ### 2. SituMxQuant(Ascend 950/960dt) quant/situ_mx_quant/tests/st/aclnnSituMxQuant/ - atk_aclnnSituMxQuant.json:200 条 ATK 用例,覆盖: - x: FP16/BF16,rank 1–5,末维偶数(H = x[-1]/2 ∈ {1,2,4,…,256,257,384,512},含 32/64 对齐与尾块); - dstType 35(E5M2)/36(E4M3FN) 各 100 条;beta(1e-6~1e6)、linearBeta(0/0.001/1/25)、activateLeft 两态; - 输入取值覆盖全零、极小值(scale 0x00/下溢)、常规范围与饱和边界。 - executor_aclnnSituMxQuant.py: - @register("ascend_method_situ_mx_quant"):CPU golden + NPU cann_ops_nn.situ_mx_quant; - @register("aclnn_situ_mx_quant"):PyAclnn 直通通道; - CPU golden 内联实现(situ → 回写输入精度 T → 32 元素块 OCP MX → E8M0 编码),与 kernel 对齐:允许负指数(e = E - emax,scale byte = clip(127+e,0,254))、全零块 0x00、inf/NaN 块 0xFF+整块 NaN、饱和 448/57344、yScale [..., ceil(H/64), 2] 及 pad 槽 0x00。 **说明**:ATK 通道沿用仓内既有惯例(如 quant/dequant_swiglu_quant),不在 scripts/ci/ops_st_test.sh 的自动扫描范围内,需在对应设备上手动执行;SituMxQuant 的 FP4(40/41) 能力仅在 kernel/graph 层提供,aclnn 接口未暴露,故本 ATK 用例集覆盖 FP8(35/36) 路径。 ## 关联的Issue https://gitcode.com/cann/ops-nn/issues/8657 ## 测试 均使用 **ATK 26.9.24**,以 CPU golden 为基准,在真实设备上执行 node --backend npu + node --backend cpu task --task accuracy。 ### 1. DequantSituQuant(Atlas A2 910B3,CANN 9.2.1) 结果:**Total Task: 200, success 200, failed 0;200/200 精度通过,acc_pass_result=Pass**(覆盖 INT8/INT32/BF16/FP16 四路径)。 ### 2. SituMxQuant(Ascend 950PR,CANN 9.2.0) 结果:**Total Task: 200, success 200, failed 0;200/200 精度通过,acc_pass_result=Pass**(y 与 E8M0 scale 均为逐字节一致)。 ### 其他检查 - 两个算子均可通过 build.sh --pkg --soc=... 正常编译出算子包; - ATK 用例集 JSON 结构与 quant/dequant_swiglu_quant 样例逐字段一致(顶层 7 字段、inputs 9 字段); - 未改动算子源码 / CMake / UT / CI。 ## 文档更新 无(按仓内 ST 目录惯例未新增 README 等文档;算子接口文档本身未变更)。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他,请描述:**新增 DequantSituQuant / SituMxQuant 的 ST 测试用例与执行器(ATK 通道)** ## AI/Agent生成声明 - [x] AI辅助编写 See merge request: cann/ops-nn!14275 | 9 days ago |
| fix: 修复codecheck问题(编码声明/const/空行/参数名) Co-authored-by: luoyufan7<luoyufan7@h-partners.com> # message auto-generated for no-merge-commit merge: !10051 merge fix/codecheck-issues into master fix: 修复codecheck问题(编码声明/const/空行/参数名) Created-by: luoyufan7 Commit-by: luoyufan7 Merged-by: cann-robot Description: ## 描述 修复 codecheck 问题,涉及 13 个文件: 1. 10 个 Python 文件添加 # coding=utf-8 编码声明(clipped_swiglu、clipped_swiglu_grad、situ_mx_quant、dequant_situ_quant) 2. aclnn_prelu_backward.cpp 参数名 workspaceSize 改为 workspace_size(与头文件一致) 3. hard_swish_grad_v2_tiling_arch35.cpp 两处函数参数加 const 并使用 auto 推导 4. swiglu_group_quant_hifp8_tiling.cpp 删除多余空行 ## 关联的Issue Closes #5676 ## 测试 ## 文档更新 无 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他,请描述:代码规范修复 ## AI/Agent生成声明 - [x] AI辅助编写 See merge request: cann/ops-nn!10051 | 2 months ago |
| DequantSituQuant和SituMxQuant算子实现及torch extension适配 Co-authored-by: demoauguste<zhanghao418@huawei.com> # message auto-generated for no-merge-commit merge: !8798 merge master into master DequantSituQuant和SituMxQuant算子实现及torch extension适配 Created-by: demoauguste Commit-by: demoauguste Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 实现DequantSituQuant和SituMxQuant算子,并适配torch extension接口。 torch接口评审:https://gitcode.com/cann/ops-nn/issues/4749 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。例如:关联Issue #000--> https://gitcode.com/cann/ops-nn/issues/4850 ## 测试 <!--描述进行了哪些测试来验证你的改动。--> 自测试结果如下:  ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [ ] AI辅助编写 See merge request: cann/ops-nn!8798 | 3 months ago |
| 修改产品名 Co-authored-by: fwx1169505<fengying27@h-partners.com> # message auto-generated for no-merge-commit merge: !11017 merge master into master 修改产品名 Created-by: fengying555682 Commit-by: fwx1169505 Merged-by: cann-robot Description: ## 描述 修改quant和activation文件夹中的md文档涉及的产品名称 ## 关联的Issue [#6056](https://gitcode.com/cann/ops-nn/issues/6056) ## 测试 已经完成文档语法和链接一致性检测 ## 文档更新 quant和activation文件夹中的md文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [ ] AI辅助编写 See merge request: cann/ops-nn!11017 | 1 month ago |
| docs: add English translations for operator READMEs and repo docs Co-authored-by: jenny_xiang<jenny.xiang@huawei.com> # message auto-generated for no-merge-commit merge: !13351 merge docs/add-english-docs into master docs: add English translations for operator READMEs and repo docs Created-by: jenny_xiang Commit-by: jenny_xiang Merged-by: cann-robot Description: ## Description Add English translations for 652 markdown documents: - Repo-level guides: README_en.md, CONTRIBUTING_en.md, SECURITY_en.md, CHANGELOG_en.md, codearts_check_rule_config_en.md - Operator READMEs under activation/, conv/, control/, foreach/, hash/, index/, loss/, matmul/, norm/, optim/, pooling/, quant/, rnn/, vfusion/, etc. - API and design docs under docs/ (aclnn_*, ascendir_*, fusion pass docs) - examples/ and torch_extension/ guides Note: a few cross-reference links whose English targets are not published yet temporarily point to their Chinese counterparts to keep links valid; they will be switched back to the English docs in a follow-up PR after this one is merged. ## Related Issue N/A ## Test - Verified all 1,344 intra-repo markdown links in the added files resolve against master: 0 broken links, 0 missing targets. ## Documentation Update - This PR only adds English documentation files (*_en.md); no existing Chinese documents are modified. ## Type Labels - [ ] Bug fix - [ ] New feature - [ ] Performance optimization - [x] Documentation update - [ ] Other, please describe: ## AI/Agent-Generated Declaration - [x] AI-assisted authoring See merge request: cann/ops-nn!13351 | 17 days ago |