Merged
docs(math): Xlogy Tensor接口out数据类型声明按实测支持情况扩充 #7143
zhaoxinmengAdd on 15 days ago
docs(math): Xlogy Tensor接口out数据类型声明按实测支持情况扩充 #7143
Merged
zhaoxinmengAdd on 15 days ago
zhaoxinmengCollaborators
15 days ago

描述

按 TTK 实测支持情况扩充 aclnnXLogYTensor 的 out 数据类型声明(纯资料改动,2 文件 +2/-2):

  • out 声明从 9 种扩充为 15 种:补 DOUBLE、UINT16、UINT32、UINT64、COMPLEX64、COMPLEX128——第一段接口对 out 不做列表校验,运行时 l0op::Cast 承接全部 15 种类型
  • 输入参数(self/other/selfRef)与 Scalar 接口 out 声明维持不变(Scalar 接口经 CanCast 校验,仅放行浮点系 4 种:FLOAT/FLOAT16/DOUBLE/BFLOAT16)

关联的Issue

#4550

测试

TTK aclnn 通路实测(Ascend 950PR,master 基线代码构建包):

  • out 类型支持矩阵(15 种 × 正常 fp32 输入):15/15 全 PASS——第一段接口 Success + 执行成功 + 值比对通过:
    • 浮点:FLOAT、FLOAT16、BFLOAT16、DOUBLE ✓
    • 整型:INT8/INT16/INT32/INT64、UINT8/UINT16/UINT32/UINT64、BOOL ✓
    • 复数:COMPLEX64、COMPLEX128 ✓(实部承载计算结果,比对通过)
  • L0 功能精度回归(8 条小 shape 用例):8/8 全 PASS

文档更新

  • math/xlogy/docs/aclnnXLogYTensor&aclnnInplaceXLogYTensor.md(含 _en):out 数据类型列扩充为 15 种

类型标签

likedislike
Pull Request has been successfully merged by CANN-robot.
(Thank you for zhaoxinmeng's contribution.)
ZzhaoxinmengCollaborators
15 days ago Created pull request, commit e1a1e717
ZzhaoxinmengCollaborators
15 days ago Associated issue: [Documentation|文档反馈]: Xlogy算子README调用说明缺失与aclnn接口文档dtype声明/公式语义/样例健壮性问题
atomgit-bot
atomgit-bot
15 days ago Comments:

变更摘要

本 PR 为文档变更,将 math/xlogy 下三份 aclnn 接口文档(中英文各一份,共 6 个文件)中 DOUBLE 数据类型的支持声明与实测验证的代码实际支持情况对齐。核心是在 aclnnXLogYScalarOther/aclnnInplaceXLogYScalarOther、aclnnXLogYScalarSelf、aclnnXLogYTensor/aclnnInplaceXLogYTensor 的算子参数表格中补入 DOUBLE,使标量接口与 Tensor 接口的输出类型口径一致;tensor 输入参数(self/other/selfRef)的类型列表维持不变。

主要改动

  • 标量参数 other 补 DOUBLE: 在 aclnnXLogYScalarOther 与 aclnnInplaceXLogYScalarOther 的中英文档中,为标量输入 other 的类型列表加入 DOUBLE,与 ScalarSelf 的标量口径对齐,两处接口的标量支持类型统一为 10 种。
  • 标量接口输出 out 补 DOUBLE: aclnnXLogYScalarOther/aclnnInplaceXLogYScalarOther 与 aclnnXLogYScalarSelf 的 out 支持类型由 3 种浮点(FLOAT、FLOAT16、BFLOAT16)扩展为 4 种,加入 DOUBLE。
  • Tensor 接口输出 out 补 DOUBLE: aclnnXLogYTensor/aclnnInplaceXLogYTensor 的 out 类型列表由 9 种扩展为 10 种,新增 DOUBLE,与实测接受且结果正确的情况一致。
  • 输入类型列表保持不变: tensor 输入参数(self、other、selfRef)仍不含 DOUBLE,InplaceScalarOther 的 selfRef 仍为 3 种浮点类型,与实现拒绝 DOUBLE tensor 输入的行为保持一致。
  • 中英文文档同步更新: 上述类型声明调整在中文与英文版本中一一对应,保证双语接口文档描述一致。

🧩 本次 Review 已使用自定义 Skill:

likedislike
Incorrect?
atomgit-bot
atomgit-bot
15 days ago Comments:

代码审查

✅ 未发现问题


🧩 本次 Review 已使用自定义 Skill:

likedislike
Incorrect?
CANN-robotCANN-robotCollaborators
15 days ago Added label: cann-cla/yes
84 messages are collapsed here。 See more
chenjiaoCollaborators
14 days ago Comments:

/approve

likedislike
CANN-robot
CANN-robotCollaborators
14 days ago Comments:

The following users do not have permission to comment /lgtm or /approve on any module in this PR:
/approve: 汤平川

likedislike
CANN-robotCANN-robotCollaborators
14 days ago Added label: lgtmapproved
CANN-robotCANN-robotCollaborators
14 days ago Closed associated issue
CANN-robotCANN-robotCollaborators
14 days ago Merged pull request