Star1

Star1

cann-robotdocs: add English translations for markdown files

fec4c2a6Add on 5 days agoHistory

Files	Last commit	Last update
docs	docs(ger): clarify BF16 dtype scope Co-authored-by: zhouyuanhang30083383<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7052 merge docs/aclnn-ger-bf16-docs into master docs(ger): clarify BF16 dtype scope Created-by: m0_55003149 Commit-by: zhouyuanhang30083383 Merged-by: cann-robot Description: ## 描述修正 `aclnnGer` 文档中 BF16 数据类型说明的适用范围： - 将 Atlas A3、Atlas A2、Atlas训练系列产品不支持 BFLOAT16 的限制明确限定到 `self`、`vec2`，该限制不适用于 `out`。 - 补充 `out` 的转换语义：接口先按 `self`、`vec2` 推导出的数据类型完成外积计算，再将结果转换为 `out` 指定的数据类型；`out` 无需与推导类型一致，例如 FLOAT 输入可输出 BFLOAT16。 ## 关联的Issue [Fixes #4311](https://gitcode.com/cann/ops-math/issues/4311) ## 测试 ## 文档更新 - `math/ger/docs/aclnnGer.md` - `math/ger/docs/aclnnGer_en.md` ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7052	6 days ago
examples	修改argmin/cumprod等部分算子的aclnn文档 example实例 Co-authored-by: jiangjiawei<jiangjiawei10@huawei.com> # message auto-generated for no-merge-commit merge: !5423 merge aclnn_example_0907 into master 修改argmin/cumprod等部分算子的aclnn文档 example实例 Created-by: jiangjiawei Commit-by: jiangjiawei Merged-by: cann-robot Description: ## 描述修改argmin/cumprod等部分算子的aclnn文档 example实例 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3084 ## 测试文档修改，不涉及 ## 文档更新见PR ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5423	2 months ago
op_api	refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Co-authored-by: cai-chengchao<caichengchao1@h-partners.com> # message auto-generated for no-merge-commit merge: !6542 merge ccc_1020 into master refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Created-by: cai-chengchao Commit-by: cai-chengchao Merged-by: cann-robot Description: ## 描述本 PR 对 math 目录下 13 个算子进行代码风格规范化（代码格式化），不涉及功能性改动。涉及的算子包括：axpy、axpy_v2、bias_add、div、div_no_nan、gcd、ger、muls、select、select_v2、signbit、squared_difference、tanh_grad。 ### 改动原因统一算子代码的编码风格与格式规范，提升代码可读性和可维护性。 ### 改动方法对 C++ 源码、Python 脚本及 CMake 构建文件进行格式化，具体包括： - 统一 License 头注释格式（分隔线长度与换行） - 统一命名空间括号风格（`namespace xxx {` 同行） - 统一 `// namespace xxx` 尾部注释与 `#endif // xxx` 注释格式（单空格） - 移除行尾空格，补全文件末尾换行 - 统一缩进（2 空格 → 4 空格）与函数声明/定义换行 - 统一 Python 脚本 docstring 引号与长语句换行 - 统一 CMakeLists 文件 License 头与文件末尾换行 ## 关联的Issue - #3814 ## 测试本次改动为纯代码格式化，无功能性变更，逻辑行为保持不变。 ## 文档更新无 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码风格规范化（格式化） See merge request: cann/ops-math!6542	18 days ago
op_graph	fix(proto): 修复39个算子proto.h注释的拼写与语法错误 Co-authored-by: sun-yibo1<sunyibo1@hisilicon.com> # message auto-generated for no-merge-commit merge: !5815 merge fix/proto-comment-grammar into master fix(proto): 修复39个算子proto.h注释的拼写与语法错误 Created-by: sun-yibo1 Commit-by: sun-yibo1 Merged-by: cann-robot Description: ## 描述对 39 个算子的 `op_graph/_proto.h` 注释做拼写与语法修复，仅注释与格式变更，不涉及任何代码逻辑： - 拼写错误：select_v2 `condittion`→`condition`（2处）、axpy_v2 `opratioan`→`operation`、clip_by_value 英文 dtype 列表中的全角逗号改半角 - 系统性语法（历史模板复制扩散）：`Support broadcasting`→`Supports broadcasting`（27个文件）、`A ND`→`An ND`（33个文件97处） - 单文件语法修复 71 处（含 signbit `returns`→`Returns`、axpy `should`→`Should` 两处句首大写补漏）*：ger `has`→`have`、addcmul/addcdiv `multiply`→`multiplies`、muls `An required`→`A required`、equal `(x=y)`→`(x1==x2)`、`Elementwise`→`Element-wise`、bias_add/lerp/gcd 语序与冠词修复、`aicore`→`AiCore`、mod/floor_mod 矛盾表述统一、句首大小写与标点空格等 - 附带 pre-commit 钩子强制规范化（clang-format 重排、尾随空白、文件末尾换行），并保留各文件原有行尾风格（CRLF/LF）涉及算子：add/sub/mul/muls/div/real_div/floor_div/div_no_nan/pow/minimum/maximum/signbit/less/less_equal/greater/greater_equal/not_equal/equal/bias_add/squared_difference/lerp/logical_and/logical_or/bitwise_or/bitwise_and/bitwise_xor/tanh_grad/axpy/axpy_v2/addcmul/addcdiv/select/select_v2/mod/floor_mod/ger/gcd/clip_by_value/clip_by_value_v2 ## 关联的Issue - #3234 - https://gitcode.com/cann/ops-math/issues/3234 ## 测试 - 纯注释变更，无功能影响 - pre-commit 钩子全部通过（clang-format / trailing-whitespace / end-of-file-fixer / codespell / OAT 合规检查） - 严格限定在上述 39 个算子文件，全仓其余算子未改动（其余算子同类问题可后续另行清理） ## 文档更新不涉及仓内 docs/ 目录；本 PR 即为 proto.h 注释（算子原型文档源）的修正 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5815	17 days ago
op_host	refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Co-authored-by: cai-chengchao<caichengchao1@h-partners.com> # message auto-generated for no-merge-commit merge: !6542 merge ccc_1020 into master refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Created-by: cai-chengchao Commit-by: cai-chengchao Merged-by: cann-robot Description: ## 描述本 PR 对 math 目录下 13 个算子进行代码风格规范化（代码格式化），不涉及功能性改动。涉及的算子包括：axpy、axpy_v2、bias_add、div、div_no_nan、gcd、ger、muls、select、select_v2、signbit、squared_difference、tanh_grad。 ### 改动原因统一算子代码的编码风格与格式规范，提升代码可读性和可维护性。 ### 改动方法对 C++ 源码、Python 脚本及 CMake 构建文件进行格式化，具体包括： - 统一 License 头注释格式（分隔线长度与换行） - 统一命名空间括号风格（`namespace xxx {` 同行） - 统一 `// namespace xxx` 尾部注释与 `#endif // xxx` 注释格式（单空格） - 移除行尾空格，补全文件末尾换行 - 统一缩进（2 空格 → 4 空格）与函数声明/定义换行 - 统一 Python 脚本 docstring 引号与长语句换行 - 统一 CMakeLists 文件 License 头与文件末尾换行 ## 关联的Issue - #3814 ## 测试本次改动为纯代码格式化，无功能性变更，逻辑行为保持不变。 ## 文档更新无 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码风格规范化（格式化） See merge request: cann/ops-math!6542	18 days ago
op_kernel	refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Co-authored-by: cai-chengchao<caichengchao1@h-partners.com> # message auto-generated for no-merge-commit merge: !6542 merge ccc_1020 into master refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Created-by: cai-chengchao Commit-by: cai-chengchao Merged-by: cann-robot Description: ## 描述本 PR 对 math 目录下 13 个算子进行代码风格规范化（代码格式化），不涉及功能性改动。涉及的算子包括：axpy、axpy_v2、bias_add、div、div_no_nan、gcd、ger、muls、select、select_v2、signbit、squared_difference、tanh_grad。 ### 改动原因统一算子代码的编码风格与格式规范，提升代码可读性和可维护性。 ### 改动方法对 C++ 源码、Python 脚本及 CMake 构建文件进行格式化，具体包括： - 统一 License 头注释格式（分隔线长度与换行） - 统一命名空间括号风格（`namespace xxx {` 同行） - 统一 `// namespace xxx` 尾部注释与 `#endif // xxx` 注释格式（单空格） - 移除行尾空格，补全文件末尾换行 - 统一缩进（2 空格 → 4 空格）与函数声明/定义换行 - 统一 Python 脚本 docstring 引号与长语句换行 - 统一 CMakeLists 文件 License 头与文件末尾换行 ## 关联的Issue - #3814 ## 测试本次改动为纯代码格式化，无功能性变更，逻辑行为保持不变。 ## 文档更新无 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码风格规范化（格式化） See merge request: cann/ops-math!6542	18 days ago
tests	refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Co-authored-by: cai-chengchao<caichengchao1@h-partners.com> # message auto-generated for no-merge-commit merge: !6542 merge ccc_1020 into master refactor: 统一 math 目录 13 个算子的代码风格与格式规范 Created-by: cai-chengchao Commit-by: cai-chengchao Merged-by: cann-robot Description: ## 描述本 PR 对 math 目录下 13 个算子进行代码风格规范化（代码格式化），不涉及功能性改动。涉及的算子包括：axpy、axpy_v2、bias_add、div、div_no_nan、gcd、ger、muls、select、select_v2、signbit、squared_difference、tanh_grad。 ### 改动原因统一算子代码的编码风格与格式规范，提升代码可读性和可维护性。 ### 改动方法对 C++ 源码、Python 脚本及 CMake 构建文件进行格式化，具体包括： - 统一 License 头注释格式（分隔线长度与换行） - 统一命名空间括号风格（`namespace xxx {` 同行） - 统一 `// namespace xxx` 尾部注释与 `#endif // xxx` 注释格式（单空格） - 移除行尾空格，补全文件末尾换行 - 统一缩进（2 空格 → 4 空格）与函数声明/定义换行 - 统一 Python 脚本 docstring 引号与长语句换行 - 统一 CMakeLists 文件 License 头与文件末尾换行 ## 关联的Issue - #3814 ## 测试本次改动为纯代码格式化，无功能性变更，逻辑行为保持不变。 ## 文档更新无 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码风格规范化（格式化） See merge request: cann/ops-math!6542	18 days ago
CMakeLists.txt	feat(ascend960): 39个算子使能ascend960 Co-authored-by: hahaha22<wangrunze20@h-partners.com> # message auto-generated for no-merge-commit merge: !6137 merge feat/ascend960-enable into master feat(ascend960): 39个算子使能ascend960 Created-by: hahaha22 Commit-by: hahaha22 Merged-by: cann-robot Description: ## 描述为 ascend960 新增芯片形态适配算子，覆盖 math 与 conversion 目录下共 39 个算子，无 kernel 代码改动，复用现有 arch35 kernel 与 tiling。 ### 改动原因 ascend960 为新增芯片形态，现有算子需补齐平台注册、编译单元与二进制配置后，才能在新平台上被算子信息库发现、编译并选择正确的 kernel 二进制。 ### 改动方法 1. 算子信息库注册（`_def.cpp`）：新增 ascend960 平台注册（`AICore().AddConfig`） 2. 编译配置（`CMakeLists.txt`）：在 `SUPPORT_COMPUTE_UNIT` / `COMPUTE_UNITS` 中追加 ascend960，并在 `SUPPORT_TILING_DIR` 中追加对应的 `arch35`（tiling 目录沿用 arch35）；Add / ClipByValue / ClipByValueV2 的编译选项并入既有 `add_kernel_sources` 块（选项与 ascend950 / ascend350 既有块一致） 3. 二进制配置：为每个算子新增 ascend960 二进制配置目录，包含 `<op>_binary.json` 与 `<op>_simplified_key.ini`，内容沿用 ascend950 既有配置 4. 中央注册表（`scripts/kernel/binary_config/ascendc_config.json`）：33 个既有条目补齐 ascend960 编译选项，Mod 条目同步补齐（平台注册与编译单元主线已就绪） 5. 注册口径*：Signbit / Add / Ger / Gcd / BitwiseXor 不在中央注册表新增 ascend960 条目（Add 编译选项已迁移至 CMake 管理，其余沿主线现状，主线 ascend950 亦无对应条目） ### 算子清单（共 39 个） - math 目录 36 个：Add、Sub、Mul、Muls、Div、DivNoNan、RealDiv、FloorDiv、FloorMod、BitwiseAnd、BitwiseOr、BitwiseXor、Equal、NotEqual、Less、LessEqual、Greater、GreaterEqual、LogicalAnd、LogicalOr、Select、SelectV2、Maximum、Minimum、Pow、Lerp、BiasAdd、Axpy、AxpyV2、Addcmul、Addcdiv、Ger、Gcd、Signbit、TanhGrad、SquaredDifference、Mod - conversion 目录 2 个：ClipByValue、ClipByValueV2 ## 关联的Issue - https://gitcode.com/cann/ops-math/issues/3597 ## 测试 - pre-commit 全部 hook 通过（clang-format / OAT / codespell 等） - CI compile 门禁通过（18 个 Compile Job） - ascend960 内核编译与上板验证待具备 ascend960 环境后执行，合入前补充 ## 文档更新无（仅平台适配，不改变算子功能与约束，不涉及 README 更新） ## 类型标签 - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6137	25 days ago
README.md	docs(math): 修正Ger README占位描述与实际交付不一致 Co-authored-by: hahaha22<wangrunze20@h-partners.com> # message auto-generated for no-merge-commit merge: !6779 merge docs/ger-readme into master docs(math): 修正Ger README占位描述与实际交付不一致 Created-by: hahaha22 Commit-by: hahaha22 Merged-by: cann-robot Description: ## 描述 `math/ger/README.md`为占位空壳，全文仅"本目录仅包含Ger算子对应的aclnn接口"一句，与仓库事实矛盾：同目录`op_kernel/`已有AscendC实现（入口`ger_apt.cpp`），`op_host/ger_def.cpp`亦注册了`opFile.value`指向该kernel入口，同目录还有接口文档`docs/aclnnGer.md`与样例`examples/test_aclnn_ger.cpp`，而`docs/zh/op_list.md`索引直达该占位页。本PR删除占位句，按算子README模板补齐四个必选章节： - 产品支持情况：与`docs/aclnnGer.md`产品支持口径一致 - 功能说明：算子功能（一维向量外积）与计算公式 - 参数说明：参数表与`op_host/ger_def.cpp`定义一致（x1/x2/y，BFLOAT16、FLOAT16、FLOAT，ND）；分平台数据类型差异说明就近置于参数表下方：Atlas A3/A2/训练系列产品不支持BFLOAT16，与`op_api/aclnn_ger.cpp`平台数据类型门控一致 - 约束说明：无（接口层约束见接口文档，不在README重复维护） - 调用说明：aclnn API样例`examples/test_aclnn_ger.cpp`、接口文档与算子IR（`op_graph/ger_proto.h`）链接 ## 关联的Issue Closes #3719（拆分自#3691的13条"README声称仅接口但op_kernel已有实现"硬矛盾项之一） ## 测试 - 纯文档修改，无代码与功能变更，无需上板验证 - 相对链接逐项核验存在（docs/aclnnGer.md、examples/test_aclnn_ger.cpp、op_graph/ger_proto.h） - 参数表与`op_host/ger_def.cpp`注册规格逐项一致；分平台数据类型差异说明与`op_api/aclnn_ger.cpp`平台数据类型门控（RegBase分支）逐项一致；产品支持表与`docs/aclnnGer.md`口径一致 - pre-commit全部钩子通过（trailing-whitespace / end-of-file-fixer / codespell / OAT合规） - 按仓库wiki《算子README文档模板》质检清单自检通过（必选章节、markdownlint、中英文标点空格、数据类型顿号分隔、产品名精确匹配、敏感词） ## 文档更新 math/ger/README.md（单文件单提交） ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6779	11 days ago
README_en.md	docs: add English translations for markdown files Co-authored-by: jenny_xiang<jenny.xiang@huawei.com> # message auto-generated for no-merge-commit merge: !7113 merge docs/add-english-translations into master docs: add English translations for markdown files Created-by: jenny_xiang Commit-by: jenny_xiang Merged-by: cann-robot Description: ## 描述新增仓库Markdown文档英文译稿（第二批，共409个文件）：第一批（已合入）之外的其余全部译稿，覆盖conversion、examples、ge、math、random各类算子README译稿，以及CHANGELOG_en.md、.gitcode PR模板英文版等。本批内全部仓内链接均指向master已有文件（含第一批已合入的21+2篇译稿），合入后本仓432篇英文文档全部就位，链接完整生效。本批同时包含4篇基于最新源文档的增量更新（math/ada_cast、math/prod_force_se_a、math/sinkhorn、math/xlogy，对应上游近期文档变更）。 ## 关联的Issue 无 ## 测试文档类变更，无需算子测试；已通过链接有效性校验（本批全部相对链接仅指向master已有文件，无指向本PR外未提交文件的链接），并完成逐篇翻译规范自查与语义校对（含支持状态表、限定词、术语、数值符号核对）。 ## 文档更新新增409个英文译稿文件（*_en.md / .en-US.md），不修改任何现有文件。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7113	5 days ago

Ger

English | 简体中文

Product Support Status

Product	Supported
Ascend 950PR&950DT products	√
Atlas A3 products	√
Atlas A2 products	√
Atlas 200I/500 A2 inference products	×
Atlas inference products	×
Atlas training products	√

Function Description

Operator function: computes the outer product of the one-dimensional vectors x1 and x2 to obtain a two-dimensional matrix.
Computation formula: $x_1^T \times x_2$

Parameter Description

Parameter Name	Input/Output/Attribute	Description	Data Type	Data Format
x1	Input	Input vector x1 in the formula, the first vector of the outer product computation.	BFLOAT16, FLOAT16, FLOAT	ND
x2	Input	Input vector x2 in the formula, the second vector of the outer product computation.	BFLOAT16, FLOAT16, FLOAT	ND
y	Output	Output tensor y in the formula, the result of the outer product computation. Its shape is {x1.shape[0], x2.shape[0]}.	BFLOAT16, FLOAT16, FLOAT	ND

Atlas A3 products, Atlas A2 products, and Atlas training products: The BFLOAT16 data type is not supported.

Constraint Description

None

Invocation Description

Invocation Method	Invocation Sample	Description
aclnn API	test_aclnn_ger	Invokes the Ger operator through the aclnnGer API.
GE graph mode	-	Invokes the Ger operator by building a graph through the operator IR.