Star0

Star0

cann-robotdocs(math): XLogY家族aclnn接口文档对齐算子实现

ad40a86fAdd on 9 days agoHistory

Files	Last commit	Last update
docs	master翻译合入 Co-authored-by: caiwenwen<caiwenwen6@h-partners.com> # message auto-generated for no-merge-commit merge: !6751 merge master into master master翻译合入 Created-by: caiwenwen Commit-by: caiwenwen Merged-by: cann-robot Description: ## 描述合入math仓翻译的内容 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/4170 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 docs/context，aclnn等商发文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6751	17 days ago
examples	refactor: 迁移 arch35 算子 Reg API、修正拼写并规范化日志文案 Co-authored-by: esok11<yangsifa@huawei.com> # message auto-generated for no-merge-commit merge: !5135 merge f082601 into master refactor: 迁移 arch35 算子 Reg API、修正拼写并规范化日志文案 Created-by: esok11 Commit-by: esok11 Merged-by: cann-robot Description: ## 描述对 arch35 架构下多个算子进行 AscendC Reg API 迁移、命名拼写修正及日志文案规范化，共 46 个文件，涉及 conversion/ 与 math/ 下 15 个算子。主要改动： - AscendC Reg API 迁移（arch35 kernel 代码，21 个 .h 文件）： - 地址空间修饰符：`__local_mem__` → `__ubuf__` - Reg 数据搬运 API 细化：加载用 `AscendC::Reg::LoadAlign`（原 `Reg::DataCopy` 加载语义），存储用 `AscendC::Reg::StoreAlign`（原 `Reg::DataCopy` 存储语义） - 掩码操作 API 重命名：`AscendC::Reg::MaskNot` → `AscendC::Reg::Not`、`AscendC::Reg::MaskAnd` → `AscendC::Reg::And` - 移除冗余 `using AscendC::Reg::DataCopy;` 声明 - 命名拼写修正（op_host/arch35，3 个文件）： - 方法名 `TilingForReleatedTranspose` → `TilingForRelatedTranspose`（Releated→Related） - 成员变量 `isReleatedTranspsoe_` → `isRelatedTranspose_`（Releated→Related, Transpsoe→Transpose） - 同步修改 confusion_transpose_d、depth_to_space 中对该方法的调用 - 日志清理（examples、op_host、op_api，22 个文件）： - 失败路径日志级别 `INFO` → `ERROR`（Initialize ge failed、Run graph failed、Finalize ir graph session failed 等） - 文案语法修正：`only support` → `only supports`、`is: %s and %s` → `are: %s and %s`、`expect %f` → `expected %f`、`multiples's` → `multiples'` - tile 示例代码宏定义缩进格式化 ### 改动原因配合 AscendC Reg API 演进，将 arch35 算子迁移至新的地址空间修饰符与 LoadAlign/StoreAlign/Not/And API；修正 transpose 相关命名中的拼写错误；统一日志级别与文案规范，提升日志可读性与问题定位效率。 ### 改动方法 - kernel 侧：逐文件替换 `__local_mem__`→`__ubuf__`、`Reg::DataCopy`（加载）→`Reg::LoadAlign`、`Reg::DataCopy`（存储）→`Reg::StoreAlign`、`Reg::MaskNot`→`Reg::Not`、`Reg::MaskAnd`→`Reg::And`，不改变控制流。 - host 侧：重命名 `TilingForReleatedTranspose`→`TilingForRelatedTranspose`、`isReleatedTranspsoe_`→`isRelatedTranspose_`，同步所有调用点。 - 日志：修改 printf/OP_LOGE/OP_LOGW/OP_LOGI 文案与级别字符串，不改变校验逻辑。 ## 关联的Issue - #2916 ## 测试本 PR 为 API 迁移、命名修正与日志清理，通过已有测试用例（含 arch35 tiling UT 与 examples 二级冒烟）回归验证。 ## 文档更新本 PR 未包含文档更新。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [x] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述：AscendC Reg API 迁移 + 命名拼写修正 + 日志规范化 See merge request: cann/ops-math!5135	2 months ago
op_api	docs(math): XLogY家族aclnn接口文档对齐算子实现 Co-authored-by: chenyifeng<chenyifeng27@h-partners.com> # message auto-generated for no-merge-commit merge: !7057 merge fix_MD_1031 into master docs(math): XLogY家族aclnn接口文档对齐算子实现 Created-by: chen_0715 Commit-by: chenyifeng Merged-by: cann-robot Description: ## 修改内容对齐 XLogY 家族及关联算子 aclnn 接口文档与算子实现，均为文档/注释修复，不涉及实现逻辑改动： 1. XLogY 家族三份文档（aclnnXLogYScalarSelf / aclnnXLogYScalarOther / aclnnXLogYTensor，中英文）： - 功能说明补全 xlogy 标准分段语义公式（self == 0 且 other != NaN 时输出 0） - 删除标量参数上错误的「支持非连续 Tensor」声明 - 按产品双白名单拆行 dtype 支持列表（910 系列无 BFLOAT16，A2/A3/950 系列含 BFLOAT16） - 161002 错误码表补全维度超过 8 的 rank 子项 - 补全 other / out 的 DOUBLE 类型支持声明 2. aclnnScale 文档：x / y 参数维度列 0-8 修正为 1-8（rank=0 时 axis 取值区间为空集，0 维输入一律返回 161002） 3. aclnn_sinc 头文件：功能描述 sin 修正为 sinc，非原地接口参数名 selfRef 修正为与签名一致的 self，dtype 注释与实现白名单对齐 4. aclnnAtanh 中英文文档：计算公式补 0.5 系数，与标准数学定义及 kernel 实现一致 ## 解决的 Issue - #4239 aclnnXLogYTensor 功能说明缺 self==0->0 特判 - #4240 aclnnInplaceSinc 头文件注释 dtype 声明错误 - #4241 Atanh 文档公式缺 0.5 系数 - #4242 aclnnXLogYScalarOther 功能说明缺 self==0 -> 0 特判 - #4243 aclnnXLogYScalarOther 的 other / out 数据类型支持面漏 DOUBLE - #4244 aclnnXLogYScalarOther 的 other 是 aclScalar，参数表却写「支持非连续的Tensor」 - #4295 aclnnScale 维度列声明与实现不符 - #4297 aclnnXLogYScalarSelf 资料 5 项缺陷 ## 变更文件共 11 个文件（中英文文档及头文件注释），变更均为文档文本，无算子实现代码改动。 See merge request: cann/ops-math!7057	9 days ago
op_graph	add sinc Co-authored-by: t00850857<tanxin44@huawei.com> # message auto-generated for no-merge-commit merge: !2866 merge master-sinc-1 into master add sinc Created-by: tan_xin Commit-by: t00850857 Merged-by: cann-robot Description: ## 描述 sinc新增A5实现 ## 关联的Issue https://gitcode.com/cann/ops-nn/issues/2808 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!2866	5 months ago
op_host	fix: E9**内部错误码整改为正式语义码并保留内部异常EZ9999上报 Co-authored-by: chenyifeng<chenyifeng27@h-partners.com> # message auto-generated for no-merge-commit merge: !6606 merge fix_errorNum_1021 into master fix: E9***内部错误码整改为正式语义码并保留内部异常EZ9999上报 Created-by: chen_0715 Commit-by: chenyifeng Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次 PR 整改以下 43 个算子中非法使用的内部错误码（E9***），使其符合错误码使用规范： - cholesky / complex / cross / cummax / cummin / cumprod / get_shape / histogram_v2 / is_finite / is_inf - kl_div_v2 / lin_space / log_add_exp / non_finite_check / pdist / polar / pows / radix_top_k - reduce_log_sum / reduce_log_sum_exp / reduce_max / reduce_mean / reduce_mean_with_count / reduce_min - reduce_nansum / reduce_std_with_mean / rfft1_d / search_sorted / signbit / sin / sinc / sinkhorn / topk - affine_grid / amp_update_scale / angle_v2 / arg_max_v2 / arg_min / arg_min_with_value / atan2 / bessel_i1e / cdist_grad - conversion/tril 改动原因：上述算子 op_host / op_api / op_graph 源码中存在裸 OP_LOGE （EZ9999 兜底上报）、 OP_CHECK_NULL_WITH_CONTEXT / OP_CHECK_NOTNULL （EZ9999 上报）等不符合错误码使用规范的上报路径，需按失败原因分类整改为正式语义码或内部透传。采取的方法： - op_host 参数/输入校验类（shape / dtype / format / attr 值域等）裸 OP_LOGE → 正式语义宏（EZ0004 / EZ0008–EZ0038） - op_host 内部 API 失败类（平台能力查询、tiling API 失败等）→ OP_LOGE_WITHOUT_REPORT 透传，去掉 EZ9999 上报、保留日志 - OP_CHECK_NULL_WITH_CONTEXT （EZ9999）→ 显式空指针检查 + 正式码宏 - op_api OP_CHECK_NOTNULL （EZ9999）→ 显式检查 + OP_LOGE_WITHOUT_REPORT(ACLNN_ERR_INNER_NULLPTR) + 返回公共错误码 - op_api OP_LOGE(ACLNN_ERR_INNER_ / RUNTIME_ERROR) （561xxx / 361xxx）→ OP_LOGE_WITHOUT_REPORT ；正式参数码 ACLNN_ERR_PARAM_* （161xxx）保留 - 删除 CREATE_EXECUTOR 之后不可达的空指针死检查（ CHECK_RET(executor.get()!=nullptr, ACLNN_ERR_INNER_CREATE_EXECUTOR) ，40 处） - op_graph（histogram_v2 / reduce_mean 融合 pass）E9 上报 → 正式码或透传 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/3977 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> - 43 算子 op_host / op_api / op_graph 全量编译通过，exit 0（910b + 950/arch35） - 本地增加ut测试130 用例全量通过（910b 83 + 950 47），日志级验证触发 78 次正式 EZ 错误码上报，覆盖 14 个正式错误码 - 原版 math_op_host_ut 300 用例全量通过，无回归 - 静态复扫：范围内 E9*** 正式上报清零（残留均为 CHECK_RET 返回公共码 / 动态 return 等允许项） - 附：适配 CANN 9.3.0 atvoss 库 tiling key 编码变化，更新 reduce_max / reduce_mean_with_count 测试的 9 处 expectedTilingKey （官方 master 在 9.3.0 下同样失败，非本 PR 引入） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6606	18 days ago
op_kernel	fix: sinc 算子支持 subnormal 输入处理 Co-authored-by: tan_xin<tanxin44@huawei.com> # message auto-generated for no-merge-commit merge: !6625 merge master-sinc into master fix: sinc 算子支持 subnormal 输入处理 Created-by: tan_xin Commit-by: tan_xin Merged-by: cann-robot Description: ## 描述 sinc 算子在 Ascend 950PR 系列产品（arch35）的 SIMT kernel（SincSimtCompute）中，原实现对输入 `x[i] == 0.0f` 才输出 1。当 `\|x\| < 2^-126/π` 时，`PI*x` 会下溢为 float32 次正规数（0 或 subnormal），SIMT 除法按 0 处理会产生 NaN，导致输出错误。本 PR 在 `math/sinc/op_kernel/arch35/sinc_dag.h` 中新增次正规数阈值 `SINC_X_THRESHOLD = 3.741714929575447e-39f`（即 `2^-126/π`），将判零条件由 `x[i] == 0.0f` 改为 `fabsf(x[i]) < SINC_X_THRESHOLD`：当 `\|x\| < 2^-126/π` 时 `sinc(x)` 在 float32 精度下精确等于 1，直接输出 1，避免 NaN。同时引入 `simt_api/math_functions.h` 与 `simt_api/asc_simt.h` 以提供 `fabsf`。用单次 abs 比较实现，性能开销最小。 ## 关联的Issue - #4096 ## 测试变更未包含新增自动化测试用例（`tests/` 目录无 subnormal 相关用例），需通过算子泛化/二级冒烟验证 subnormal 输入场景。 ## 文档更新无文档变更。 ## 类型标签 - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6625	18 days ago
tests	sinc等算子冗余workspace改为分配0 Co-authored-by: ly_cann_coder<liyao152@huawei.com> # message auto-generated for no-merge-commit merge: !6261 merge workspace into master sinc等算子冗余workspace改为分配0 Created-by: ly_cann_coder Commit-by: ly_cann_coder Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> sinc等算子冗余workspace改为分配0 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/3611 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码整改 See merge request: cann/ops-math!6261	29 days ago
CMakeLists.txt	feat: 新增 ascend960pr/ascend960dt 平台算子适配（14 个算子） Co-authored-by: esok11<yangsifa@huawei.com> # message auto-generated for no-merge-commit merge: !6157 merge f1008 into master feat: 新增 ascend960pr/ascend960dt 平台算子适配（14 个算子） Created-by: esok11 Commit-by: esok11 Merged-by: cann-robot Description: ## 描述为 ascend960pr / ascend960dt 两个新增芯片形态适配算子，覆盖 conversion 与 math 目录下共 14 个算子；同时修正 addr 的 dtype 支持列表判断逻辑，并对个别文件做版权头/格式整理。 ### 改动原因 ascend960pr / ascend960dt 为新增芯片形态，现有算子需补齐平台注册、编译单元与二进制配置后，才能在新平台上被算子信息库发现、编译并选择正确的 kernel 二进制。 ### 改动方法 1. 算子信息库注册（`_def.cpp`）：新增 `this->AICore().AddConfig("ascend960pr", ...)` 与 `AddConfig("ascend960dt", ...)` - conversion：assign、dynamic_partition、masked_fill、mem_set、tensor_move、tril、triu - math：addr、asin、eye、mod、sinc、truncate_div、truncate_mod 2. 编译配置（`CMakeLists.txt`）：在 `SUPPORT_COMPUTE_UNIT` / `COMPUTE_UNIT` 中追加 `ascend960pr`、`ascend960dt`，并在 `SUPPORT_TILING_DIR` / `TILING_DIR` 中追加对应的 `arch35`（tiling 目录沿用 arch35） 3. 二进制配置：为每个算子新增 `op_host/config/ascend960pr/` 与 `op_host/config/ascend960dt/` 目录，包含 `<op>_binary.json` 与 `<op>_simplified_key.ini` 4. addr dtype 判断修正（`math/addr/op_api/aclnn_addr.cpp`）：`GetDtypeSupportList()` 的判断由区间判断 `>= ASCEND910B && <= ASCEND910E` 改为显式判断 `== ASCEND910B \|\| == ASCEND910_93 \|\| IsRegBase()`，使 reg-base 平台复用 910B dtype 支持列表 5. 格式整理*：`conversion/mem_set_v2/op_host/mem_set_v2_def.cpp`、`math/adds/op_host/adds_def.cpp`、`math/adds/CMakeLists.txt` 仅做版权头/空行/行尾换行等整理 ## 关联的Issue - https://gitcode.com/cann/ops-math/issues/3440 ## 测试本 PR 未包含测试代码改动；适配涉及算子信息库、编译配置与二进制配置，需在 ascend960pr / ascend960dt 平台补充二级冒烟与算子泛化验证。 ## 文档更新无。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6157	1 month ago
README.md	产品名变更 Co-authored-by: gitcode-chenjiao<chenjiao31@huawei.com> # message auto-generated for no-merge-commit merge: !5912 merge master into master 产品名变更 Created-by: gitcode-chenjiao Commit-by: gitcode-chenjiao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> AI处理器对应的产品型号名称更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [#3258](https://gitcode.com/cann/ops-math/issues/3258) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ok ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> *.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5912	1 month 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	9 days ago

Sinc

English | 简体中文

Product Support Status

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

Function Description

Operator function: performs the sinc computation on the input Tensor.
Computation formula:
$outi={1,selfi=0sin⁡(π∗selfi)/(π∗selfi),otherwiseout_i = \begin{cases} 1,\quad self_i = 0\\ \sin(\pi*self_i)/(\pi*self_i),\quad otherwise\\ \end{cases}$

Parameter Description

Parameter Name	Input/Output/Attribute	Description	Data Type	Data Format
x	Input	The input tensor x in the formula.	FLOAT, BFLOAT16, FLOAT16	ND
y	Output	The output tensor y in the formula.	FLOAT, BFLOAT16, FLOAT16	ND

Constraint Description

The input and output must have the same shape and type.

Invocation Description

Invocation Method	Invocation Sample	Description
aclnn invocation	test_aclnn_sinc	Invokes the Sinc operator through the aclnnSinc&aclnnInplaceSinc API.
Graph-mode invocation	test_geir_sinc	Invokes the Sinc operator by building a graph through the operator IR.