Closed
[Documentation|文档反馈]: StatelessExponential 同页既称不支持 L2/非连续输入,又提供相应公开接口 #4233
daishuangshuangAdd on  18 days agoClosed at  23 hours ago
daishuangshuang
18 days ago Create

1)标题

[Documentation|文档反馈] StatelessExponential 同页既称不支持 L2/非连续输入,又提供相应公开接口

2)文档链接

GitCode 文档定位 · 本地快照:random/stateless_exponential/README.md

3)问题文档片段

原文第 75–78 行:

1. `self` 仅支持 FLOAT16/BFLOAT16/FLOAT,ND 格式,维度数 ≤8;非连续输入通过 AutoContiguous 转为连续。
2. `lambd` 必须 > 0。
3. `offset` 必须为 4 的倍数。
4. 仅支持 Ascend 950;不支持入图(op_graph)、不支持 L2 接口、不支持非连续 Tensor。

原文第 85 行:

| aclnn接口 | [test_aclnn_stateless_exponential](./examples/arch35/test_aclnn_stateless_exponential.cpp) | 通过[aclnnStatelessExponentialTensor](docs/aclnnStatelessExponentialTensor.md)接口方式调用StatelessExponential算子。 |

4)存在的问题(选填)

同页调用表提供 aclnnStatelessExponentialTensor,API 源码 也实际定义两阶段入口,并调用 Contiguous/ViewCopy;详细接口文档 将 self 标为支持非连续。该说明混淆了底层 Kernel 与 L2 适配层,会使用户放弃可用入口或误加连续化。建议删除过时的“不支持 L2”,分层说明布局能力,保留经核实的入图等真实限制。

likedislike
Ddaishuangshuang
17 days ago changed custom category from 任务 to 缺陷
陈思
陈思Collaborators
17 days ago Comments:

您好,感谢反馈!核对 cann/ops-math@ae087b184,README第1条约束和调用表,与第4条“不支持L2、不支持非连续Tensor”确实存在冲突。当前两阶段入口实际定义了 aclnnStatelessExponentialTensorGetWorkspaceSize 和执行函数;非空 self 经 Contiguous 得到连续临时张量,完成随机数生成后,再用 ViewCopy 写回原 self,详细接口文档也将 self 标为支持非连续。

一个可行的修订方向是去掉一概“不支持L2”的表述,并分层说明布局能力:底层计算使用连续缓冲区,L2负责对满足接口约束的非连续self做适配与回写;这不等于底层kernel直接支持任意stride,也不能把self的能力扩大到seedTensor/offsetTensor等其他参数。产品、图模式以及随机数偏移等限制仍应按各自实际通路单独核对,避免因修订这两处文字而扩大支持范围。我们会继续跟踪README、接口文档和调用表的一致性。

likedislike
陈思陈思Collaborators
17 days ago Assign biabu111 as responsible person
陈思陈思Collaborators
17 days ago Added label: pending-confirmation
陈思陈思Collaborators
17 days ago Removed label: pending-confirmation
biabubiabuCollaborators
17 days ago Assign huairuchen as responsible person
biabubiabuCollaborators
17 days ago Removed responsible person biabu111
huairuchenhuairuchenCollaborators
4 days ago Assign biabu111 as responsible person
huairuchenhuairuchenCollaborators
4 days ago Removed responsible person huairuchen
biabubiabuCollaborators
4 days ago Assign aiteer as responsible person
aiteeraiteerCollaborators
4 days ago Associated pull request
CANN-robotCANN-robotCollaborators
23 hours ago Close issue
CANN-robotCANN-robotCollaborators
21 hours ago Added label: resolved