| 补充 SparseApplyAdagrad kernel 调用示例 Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !11939 merge sparse-apply-adagrad-1012 into master 补充 SparseApplyAdagrad kernel 调用示例 Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 SparseApplyAdagrad 缺少可通过仓库构建脚本运行的 kernel 调用示例。参考 SparseApplyAdagradV2 和 SparseApplyRMSProp 的 GE 图模式示例,新增 optim/sparse_apply_adagrad/examples/test_geir_sparse_apply_adagrad.cpp。 示例构造 var、accum、lr、grad、indices 五个输入,设置 use_locking=false,分别执行 update_slots=true/false。使用唯一索引 {1, 3},按算子公式计算 CPU 期望值,校验 var、accum 两个输出的 shape、dtype 和数值,包括未被索引命中的行。 沿用现有 build.sh --run_example 的自动发现机制,安装算子包后可执行: bash bash build.sh --run_example sparse_apply_adagrad graph --soc=ascend950 输入节点通过 GE OperatorFactory 创建 Data,避免依赖部分新 SDK 不再提供的 array_ops.h。 ## 关联的Issue Issue [#6772](https://gitcode.com/cann/ops-nn/issues/6772) ## 测试 - clang-format 18.1.8 dry-run/Werror、OAT 增量检查及 git diff --check 通过。 - 此前已在 Ascend 910B3、CANN 9.1.0-beta.1 环境验证原示例,两个 update_slots 分支通过。 - 当前示例在 Ascend 950PR 宿主机、5 号卡、CANN 9.1.0-beta.1 环境完成验证。 - 执行 bash build.sh --pkg --ops=sparse_apply_adagrad --soc=ascend950 -j16,定向编译及算子包构建成功;将生成的自定义包安装到独立目录,通过 ASCEND_CUSTOM_OPP_PATH 加载。 - 执行 bash build.sh --run_example sparse_apply_adagrad graph --soc=ascend950,示例编译及上板运行通过,退出码为 0;update_slots=true/false 的 var、accum 输出及未更新行均与 CPU 期望值一致。 - strace 文件访问记录确认加载了自定义包的 host 库,并编译了包内 arch35/sparse_apply_adagrad_arch35.cpp,覆盖当前仓库的 950 kernel 实现。 - CANN 9.2.0-beta.2 额外完成算子包构建及示例编译;上述上板数值验证基于 9.1.0-beta.1。 ## 文档更新 更新 SparseApplyAdagrad README 的图模式调用示例链接,并补充调用说明入口和运行命令;产品名称统一为 Atlas A3系列产品、Atlas A2系列产品。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他,请描述:补充已有算子的 kernel 调用示例。 ## AI/Agent生成声明 - [x] AI辅助编写 See merge request: cann/ops-nn!11939 | 1 month ago |
| add sparse_apply_adagrad operator Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !10131 merge migrate-sparse-adagrad into master add sparse_apply_adagrad operator Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 从 canndev 迁入 SparseApplyAdagrad 算子(TF SparseApplyAdagrad),仅支持 ascend950,基于 MicroAPI + TPipe 实现。 ### 计算语义 对每个 grad 行 grad[i] 与对应 indices[i](仅 0 <= idx < var.shape[0] 生效): g2 = grad[i] * grad[i] if update_slots: accum[idx] = accum[idx] + g2 var[idx] = var[idx] - lr * grad[i] / (sqrt(accum[idx]) + 1e-8) // epsilon 硬编码 float32 1e-8 ### 变更内容 - 新增 optim/sparse_apply_adagrad/(24 文件,+2816 行): - op_def / op_graph proto / infershape / TF 插件 - tiling:op_host/arch35/sparse_apply_adagrad_tiling_arch35.cpp - 4 套 kernel:optimize / optimize_split_r / small / big,由 tiling 按 use_locking 与 UB 容量选择 - tiling data / tiling key(10000/10001/10002/10010) - infershape + tiling host UT、golden.py、README ## 关联的Issue Issue #5708 ## 测试 - 容器内(CANN 9.1.0-beta.1)编译并运行 host UT: - Infershape:5/5 通过 - Tiling:5/5 通过(optimize_split_r / optimize / small / big 四条路径 + update_slots/use_locking 属性透传) ## 文档更新 新增 sparse_apply_adagrad README.md文件 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!10131 | 1 month ago |
| add sparse_apply_adagrad operator Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !10131 merge migrate-sparse-adagrad into master add sparse_apply_adagrad operator Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 从 canndev 迁入 SparseApplyAdagrad 算子(TF SparseApplyAdagrad),仅支持 ascend950,基于 MicroAPI + TPipe 实现。 ### 计算语义 对每个 grad 行 grad[i] 与对应 indices[i](仅 0 <= idx < var.shape[0] 生效): g2 = grad[i] * grad[i] if update_slots: accum[idx] = accum[idx] + g2 var[idx] = var[idx] - lr * grad[i] / (sqrt(accum[idx]) + 1e-8) // epsilon 硬编码 float32 1e-8 ### 变更内容 - 新增 optim/sparse_apply_adagrad/(24 文件,+2816 行): - op_def / op_graph proto / infershape / TF 插件 - tiling:op_host/arch35/sparse_apply_adagrad_tiling_arch35.cpp - 4 套 kernel:optimize / optimize_split_r / small / big,由 tiling 按 use_locking 与 UB 容量选择 - tiling data / tiling key(10000/10001/10002/10010) - infershape + tiling host UT、golden.py、README ## 关联的Issue Issue #5708 ## 测试 - 容器内(CANN 9.1.0-beta.1)编译并运行 host UT: - Infershape:5/5 通过 - Tiling:5/5 通过(optimize_split_r / optimize / small / big 四条路径 + update_slots/use_locking 属性透传) ## 文档更新 新增 sparse_apply_adagrad README.md文件 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!10131 | 1 month ago |
| feat: sparse_apply_adagrad 新增 ascend960dt 平台支持 Co-authored-by: wangrunfa<wangrunfa1@huawei.com> # message auto-generated for no-merge-commit merge: !13413 merge master into master feat: sparse_apply_adagrad 新增 ascend960dt 平台支持 Created-by: miaojingjing Commit-by: wangrunfa Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 为 sparse_apply_adagrad 新增 ascend960dt 平台支持,同时保留现有 ascend950 支持。具体变更如下: 1. 在 add_all_modules_sources 中将计算单元扩展为 ascend950 ascend960dt,并将 Tiling 目录对应配置为 arch35 arch35。 2. 在 add_kernel_sources 中将 COMPUTE_UNITS 扩展为 ascend950 ascend960dt,两个平台共用 arch35/sparse_apply_adagrad_arch35.cpp,保持 AUTO_SYNC false 及相同编译配置。 3. 在算子定义中新增 this->AICore().AddConfig("ascend960dt", aicoreConfig),与 ascend950 复用同一份 aicoreConfig;DynamicCompileStaticFlag(true)、DynamicFormatFlag(false)、DynamicRankSupportFlag(true)、DynamicShapeSupportFlag(true)、NeedCheckSupportFlag(false) 和 opInterface.value=sparse_apply_adagrad 均保持不变。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。例如:关联Issue #000--> - #8221 ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - pre-commit run --files optim/sparse_apply_adagrad/CMakeLists.txt optim/sparse_apply_adagrad/op_host/sparse_apply_adagrad_def.cpp 通过。 - 推送时 pre-push 检查通过;门禁将本次变更识别为配置/CMake 修改,按策略跳过构建与 UT,未执行上板测试。 ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> 无文档更新。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!13413 | 16 days ago |
| add sparse_apply_adagrad operator Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !10131 merge migrate-sparse-adagrad into master add sparse_apply_adagrad operator Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 从 canndev 迁入 SparseApplyAdagrad 算子(TF SparseApplyAdagrad),仅支持 ascend950,基于 MicroAPI + TPipe 实现。 ### 计算语义 对每个 grad 行 grad[i] 与对应 indices[i](仅 0 <= idx < var.shape[0] 生效): g2 = grad[i] * grad[i] if update_slots: accum[idx] = accum[idx] + g2 var[idx] = var[idx] - lr * grad[i] / (sqrt(accum[idx]) + 1e-8) // epsilon 硬编码 float32 1e-8 ### 变更内容 - 新增 optim/sparse_apply_adagrad/(24 文件,+2816 行): - op_def / op_graph proto / infershape / TF 插件 - tiling:op_host/arch35/sparse_apply_adagrad_tiling_arch35.cpp - 4 套 kernel:optimize / optimize_split_r / small / big,由 tiling 按 use_locking 与 UB 容量选择 - tiling data / tiling key(10000/10001/10002/10010) - infershape + tiling host UT、golden.py、README ## 关联的Issue Issue #5708 ## 测试 - 容器内(CANN 9.1.0-beta.1)编译并运行 host UT: - Infershape:5/5 通过 - Tiling:5/5 通过(optimize_split_r / optimize / small / big 四条路径 + update_slots/use_locking 属性透传) ## 文档更新 新增 sparse_apply_adagrad README.md文件 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!10131 | 1 month ago |
| add sparse_apply_adagrad operator Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !10131 merge migrate-sparse-adagrad into master add sparse_apply_adagrad operator Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 从 canndev 迁入 SparseApplyAdagrad 算子(TF SparseApplyAdagrad),仅支持 ascend950,基于 MicroAPI + TPipe 实现。 ### 计算语义 对每个 grad 行 grad[i] 与对应 indices[i](仅 0 <= idx < var.shape[0] 生效): g2 = grad[i] * grad[i] if update_slots: accum[idx] = accum[idx] + g2 var[idx] = var[idx] - lr * grad[i] / (sqrt(accum[idx]) + 1e-8) // epsilon 硬编码 float32 1e-8 ### 变更内容 - 新增 optim/sparse_apply_adagrad/(24 文件,+2816 行): - op_def / op_graph proto / infershape / TF 插件 - tiling:op_host/arch35/sparse_apply_adagrad_tiling_arch35.cpp - 4 套 kernel:optimize / optimize_split_r / small / big,由 tiling 按 use_locking 与 UB 容量选择 - tiling data / tiling key(10000/10001/10002/10010) - infershape + tiling host UT、golden.py、README ## 关联的Issue Issue #5708 ## 测试 - 容器内(CANN 9.1.0-beta.1)编译并运行 host UT: - Infershape:5/5 通过 - Tiling:5/5 通过(optimize_split_r / optimize / small / big 四条路径 + update_slots/use_locking 属性透传) ## 文档更新 新增 sparse_apply_adagrad README.md文件 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!10131 | 1 month ago |
| feat: sparse_apply_adagrad 新增 ascend960dt 平台支持 Co-authored-by: wangrunfa<wangrunfa1@huawei.com> # message auto-generated for no-merge-commit merge: !13413 merge master into master feat: sparse_apply_adagrad 新增 ascend960dt 平台支持 Created-by: miaojingjing Commit-by: wangrunfa Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 为 sparse_apply_adagrad 新增 ascend960dt 平台支持,同时保留现有 ascend950 支持。具体变更如下: 1. 在 add_all_modules_sources 中将计算单元扩展为 ascend950 ascend960dt,并将 Tiling 目录对应配置为 arch35 arch35。 2. 在 add_kernel_sources 中将 COMPUTE_UNITS 扩展为 ascend950 ascend960dt,两个平台共用 arch35/sparse_apply_adagrad_arch35.cpp,保持 AUTO_SYNC false 及相同编译配置。 3. 在算子定义中新增 this->AICore().AddConfig("ascend960dt", aicoreConfig),与 ascend950 复用同一份 aicoreConfig;DynamicCompileStaticFlag(true)、DynamicFormatFlag(false)、DynamicRankSupportFlag(true)、DynamicShapeSupportFlag(true)、NeedCheckSupportFlag(false) 和 opInterface.value=sparse_apply_adagrad 均保持不变。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。例如:关联Issue #000--> - #8221 ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - pre-commit run --files optim/sparse_apply_adagrad/CMakeLists.txt optim/sparse_apply_adagrad/op_host/sparse_apply_adagrad_def.cpp 通过。 - 推送时 pre-push 检查通过;门禁将本次变更识别为配置/CMake 修改,按策略跳过构建与 UT,未执行上板测试。 ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> 无文档更新。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!13413 | 16 days ago |
| 补充 SparseApplyAdagrad kernel 调用示例 Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !11939 merge sparse-apply-adagrad-1012 into master 补充 SparseApplyAdagrad kernel 调用示例 Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 SparseApplyAdagrad 缺少可通过仓库构建脚本运行的 kernel 调用示例。参考 SparseApplyAdagradV2 和 SparseApplyRMSProp 的 GE 图模式示例,新增 optim/sparse_apply_adagrad/examples/test_geir_sparse_apply_adagrad.cpp。 示例构造 var、accum、lr、grad、indices 五个输入,设置 use_locking=false,分别执行 update_slots=true/false。使用唯一索引 {1, 3},按算子公式计算 CPU 期望值,校验 var、accum 两个输出的 shape、dtype 和数值,包括未被索引命中的行。 沿用现有 build.sh --run_example 的自动发现机制,安装算子包后可执行: bash bash build.sh --run_example sparse_apply_adagrad graph --soc=ascend950 输入节点通过 GE OperatorFactory 创建 Data,避免依赖部分新 SDK 不再提供的 array_ops.h。 ## 关联的Issue Issue [#6772](https://gitcode.com/cann/ops-nn/issues/6772) ## 测试 - clang-format 18.1.8 dry-run/Werror、OAT 增量检查及 git diff --check 通过。 - 此前已在 Ascend 910B3、CANN 9.1.0-beta.1 环境验证原示例,两个 update_slots 分支通过。 - 当前示例在 Ascend 950PR 宿主机、5 号卡、CANN 9.1.0-beta.1 环境完成验证。 - 执行 bash build.sh --pkg --ops=sparse_apply_adagrad --soc=ascend950 -j16,定向编译及算子包构建成功;将生成的自定义包安装到独立目录,通过 ASCEND_CUSTOM_OPP_PATH 加载。 - 执行 bash build.sh --run_example sparse_apply_adagrad graph --soc=ascend950,示例编译及上板运行通过,退出码为 0;update_slots=true/false 的 var、accum 输出及未更新行均与 CPU 期望值一致。 - strace 文件访问记录确认加载了自定义包的 host 库,并编译了包内 arch35/sparse_apply_adagrad_arch35.cpp,覆盖当前仓库的 950 kernel 实现。 - CANN 9.2.0-beta.2 额外完成算子包构建及示例编译;上述上板数值验证基于 9.1.0-beta.1。 ## 文档更新 更新 SparseApplyAdagrad README 的图模式调用示例链接,并补充调用说明入口和运行命令;产品名称统一为 Atlas A3系列产品、Atlas A2系列产品。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他,请描述:补充已有算子的 kernel 调用示例。 ## AI/Agent生成声明 - [x] AI辅助编写 See merge request: cann/ops-nn!11939 | 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 | 18 days ago |