| Files | Last commit | Last update |
|---|---|---|
根据markdownlint规范修正md写作问题和link失效 Co-authored-by: gitcode-chenjiao<chenjiao31@huawei.com> # message auto-generated for no-merge-commit merge: !6398 merge master into master 根据markdownlint规范修正md写作问题和link失效 Created-by: gitcode-chenjiao Commit-by: gitcode-chenjiao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 根据markdownlint规范修正md写作问题和link失效 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单,请在这里描述问题单单号。--> [#2272](https://gitcode.com/cann/ops-math/issues/2272) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ok ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> 所有md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: See merge request: cann/ops-math!6398 | 1 month ago | |
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 | 24 days ago | |
docs(std_mean_correction): aclnnStdMeanCorrection 接口文档补充(N≤correction 行为、参数维度/取值与错误码)说明 Co-authored-by: JasonZhang88<jason.zhangshen@huawei.com> # message auto-generated for no-merge-commit merge: !7015 merge fix/changwei_jiaoyiming-33 into master docs(std_mean_correction): aclnnStdMeanCorrection 接口文档补充(N≤correction 行为、参数维度/取值与错误码)说明 Created-by: JasonZhang88 Commit-by: JasonZhang88 Merged-by: cann-robot Description: ## 描述 本 PR 在同一接口文档 math/reduce_std_with_mean/docs/aclnnStdMeanCorrection.md 上分两笔补全声明,两笔均为 **docs-only(零代码变化)**:不触碰 op_host/op_api/op_kernel/op_graph/cmake/common 任何业务代码,运行行为零变化。 **第一笔:N≤correction 除零行为声明(约束说明节 +1 行)** > 当N≤correction(即公式分母max(0, N-correction)为0,包含correction>N与correction=N两种场景)时,接口不报错并返回成功,stdOut输出+Inf或NaN(一般输入为+Inf,全等输入为0×Inf=NaN),meanOut正常输出。 口径与算子 README 既有声明(math/reduce_std_with_mean/README.md「N<=correction(invert=false)输出 +Inf 或 NaN(一般输入为 +Inf,全等输入为 0×Inf=NaN)」)逐要素一致;排布遵循仓内同构先例(math/acosh/docs/aclnnAcosh&aclnnInplaceAcosh.md 约束说明节「确定性计算」条目后的单行值域行为声明)。 **第二笔:参数表维度/取值声明与错误码语义说明(+11/-6)** 1. 参数表 self、stdOut、meanOut 维度列由"-"填为 **0-8**(该组张量实测支持 0-8 维,超过 8 维报 161002;排布同 math/abs/docs/aclnnAbs.md 参数表维度列惯例); 2. correction 行使用说明补取值声明:**非负整数**(0=总体标准差、1=样本标准差,Bessel 校正因子),并指向约束说明节既有 N≤correction 声明; 3. 错误码表 161002 补「数据维度超过 8 维」触发行;表后补 dtype 不支持(如 DT_BOOL)时接口返回 161002 的语义说明(错误日志中的内部错误码经包装不直接对外暴露、随 CANN 版本与运行环境而异,以接口返回值为准)。 ## 关联的Issue Fixes #4412 Fixes #4428 ## 测试 docs-only 改动按引用替代验证(不重建): - **业务路径空 diff**:git diff <base>..HEAD --stat -- op_host op_api op_kernel op_graph cmake common 输出为空(两笔提交后复核一致);改动文件在构建输入清单(compile_commands.json)、算子 CMakeLists、CPack 安装 payload 三处零引用——文档不参与构建/打包/安装; - **构建安装产物哈希逐位一致**:改动前后关键产物(libcust_opapi.so / libcust_opmaster_rt2.0.so / libcust_opsproto_rt2.0.so)sha256 逐位相同,行为零变化; - **pre-commit 全绿**:trailing-whitespace / end-of-file-fixer / check-merge-conflict / detect-private-key / codespell / OAT 合规检查全部通过(第二笔提交后复跑一致); - **存量 UT 基线**:73/73 通过(host 31 + op_api 42;行覆盖 82.1% / 函数覆盖 90.1%,零预存失败),含 correction>N(N=1, corr=2)与 correction==N(N=2, corr=2)边界形态期望 ACLNN_SUCCESS 的既有用例,与第一笔声明口径一致; - **冻结测试资产核验**:49 项 Golden/legacy/容差冻结资产哈希核验一致,未做任何修改(第二笔后复核一致); - **代码评审**:FAIL 0——第一笔新增行技术子句(数学恒等、不报错并返回成功、+Inf/NaN 细分、meanOut 正常输出)逐项经 NPU 实测与双分支代码核验成立,口径与 README 一致;第二笔五处声明(维度 0-8 ×3、correction 取值、错误码语义)逐项经 NPU 实测(0/8 维输入可正常执行、9 维被拒绝;负值被接受)与 README、既有校验逻辑、仓内文档惯例交叉核验成立。 ## 文档更新 本 PR 即文档更新:math/reduce_std_with_mean/docs/aclnnStdMeanCorrection.md 两笔共 +12/-6——约束说明节 N≤correction 声明 +1;参数表维度列 ×3、correction 取值声明、错误码表触发行与 dtype 语义说明段 +11/-6。 ## 决策与权衡 **为什么选择接口文档补声明,而不是适配层改为报错(ACLNN_ERR_PARAM_INVALID 161002)**(第一笔): 1. **行为本身与契约自洽,非孤例缺陷**:N≤correction 静默输出 +Inf/NaN 是 correction 家族接口(aclnnStd / aclnnVarCorrection / aclnnStdMeanCorrection 及实验性 V2 接口)一致的有意设计,与算子 README 公式 max(0, N-correction) 的钳零语义、PyTorch 参考实现(torch.std_mean 同条件返回 inf/nan 并给 UserWarning、不抛异常)逐层自洽;关联 Issue 反馈的无争议缺口是「接口文档未声明该行为」,本次 PR 精确闭合该缺口。 2. **报错方案的代价(未采纳)**:若适配层改为返回 161002,将与 README 既有声明、PyTorch 参考行为、家族其他接口语义产生用户可见分裂;仓内存量 75 条 correction>N + 16 条 correction==N 的 ST 用例(当前以 inf/nan 数值等价真实通过)将翻为 FAIL,2 条期望 ACLNN_SUCCESS 的 UT 需改写,golden 参考需同步协调——行为契约变更的回归面与社区评审风险显著大于文档补声明。 3. **trade-off**:文档声明不改变运行行为(该场景继续静默 inf/nan,与现契约一致);若后续社区裁决希望改为报错语义,建议作为 correction 家族级统一决策另行推进(届时 README/家族接口文档/UT/ST/golden 需同步协调)。 **第二笔的三处口径取舍**: 1. **dtype 报错按语义记载,不落具体内部错误码数值**:接口返回 161002(ACLNN_ERR_PARAM_INVALID)是对外契约;错误日志中的内部错误码经包装后不直接对外暴露、随 CANN 版本与运行环境漂移(同一场景不同环境数值不同),文档若固化某个具体数值反而误导,故仅记载包装关系与「以接口返回值为准」。 2. **维度列填"0-8"**:实测 0 维与 8 维输入均可正常执行、9 维被拒绝(报 161002),与算子校验逻辑及既有文档约束交叉一致;排布沿用仓内 aclnnAbs.md 参数表维度列惯例。 3. **correction 声明"非负整数"、不声明"负值报错"**:取值语义为非负整数(0=总体标准差、1=样本标准差,Bessel 校正因子);当前实现对越界值无校验(负值亦被接受并按公式计算),若声明"负值报错"即虚构不存在的契约;N≤correction 输出行为已由第一笔声明覆盖。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: See merge request: cann/ops-math!7015 | 18 days ago | |
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 | 24 days ago |
| Files | Last commit | Last update |
|---|---|---|
| 1 month ago | ||
| 24 days ago | ||
| 18 days ago | ||
| 24 days ago |