| Files | Last commit | Last update |
|---|---|---|
refactor: 为公共op_api头文件增加math后缀 Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !5839 merge refactor/math-prefix-common-headers into master refactor: 为公共op_api头文件增加math后缀 Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述 ops-math/common/inc/op_api 中的 level2_base.h、level2_base_caculation.h、op_api_def.h 名称缺少仓库标识。在软件包合并交付或公共 include 目录集成时，存在被其他仓库同名文件覆盖，或因 include 路径顺序产生误引用的风险。 本 MR 参考同目录已有的 op_resource_math.h 命名，为三个公共头文件增加 _math 后缀，并通过兼容转发头分阶段迁移现有引用。 ## 修改内容 - 新增 level2_base_math.h、level2_base_caculation_math.h、op_api_def_math.h，作为带仓库标识的正式实现； - 原 level2_base.h、level2_base_caculation.h、op_api_def.h 保留为轻量兼容转发头，避免未迁移代码立即失效； - 新头文件之间的内部依赖统一使用 _math 后缀路径； - 更新 classify_rule.yaml，让 level2_base_math.h 继承原组件及 UT 覆盖率分类； - 将 89 处旧头文件引用迁移到新名称： - level2_base.h：20 处； - level2_base_caculation.h：9 处； - op_api_def.h：60 处； - 当前 MR 共修改 81 个文件，新增 434 行、删除 384 行。 为减少无关格式变化和后续合并冲突，本次未迁移会触发额外 clang-format、尾部空白或 EOF 修复，或组合触发既有 UT 隔离问题的文件。这些文件将拆分到后续 MR 逐步处理。 ## 剩余迁移 当前仓内仍有 67 处旧引用，分布在 65 个唯一文件中，继续通过兼容转发头工作： - level2_base.h：24 个文件； - level2_base_caculation.h：2 个文件； - op_api_def.h：41 个文件。 待旧引用分批迁移完成后，再结合实际打包和安装规则移除兼容转发头。本 MR 不移除旧头文件，也不声明已完成最终软件包去重。 ## 关联的 Issue 关联并在合入后关闭 #3243： https://gitcode.com/cann/ops-math/issues/3243 ## 测试 已完成： - 对本轮新增的 69 个纯引用替换文件逐行检查，80 组增删均仅修改目标 include，无其他代码或格式变化； - 额外纳入 aclnn_log10.cpp 和 aclnn_logdet.cpp，每个文件最终均为 3 行新增、3 行删除，低于 10 行修改阈值；math/sin/op_api/aclnn_sin.cpp 因聚合 UT 存在平台状态泄漏暂缓迁移； - 在 CANN 9.0.0 容器执行完整 pre-commit，尾部空白、EOF、clang-format、codespell 和 OAT 等检查全部通过； - 在 CANN 9.0.0 容器执行 bash build.sh --opapi -j32，全量构建通过； - 成功生成 build/libopapi_math.so，SHA-256：abaa8f8408979d931a8dad09f8e06875722fc42bbdddc72aaf9f14944bc163ea； - classify_rule.yaml 可正常解析，三个旧文件继续作为兼容转发头使用。 ## 文档更新 不涉及用户文档变更。 ## 类型标签 - [ ] Bug 修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他：代码重构 See merge request: cann/ops-math!5839 | 1 month ago | |
docs: 订正 bitwise_not、cholesky、cummin、topk 等 8 个算子资料及头文件注释 Co-authored-by: Nice_try<zhangzhiwei108@huawei.com> # message auto-generated for no-merge-commit merge: !6781 merge sync-1028 into master docs: 订正 bitwise_not、cholesky、cummin、topk 等 8 个算子资料及头文件注释 Created-by: Nice_try Commit-by: Nice_try Merged-by: cann-robot Description: ## 描述 本 PR 订正 8 个算子资料与头文件注释中与实现、产品支持情况不一致的描述。改动全部为文档（zh/en）与头文件注释，不涉及代码逻辑。 ### 改动原因 资料与头文件注释存在与实现、错误码表或产品支持情况互相矛盾的描述：dtype 列表漏项、产品支持范围与参数表结论不一致、参数语义描述错误、公式求和区间端点错误、退化点取值未声明等，逐条见「关联的Issue」。 ### 改动方法 1. **bitwise_not**（ docs/aclnnBitwiseNot.md、aclnnBitwiseNot_en.md）：self、out 补充数据类型支持描述，与资料及实现对齐（#3950）。 2. **bitwise_or**（docs/aclnnBitwiseOrScalar&aclnnInplaceBitwiseOrScalar.md、_en.md）：self、other、selfRef补充数据类型支持描述，消除与产品支持情况分组的矛盾（#3995）。 3. **cdist_grad**（docs/aclnnCdistBackward.md、_en.md）：新增说明——上述闭式仅在 cdist > 0 时适用；当 cdist = 0（x1 与 x2 在该点对上完全重合）时，该点对对 x1 的梯度贡献按 0 处理（#3956）。 4. **cholesky**（docs/aclnnLinalgCholesky.md、_en.md）：产品支持情况中 Ascend 950PR&950DT 系列产品由「不支持」改为「支持」；self、out 的数据类型由「FLOAT、BFLOAT16」补充为「FLOAT、FLOAT16、BFLOAT16」（#3957）。 5. **cummin**（docs/aclnnCummin.md、_en.md）：self、valuesOut 的 dtype 约束由统一规则改为「具体数据类型关系见下方产品支持情况」，并在产品支持情况新增两条分组说明——Ascend 950PR&950DT 系列产品下 self 为 INT8/UINT8/BOOL 时 valuesOut 可为不同的可转换数据类型，其余数据类型需与 self 一致；Atlas A3/A2、Atlas 200I/500 A2、Atlas 推理、Atlas 训练系列产品下 self 的数据类型需能转换为 valuesOut 的数据类型（#3969）。 6. **grouped_bias_add_grad**（docs/aclnnGroupedBiasAddGrad.md、_en.md）：groupIdx 求和区间上端点由 groupIdxOptional(j) 改为不含端点的 groupIdxOptional(j)-1，j=0 分支同步改为 groupIdxOptional(0)-1；无可选输入时求和区间由 0 至 C 改为 0 至 C-1；文字说明中明确 groupIdxOptional(j) 表示第 j 组的结束位置（不包含）（#3948）。 7. **pow**（op_api/aclnn_pow.h 头文件注释）：out 的数据类型要求由「数据类型、数据格式和shape与self一致」改为「数据格式和shape需与self一致，数据类型需为self与exponent推导后可转换的数据类型」（#3959）。 8. **topk、topkV2**（docs/aclnnTopk.md、aclnnTopk_en.md、aclnnTopkV2.md、aclnnTopkV2_en.md 共 4 个文件）：largest 由「计算维度上的结果排序方式」改为「选取最大还是最小的 k 个值」；sorted 删除「当前该参数仅支持取 True」，改为 False 表示不要求输出有序，并明确不保证输出顺序及等值元素的索引稳定性（#3971）。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3995 https://gitcode.com/cann/ops-math/issues/3971 https://gitcode.com/cann/ops-math/issues/3969 https://gitcode.com/cann/ops-math/issues/3959 https://gitcode.com/cann/ops-math/issues/3957 https://gitcode.com/cann/ops-math/issues/3956 https://gitcode.com/cann/ops-math/issues/3950 https://gitcode.com/cann/ops-math/issues/3948 ## 测试 - 本 PR 仅修改资料与头文件注释，不涉及代码逻辑，未做代码测试； - 资料改动需通过仓库资料门禁/评审校验。 ## 文档更新 - math/bitwise_not/docs/aclnnBitwiseNot.md、aclnnBitwiseNot_en.md - math/bitwise_or/docs/aclnnBitwiseOrScalar&aclnnInplaceBitwiseOrScalar.md、aclnnBitwiseOrScalar&aclnnInplaceBitwiseOrScalar_en.md - math/cdist_grad/docs/aclnnCdistBackward.md、aclnnCdistBackward_en.md - math/cholesky/docs/aclnnLinalgCholesky.md、aclnnLinalgCholesky_en.md - math/cummin/docs/aclnnCummin.md、aclnnCummin_en.md - math/grouped_bias_add_grad/docs/aclnnGroupedBiasAddGrad.md、aclnnGroupedBiasAddGrad_en.md - math/topk/docs/aclnnTopk.md、aclnnTopk_en.md、aclnnTopkV2.md、aclnnTopkV2_en.md - 头文件注释：math/bitwise_not/op_api/aclnn_bitwise_not.h、math/pow/op_api/aclnn_pow.h ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6781 | 12 days ago |
| Files | Last commit | Last update |
|---|---|---|
| 1 month ago | ||
| 12 days ago |