| Files | Last commit | Last update |
|---|---|---|
修复 ops-nn 接口文档扫描问题(错别字/标点/多字,117处) Co-authored-by: liujing987913<liujing407@h-partners.com> # message auto-generated for no-merge-commit merge: !13766 merge master into master 修复 ops-nn 接口文档扫描问题(错别字/标点/多字,117处) Created-by: liujing987913 Commit-by: liujing987913 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> - 背景:大模型扫描发现 ops-nn 接口文档问题 117 处 - 修改分类:多字/中文多字 70、同音字 17、形近字 3、引号未成对 4、代码括号 2、术语拼写 2、字母顺序 2(文本替换 100 处);MD 结构 17 处(tab→空格 6、列表空行 9、连续空行 2) - 涉及文件:docs 目录下 85 个接口文档 md - 验证:git diff 确认为纯文本替换(100 处)+ 纯结构操作(17 处),无代码内容误改;已人工复核 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。例如:关联Issue [#8245](https://gitcode.com/cann/ops-nn/issues/8245) ## 测试 <!--描述进行了哪些测试来验证你的改动。--> ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> 本次 PR 更新了 ops-nn 接口文档 85 个 md 文件,修正错别字/标点/多字 100 处、MD 结构 17 处,详见 diff。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [ ] AI辅助编写 See merge request: cann/ops-nn!13766 | 15 days ago | |
修改nn仓AIDD扫描必处理问题 Co-authored-by: y60124828<yanglou1@h-partners.com> # message auto-generated for no-merge-commit merge: !14238 merge master into master 修改nn仓AIDD扫描必处理问题 Created-by: yanglu-1 Commit-by: y60124828 Merged-by: cann-robot Description: ## 描述 修改nn仓AIDD扫描必处理问题 ## 关联的Issue 关联Issue [#8649](https://gitcode.com/cann/ops-nn/issues/8649) ## 测试 <!--描述进行了哪些测试来验证你的改动。--> ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [ ] AI辅助编写 See merge request: cann/ops-nn!14238 | 9 days ago | |
docs: 修订aclnnDequantSwigluQuant/V2中quantScale、quantOffset与groupIndex的形状约束 Co-authored-by: jzj007<jiangzhijie9@huawei.com> # message auto-generated for no-merge-commit merge: !13587 merge docs/dequant-swiglu-quant-shape into master docs: 修订aclnnDequantSwigluQuant/V2中quantScale、quantOffset与groupIndex的形状约束 Created-by: jzj007 Commit-by: jzj007 Merged-by: cann-robot Description: ## 描述 本次仅修改 quant/dequant_swiglu_quant 的 V1/V2 中英文四份文档(aclnnDequantSwigluQuant、aclnnDequantSwigluQuantV2),使 quantScaleOptional / quantOffsetOptional / groupIndexOptional 的形状约束与 A2/A3(DSK、base)及 Ascend 950(arch35)的 tiling 校验逻辑一致,并补齐 V2 此前缺失的 Ascend 950 参数说明。 **改动原因** 1. 原文档只给出单一形态(V1 为 [1]/[H/2],V2 为 [H]/[groupNum, H]),未区分 groupIndexOptional 是否为空、quantModeOptional 为 static 还是 dynamic,用户按资料构造入参频繁触发 561002(对应 Issue #7559、#7582)。 2. V2 将 groupIndexOptional 描述为“仅支持 1 维、不支持空指针”,与实现不符:实际仅支持 INT64、可传空指针,且支持 [groupNum] 与 [groupNum, 2]([realGroupIdx, count])两种形态。 3. V2 原先没有 Ascend 950 段的参数约束说明,而 950(arch35)规则与 A3 差异明显(static + group 时允许 2 维末维为 1 的广播、quantOffsetOptional 可缺省、scale 与 offset 同时存在时元素总数必须相等等)。 **改动方法** 依据 op_host/dequant_swiglu_quant_tiling.cpp(A3 DSK)、op_host/dequant_swiglu_quant_tiling_base.cpp(A3 base)、op_host/dequant_swiglu_quant_tiling_arch35.cpp(Ascend 950)的校验逻辑: 1. V1(aclnnDequantSwigluQuant.md / aclnnDequantSwigluQuant_en.md) - quantScaleOptional / quantOffsetOptional 按 groupIndexOptional 是否为空 × static/dynamic 分情况展开(H 为 x 最后一维): - group 为空:static 与 dynamic 规则一致,按元素总数校验,须为 H/2(逐 channel)或 1(逐 tensor),不限制维数;quantOffsetOptional 在 static 下仅当 scale 非空时生效,dynamic 下不生效。 - group 非空:static 必填,[groupNum] 或 [groupNum, H/2];dynamic 可传空指针,非空时为 [H/2]、[1, H/2](groupNum 为 1)或 [groupNum, H/2](groupNum 大于 1,第 0 维必须等于 groupNum);quantOffsetOptional 在 static 下必须输入且 dtype/shape 与 scale 一致,dynamic 下必须为空。 - 约束段适用范围由 910b 扩至 A3,910b;约束说明中与参数描述重复的 1 维 scale/offset 说明替换为输入张量内存上限公式(原 id11 内容),并删除重复的 id11。 - 修正一处引号笔误(“static" → “static”)。 2. V2(aclnnDequantSwigluQuantV2.md / aclnnDequantSwigluQuantV2_en.md) - 参数表 quantScaleOptional / quantOffsetOptional 两行改为通用描述(可选、static 必填、shape 支持 1 维或 2 维,具体约束见各产品说明),避免与各产品规则冲突。 - 约束段 id7:group 为空时 scale 非空仅支持 [H] 或 [1, H](此时仅 dynamic),offset 必须为空;group 非空时按 static/dynamic 分述(static 必填 [groupNum] 或 [groupNum, H];dynamic 为 [H]/[1, H](groupNum 为 1)或 [groupNum, H])。 - groupIndexOptional 补充:仅 INT64、可选、支持传空指针;1 维 [groupNum](每元素为该组 token 数)、2 维 [groupNum, 2](每行为 [realGroupIdx, count]);x 为 BFLOAT16 时仅支持 1 维;2 维不可与 biasOptional 或非 0 swigluMode 同时使用。 - 新增 Ascend 950 段(id11):scale/offset 为 FLOAT、1~2 维;offset 仅在 static 下支持(dynamic 传非空指针报错)且可缺省;group 为空时 static 为 [1]/[H]、dynamic 为 [H]/[1, H];group 非空时 static 第 0 维必须为 groupNum、2 维末维可为 H 或 1(广播),dynamic 必须为 [groupNum, H];scale 与 offset 同时存在时元素总数必须相同。 - 英文文档逐条对齐中文,删除一处中文没有的额外维度描述。 ## 关联的Issue - [#7559](https://gitcode.com/cann/ops-nn/issues/7559) - [#7582](https://gitcode.com/cann/ops-nn/issues/7582) ## 测试 - 仅文档修改,未改动代码,无新增 UT/ST。 - V1 与 V2 的中英文内容已逐条交叉核对(对应小节条目数一致、语义一一对应);文档结论逐条对照上述 tiling 校验代码确认。 - Ascend 950 侧按文档规则重写 45 条用例并在 Ascend950DT 实机运行,45/45 通过(覆盖 static 2 维末维为 1 的广播、scale 与 offset 元素数不一致触发 561002、dynamic 传非空 offset 报错等边界)。 - A3 侧按实现枚举 36 条合法形态(未在 A3 硬件上执行)。 ## 文档更新 - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuant.md - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuant_en.md - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuantV2.md - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuantV2_en.md ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 - [ ] AI辅助编写 See merge request: cann/ops-nn!13587 | 16 days ago | |
docs: 修订aclnnDequantSwigluQuant/V2中quantScale、quantOffset与groupIndex的形状约束 Co-authored-by: jzj007<jiangzhijie9@huawei.com> # message auto-generated for no-merge-commit merge: !13587 merge docs/dequant-swiglu-quant-shape into master docs: 修订aclnnDequantSwigluQuant/V2中quantScale、quantOffset与groupIndex的形状约束 Created-by: jzj007 Commit-by: jzj007 Merged-by: cann-robot Description: ## 描述 本次仅修改 quant/dequant_swiglu_quant 的 V1/V2 中英文四份文档(aclnnDequantSwigluQuant、aclnnDequantSwigluQuantV2),使 quantScaleOptional / quantOffsetOptional / groupIndexOptional 的形状约束与 A2/A3(DSK、base)及 Ascend 950(arch35)的 tiling 校验逻辑一致,并补齐 V2 此前缺失的 Ascend 950 参数说明。 **改动原因** 1. 原文档只给出单一形态(V1 为 [1]/[H/2],V2 为 [H]/[groupNum, H]),未区分 groupIndexOptional 是否为空、quantModeOptional 为 static 还是 dynamic,用户按资料构造入参频繁触发 561002(对应 Issue #7559、#7582)。 2. V2 将 groupIndexOptional 描述为“仅支持 1 维、不支持空指针”,与实现不符:实际仅支持 INT64、可传空指针,且支持 [groupNum] 与 [groupNum, 2]([realGroupIdx, count])两种形态。 3. V2 原先没有 Ascend 950 段的参数约束说明,而 950(arch35)规则与 A3 差异明显(static + group 时允许 2 维末维为 1 的广播、quantOffsetOptional 可缺省、scale 与 offset 同时存在时元素总数必须相等等)。 **改动方法** 依据 op_host/dequant_swiglu_quant_tiling.cpp(A3 DSK)、op_host/dequant_swiglu_quant_tiling_base.cpp(A3 base)、op_host/dequant_swiglu_quant_tiling_arch35.cpp(Ascend 950)的校验逻辑: 1. V1(aclnnDequantSwigluQuant.md / aclnnDequantSwigluQuant_en.md) - quantScaleOptional / quantOffsetOptional 按 groupIndexOptional 是否为空 × static/dynamic 分情况展开(H 为 x 最后一维): - group 为空:static 与 dynamic 规则一致,按元素总数校验,须为 H/2(逐 channel)或 1(逐 tensor),不限制维数;quantOffsetOptional 在 static 下仅当 scale 非空时生效,dynamic 下不生效。 - group 非空:static 必填,[groupNum] 或 [groupNum, H/2];dynamic 可传空指针,非空时为 [H/2]、[1, H/2](groupNum 为 1)或 [groupNum, H/2](groupNum 大于 1,第 0 维必须等于 groupNum);quantOffsetOptional 在 static 下必须输入且 dtype/shape 与 scale 一致,dynamic 下必须为空。 - 约束段适用范围由 910b 扩至 A3,910b;约束说明中与参数描述重复的 1 维 scale/offset 说明替换为输入张量内存上限公式(原 id11 内容),并删除重复的 id11。 - 修正一处引号笔误(“static" → “static”)。 2. V2(aclnnDequantSwigluQuantV2.md / aclnnDequantSwigluQuantV2_en.md) - 参数表 quantScaleOptional / quantOffsetOptional 两行改为通用描述(可选、static 必填、shape 支持 1 维或 2 维,具体约束见各产品说明),避免与各产品规则冲突。 - 约束段 id7:group 为空时 scale 非空仅支持 [H] 或 [1, H](此时仅 dynamic),offset 必须为空;group 非空时按 static/dynamic 分述(static 必填 [groupNum] 或 [groupNum, H];dynamic 为 [H]/[1, H](groupNum 为 1)或 [groupNum, H])。 - groupIndexOptional 补充:仅 INT64、可选、支持传空指针;1 维 [groupNum](每元素为该组 token 数)、2 维 [groupNum, 2](每行为 [realGroupIdx, count]);x 为 BFLOAT16 时仅支持 1 维;2 维不可与 biasOptional 或非 0 swigluMode 同时使用。 - 新增 Ascend 950 段(id11):scale/offset 为 FLOAT、1~2 维;offset 仅在 static 下支持(dynamic 传非空指针报错)且可缺省;group 为空时 static 为 [1]/[H]、dynamic 为 [H]/[1, H];group 非空时 static 第 0 维必须为 groupNum、2 维末维可为 H 或 1(广播),dynamic 必须为 [groupNum, H];scale 与 offset 同时存在时元素总数必须相同。 - 英文文档逐条对齐中文,删除一处中文没有的额外维度描述。 ## 关联的Issue - [#7559](https://gitcode.com/cann/ops-nn/issues/7559) - [#7582](https://gitcode.com/cann/ops-nn/issues/7582) ## 测试 - 仅文档修改,未改动代码,无新增 UT/ST。 - V1 与 V2 的中英文内容已逐条交叉核对(对应小节条目数一致、语义一一对应);文档结论逐条对照上述 tiling 校验代码确认。 - Ascend 950 侧按文档规则重写 45 条用例并在 Ascend950DT 实机运行,45/45 通过(覆盖 static 2 维末维为 1 的广播、scale 与 offset 元素数不一致触发 561002、dynamic 传非空 offset 报错等边界)。 - A3 侧按实现枚举 36 条合法形态(未在 A3 硬件上执行)。 ## 文档更新 - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuant.md - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuant_en.md - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuantV2.md - quant/dequant_swiglu_quant/docs/aclnnDequantSwigluQuantV2_en.md ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: ## AI/Agent生成声明 - [ ] AI辅助编写 See merge request: cann/ops-nn!13587 | 16 days ago |
| Files | Last commit | Last update |
|---|---|---|
| 15 days ago | ||
| 9 days ago | ||
| 16 days ago | ||
| 16 days ago |