| docs: [maximum_grad/minimum_grad] 新增算子 README 说明文档及融合规则资料 Co-authored-by: Hana77<wangtianqi27@huawei.com> # message auto-generated for no-merge-commit merge: !6741 merge mm into master docs: [maximum_grad/minimum_grad] 新增算子 README 说明文档及融合规则资料 Created-by: Hana77 Commit-by: Hana77 Merged-by: cann-robot Description: ## 描述 为 maximum_grad / minimum_grad 算子补充说明文档，具体包括： 1. **新增算子 README**（math/maximum_grad/README.md、math/minimum_grad/README.md），内容覆盖： - 产品支持情况：Ascend 950PR&950DT、Atlas A3、Atlas A2、Atlas 200I/500 A2、Atlas 推理/训练系列； - 功能说明与计算公式：MaximumGrad 为 maximum 的反向梯度算子，y1 = grads × (x1 ≥ x2)，y2 = grads × (x1 < x2)；MinimumGrad 为 minimum 的反向梯度算子，y1 = grads × (x1 ≤ x2)，y2 = grads × (x1 > x2)； - 参数说明：输入 grads/x1/x2，输出 y1/y2，支持 FLOAT16/FLOAT/BF16/INT32（ND 格式），可选属性 grad_x/grad_y（BOOL，默认 true）； - 约束说明：输入 shape 须满足 broadcast 规则（输出 shape 为 broadcast 后的结果）、BF16 仅 Ascend 950PR&950DT 系列产品支持、grad_x 与 grad_y 不能同时为 false； - 调用说明：图模式调用样例（examples/arch35/test_geir_*.cpp，通过算子 IR 构图方式调用）。 2. **新增融合规则资料**（math/maximum_grad/docs/MaximumMinimumGradFusionPass.md 及配图 docs/zh/figures/MaximumMinimumGradFusionPass.png）：说明 TensorFlow 自动求导分解出的 Maximum/Minimum 梯度子图（GreaterEqual/LessEqual + Select/SelectV2）替换为 MaximumGrad/MinimumGrad 算子的融合模式、使用约束（输入 dtype 一致且仅支持 float16/float32/bf16/int32、zeros 须为全零常量节点、GE 编译器版本不低于 9.0.0）及支持型号。 3. **更新算子列表**（docs/zh/op_list.md）：新增 maximum_grad、minimum_grad 条目及功能描述，并链接至对应 README。 ## 关联的Issue - #4174 ## 测试 - 纯文档变更，无代码逻辑改动，不涉及二级冒烟、算子泛化等测试。 - 已校验文档中引用的文件均真实存在：examples/arch35/test_geir_maximum_grad.cpp、op_graph/maximum_grad_proto.h（minimum_grad 对应文件同）。 ## 文档更新 - 新增 math/maximum_grad/README.md、math/minimum_grad/README.md - 新增 math/maximum_grad/docs/MaximumMinimumGradFusionPass.md、docs/zh/figures/MaximumMinimumGradFusionPass.png - 更新 docs/zh/op_list.md ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6741 | 13 days ago |
