已合并
[docs]: add native API support info for torch.UntypedStorage.float8_e4m3fnuz and float8_e5m2fnuz (issues #3844 #3845) #45030
[docs]: add native API support info for torch.UntypedStorage.float8_e4m3fnuz and float8_e5m2fnuz (issues #3844 #3845) #45030
已合并
AZT创建于 21 天前
AZT
AZT
21 天前

【合入来源】

关联 issue:

  • #3844torch.UntypedStorage.float8_e4m3fnuz(对应任务 issue #3743)
  • #3845torch.UntypedStorage.float8_e5m2fnuz(对应任务 issue #3745)

【修改方案】

本 PR 为资料补齐(docs/zh/api/native_api 变更)。

在 pytorch_2-7-1 / pytorch_2-11-0 / pytorch_2-12-0 / pytorch_2-13-0 四个版本的 torch-Storage.md 中,为 torch.UntypedStorage.float8_e4m3fnuztorch.UntypedStorage.float8_e5m2fnuz 新增资料项,标记为不支持(✘)。

原因:NPU/CANN 不支持 float8_e4m3fnuz / float8_e5m2fnuz dtype(Ascend 使用自有的 hifloat8/e8m0fnu 格式),实测调用报错 Float8_e4m3fnuz has not been supported / Float8_e5m2fnuz has not been supported。相关资料说明见 issue #3844 / #3845。

【资料变更】

结论:涉及。

  • torch.UntypedStorage.float8_e4m3fnuz:新增资料项,支持情况 Atlas A2/A3/Ascend 950DT 均标注为 ✘(不支持)。
  • torch.UntypedStorage.float8_e5m2fnuz:新增资料项,支持情况 Atlas A2/A3/Ascend 950DT 均标注为 ✘(不支持)。
  • 刷新 pytorch_2-7-1 / 2-11-0 / 2-12-0 / 2-13-0 四个版本(2-9-0 / 2-10-0 已删除无需补齐)。
  • 非计算类 API(与数据类型无关)限制与说明写 -
  • 使用新版格式 ✔/✘ 表示支持情况。

【接口变更】

结论:不涉及。

本 PR 仅变更 docs/zh/api/native_api 资料文件,未修改任何实现、声明、注册或客户可见接口。

【验证】

已检查 4 个版本目录:

  • float8_e4m3fnuz / float8_e5m2fnuz 原未收录,本 PR 新增并标记为 ✘。
  • 与 NPU 实测一致(调用报错不支持)。
likedislike
Pull Request已成功合入, 合并人@ascend-robot
(感谢 AZT 的贡献)
AZTAZT
21 天前 创建了 pull request,commit ce70e0b1
AZTAZT
21 天前 关联了issue:8月社区任务第一期-Ascend for PyTorch API 一致性开发(82),8月社区任务第一期-Ascend for PyTorch API 一致性开发(84),【API一致性任务】: Ascend for PyTorch API 一致性开发说明:float8_e4m3fnuz 测试用例及资料验证,【API一致性任务】: Ascend for PyTorch API 一致性开发说明:float8_e5m2fnuz 测试用例及资料验证
atomgit-bot
atomgit-bot
21 天前 评论:

变更摘要

本 PR 为纯资料补齐(docs/zh/api/native_api),不涉及任何实现、声明或客户可见接口变更。在 pytorch_2-7-1pytorch_2-11-0pytorch_2-12-0pytorch_2-13-0 四个版本的 torch-Storage.md 中,为 torch.UntypedStorage.float8_e4m3fnuztorch.UntypedStorage.float8_e5m2fnuz 新增原生 API 资料项,并统一标记为 ✘(不支持)。原因在于 NPU/CANN 不支持这两个 dtype(Ascend 使用自有的 hifloat8/e8m0fnu 格式),实测调用会报错 Float8_e4m3fnuz has not been supported / Float8_e5m2fnuz has not been supported,对应 issue #3844 / #3845。非计算类 API 的限制与说明统一填写 -,支持情况采用新版 ✔/✘ 格式标注。

主要改动

  • 新增 float8_e4m3fnuz 资料项:在四个版本的 torch-Storage.md 中为 torch.UntypedStorage.float8_e4m3fnuz 新增 API 资料,Atlas A2/A3/Ascend 950DT 均标注为 ✘(不支持)。
  • 新增 float8_e5m2fnuz 资料项:在四个版本的 torch-Storage.md 中为 torch.UntypedStorage.float8_e5m2fnuz 新增 API 资料,Atlas A2/A3/Ascend 950DT 均标注为 ✘(不支持)。
  • 补齐四个版本目录:刷新 pytorch_2-7-1 / pytorch_2-11-0 / pytorch_2-12-0 / pytorch_2-13-0torch-Storage.mdpytorch_2-9-0 / pytorch_2-10-0 已删除无需补齐)。
  • 统一资料格式:采用新版 ✔/✘ 支持情况标记,非计算类 API 的限制与说明统一写为 -,使资料与 NPU 实测行为一致。
likedislike
不准确?
atomgit-bot
atomgit-bot
21 天前 评论:

🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。

likedislike
不准确?
ascend-robotascend-robot成员
21 天前 添加了label:ascend-cla/yes
ascend-robot
ascend-robot成员
21 天前 评论:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.


PR Approval Progress

Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
**/*.md li_jing_hw, renyujin (2/2) li_jing_hw (1/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

anning-2026, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
ascend-robot
ascend-robot成员
21 天前 评论:

当前仓库存在以下 保护分支

Protected Branch Version Release
master
v2.12.0
v2.7.1
v2.11.0
v2.10.0
v2.9.0
v2.12.0-26.1.0
v2.7.1-26.1.0
v2.10.0-26.1.0
v2.11.0-26.1.0
v2.9.0-26.1.0
ci-test

评论 /sync <branch1> <branch2> ... 可将当前 PR 修改同步到其它分支(创建同步 PR):
a) 如果当前 PR 是 Open 状态,同步操作将延迟到 PR 被合并时执行
b) 如果当前 PR 已经 Merged,将立即执行同步操作

注意:

  1. /sync 命令可以指定同步到多个分支,仅最后一个 /sync 命令生效
  2. 如果创建的同步 PR 不正确,可通过向同步 PR 的源分支提交轻量级 PR 完善,或使用 /close 命令关闭
likedislike
ascend-robotascend-robot成员
21 天前 添加了label:ci-pipeline-running
ascend-robot
ascend-robot成员
21 天前 评论:

ascend docs pipeline is running...

likedislike
ascend-robotascend-robot成员
21 天前 添加了label:docs-ci-pipeline-running
ascend-robot
ascend-robot成员
21 天前 评论:

✅ 文档门禁通过!

检查项 检查结果 详情
markdownlint ✅ 已通过 查看详情
link-validity-check ✅ 已通过 查看详情
resource-existence-check ✅ 已通过 查看详情
tag-closed-check ✅ 已通过 查看详情
likedislike
ascend-robotascend-robot成员
21 天前 删除了label:docs-ci-pipeline-running
ascend-robotascend-robot成员
21 天前 添加了label:docs-ci-pipeline-success
ascend-robotascend-robot成员
21 天前 删除了label:ci-pipeline-running
ascend-robotascend-robot成员
21 天前 添加了label:ci-pipeline-passed
ascend-robot
ascend-robot成员
21 天前 评论:
流水线 PR-pipeline_pytorch#62722 [ commitID:e55fc6a0 ] 已完成
>>>代码风格自动修复执行成功(无修复内容)
阶段 任务名 状态 详情
编译构建 Build_X86 🛑 >>>
Build_ARM 🛑 >>>
Build_X86_torchair 🛑 >>>
Build_ARM_torchair 🛑 >>>
patch_test 🛑 >>>
Build_X86_213 🛑 >>>
Build_ARM_213 🛑 >>>
恶意代码检查 Antipoison >>>
编码安全与规范检查 codecheck_pre-commit >>>
check_error >>>
lintrunner >>>
开源片段检查 SCA >>>
开发者测试 UT_ARM_A3_Part_01 🛑 >>>
UT_ARM_A3_Part_02 🛑 >>>
UT_ARM_A2_Part_01 🛑 >>>
UT_ARM_A2_Part_02 🛑 >>>
UT_ARM_A2_Part_03 🛑 >>>
UT_inductor_Part_01 🛑 >>>
UT_inductor_Part_02 🛑 >>>
UT_inductor_Part_03 🛑 >>>
UT_inductor_Part_04 🛑 >>>
UT_DIST_ARM_Part_01 🛑 >>>
UT_DIST_ARM_Part_02 🛑 >>>
UT_DIST_ARM_Part_03 🛑 >>>
UT_DIST_ARM_Part_04 🛑 >>>
UT_ARM_A2_Select_Part_01 🛑 >>>
UT_ARM_A2_Select_Part_02 🛑 >>>
UT_ARM_A2_Part_01_213 🛑 >>>
UT_ARM_A2_Part_02_213 🛑 >>>
UT_ARM_A2_Part_03_213 🛑 >>>
UT_inductor_Part_01_213 🛑 >>>
UT_inductor_Part_02_213 🛑 >>>
UT_inductor_Part_03_213 🛑 >>>
UT_inductor_Part_04_213 🛑 >>>
UT_DIST_ARM_Part_01_213 🛑 >>>
UT_DIST_ARM_Part_02_213 🛑 >>>
UT_DIST_ARM_Part_03_213 🛑 >>>
UT_DIST_ARM_Part_04_213 🛑 >>>
UT_ARM_A2_Select_Part_01_213 🛑 >>>
UT_ARM_A2_Select_Part_02_213 🛑 >>>
流水线 PR-pipeline_pytorch >>>
此流水线已支持下列评论快捷指令,仅PR创建者和白名单成员[wujinyuan1, huangjingwei, liangsongwei, yashi999, culechan, Dring, wuyouqi1, L1919_snow, qq_52711437, WhiteNight12, nomiz, xiu_21, ffmh, wanglijun55, hss-shuai, husichao, smallsilly, lanshaozuishuai, jimmyisme1, lzy0920232, alpha-junh, Sunshine_Youngster, wei_zhuoyi, zhangyihuiben, zyw-hw, zzzkeke, rmch, yangch0324, LucciC, AACAES, renyujin, wjlflyer, senzhen-town, pengjingyou, qsc97, limuan, yule100, xiaoqi-zhou, kuhn7, chenxingying, hanye02, zichun_ye, anyrenwei, kkjocker, wangzili121, Lu_G, yvjc, puddingfjz, HandsoemLemon, bigprestigee1, huawuyi, zhenyu10, dairenjie, du-jin-hang, zou-jieyu, adelaideliu, TrHan, wanlinan, Windwindzzz, pengqihw, kisnwang, yuheng_wang, honghao_wang, jizewei, zhangguoguang, sunyu-xuan, chenrayray, hbhu_bin, liujunzhu, c_34, LiNuoh, maoyuanpeng1, zzhongmin, zhaoyu65, bellatan, jiabaolin, zhuofanshen, wencaiwen, lu_zhuge, caoshuyang, molly12, lyx324521, LQ1206, gitcode-chenjiao, cai-weiwei1989, CHDong, ogqin, yuanlipingGit, xuqinglin1, lqz2, zouwei1, chaoluoa, paradox325, jackzhang1116, yaoyao, akh, yujiacheng, dengjie0116, Hubert11111, Shine_Ws, wslhj555, longqiand, OYtao666, JiaqingQiang, luyyyy, Kingbelial, zhanghaiyu0101, wenxp1018, yanliu-luoluo, ksun_sekiro, liyong328, wgzheng, tangky, vivi_is_coding, aoiaoisola, weixin_44494597, wangmengmengwang65667, hid57809721, qq_35468730, comeonup, C547032, gcw_m5OQChA4, yao_yao_ling_xian, cnnbwcy, szqfes_12, cora_19, cann_lilin, can, shawnylee233, fanglanyue0916, hhz0, LiNuohang, taohuoquan, Jesse, WSs_321]评论有效
  • compile、compile_inductor、compile_torchair : 运行流水线
  • retry : 重试流水线所有失败子任务
  • retry <任务名> : 仅重试指定失败子任务
  • stop : 停止流水线
likedislike
AZT
AZT
16 天前 评论:

compile

likedislike
ascend-robotascend-robot成员
16 天前 删除了label:ci-pipeline-passed
ascend-robotascend-robot成员
16 天前 添加了label:ci-pipeline-running
ascend-robot
ascend-robot成员
16 天前 评论:

ascend docs pipeline is running...

likedislike
ascend-robotascend-robot成员
16 天前 删除了label:docs-ci-pipeline-success
ascend-robotascend-robot成员
16 天前 添加了label:docs-ci-pipeline-running
ascend-robot
ascend-robot成员
16 天前 评论:

✅ 文档门禁通过!

检查项 检查结果 详情
markdownlint ✅ 已通过 查看详情
link-validity-check ✅ 已通过 查看详情
resource-existence-check ✅ 已通过 查看详情
tag-closed-check ✅ 已通过 查看详情
likedislike
ascend-robotascend-robot成员
16 天前 删除了label:docs-ci-pipeline-running
ascend-robotascend-robot成员
16 天前 添加了label:docs-ci-pipeline-success
ascend-robotascend-robot成员
16 天前 删除了label:ci-pipeline-running
ascend-robotascend-robot成员
16 天前 添加了label:ci-pipeline-passed
ascend-robot
ascend-robot成员
16 天前 评论:
流水线 PR-pipeline_pytorch#63959 [ commitID:e55fc6a0 ] 已完成
>>>代码风格自动修复执行成功(无修复内容)
阶段 任务名 状态 详情
编译构建 Build_X86 🛑 >>>
Build_ARM 🛑 >>>
Build_X86_torchair 🛑 >>>
Build_ARM_torchair 🛑 >>>
patch_test 🛑 >>>
Build_X86_213 🛑 >>>
Build_ARM_213 🛑 >>>
恶意代码检查 Antipoison >>>
编码安全与规范检查 codecheck_pre-commit >>>
check_error >>>
lintrunner >>>
开源片段检查 SCA >>>
开发者测试 UT_ARM_A3_Part_01 🛑 >>>
UT_ARM_A3_Part_02 🛑 >>>
UT_ARM_A2_Part_01 🛑 >>>
UT_ARM_A2_Part_02 🛑 >>>
UT_ARM_A2_Part_03 🛑 >>>
UT_inductor_Part_01 🛑 >>>
UT_inductor_Part_02 🛑 >>>
UT_inductor_Part_03 🛑 >>>
UT_inductor_Part_04 🛑 >>>
UT_DIST_ARM_Part_01 🛑 >>>
UT_DIST_ARM_Part_02 🛑 >>>
UT_DIST_ARM_Part_03 🛑 >>>
UT_DIST_ARM_Part_04 🛑 >>>
UT_ARM_A2_Select_Part_01 🛑 >>>
UT_ARM_A2_Select_Part_02 🛑 >>>
UT_ARM_A2_Part_213 🛑 >>>
UT_inductor_Part_213 🛑 >>>
UT_DIST_ARM_Part_213 🛑 >>>
UT_ARM_A2_Select_Part_213 🛑 >>>
流水线 PR-pipeline_pytorch >>>
此流水线已支持下列评论快捷指令,仅PR创建者和白名单成员[wujinyuan1, huangjingwei, liangsongwei, yashi999, culechan, Dring, wuyouqi1, L1919_snow, qq_52711437, WhiteNight12, nomiz, xiu_21, ffmh, wanglijun55, hss-shuai, husichao, smallsilly, lanshaozuishuai, jimmyisme1, lzy0920232, alpha-junh, Sunshine_Youngster, wei_zhuoyi, zhangyihuiben, zyw-hw, zzzkeke, rmch, yangch0324, LucciC, AACAES, renyujin, wjlflyer, senzhen-town, pengjingyou, qsc97, limuan, yule100, xiaoqi-zhou, kuhn7, chenxingying, hanye02, zichun_ye, anyrenwei, kkjocker, wangzili121, Lu_G, yvjc, puddingfjz, HandsoemLemon, bigprestigee1, huawuyi, zhenyu10, dairenjie, du-jin-hang, zou-jieyu, adelaideliu, TrHan, wanlinan, Windwindzzz, pengqihw, kisnwang, yuheng_wang, honghao_wang, jizewei, zhangguoguang, sunyu-xuan, chenrayray, hbhu_bin, liujunzhu, c_34, LiNuoh, maoyuanpeng1, zzhongmin, zhaoyu65, bellatan, jiabaolin, zhuofanshen, wencaiwen, lu_zhuge, caoshuyang, molly12, lyx324521, LQ1206, gitcode-chenjiao, cai-weiwei1989, CHDong, ogqin, yuanlipingGit, xuqinglin1, lqz2, zouwei1, chaoluoa, paradox325, jackzhang1116, yaoyao, akh, yujiacheng, dengjie0116, Hubert11111, Shine_Ws, wslhj555, longqiand, OYtao666, JiaqingQiang, luyyyy, Kingbelial, zhanghaiyu0101, wenxp1018, yanliu-luoluo, ksun_sekiro, liyong328, wgzheng, tangky, vivi_is_coding, aoiaoisola, weixin_44494597, wangmengmengwang65667, hid57809721, qq_35468730, comeonup, C547032, gcw_m5OQChA4, yao_yao_ling_xian, cnnbwcy, szqfes_12, cora_19, cann_lilin, can, shawnylee233, fanglanyue0916, hhz0, LiNuohang, taohuoquan, Jesse, WSs_321]评论有效
  • compile、compile_inductor、compile_torchair : 运行流水线
  • retry : 重试流水线所有失败子任务
  • retry <任务名> : 仅重试指定失败子任务
  • stop : 停止流水线
likedislike
li_jing_hw成员
14 天前 评论:

/approve

likedislike
ascend-robotascend-robot成员
14 天前 添加了label:approved
renyujin成员
14 天前 评论:

/lgtm

likedislike
ascend-robotascend-robot成员
14 天前 添加了label:lgtm
ascend-robotascend-robot成员
14 天前 关闭了关联的issue
ascend-robotascend-robot成员
14 天前 合入了pull request
AtlasAccount
AtlasAccount成员
14 天前 评论:
流水线 pytorch_gitcode_PR_multiVersion#14631 [ commitID:e55fc6a0 ] 已完成
likedislike