Closed
[Documentation|文档反馈]: aclnnAsinh 资料「整数入参输出 FLOAT32」实现未强制:int32/int64 入参配 fp16 出参两段均返回 0 #4117
liuhanwen8Add on  22 days agoClosed at  5 days ago
liuhanwen8
liuhanwen8
22 days ago Create

一、文档链接 (必填)

二、问题文档片段 (必填)

docs/aclnnAsinh&aclnnInplaceAsinh.md:101:

当类型为INT8、INT16、INT32、INT64、UINT8、BOOL时,转化为FLOAT32进行运算,输出FLOAT32类型。

同一张参数表第 113 行,out 的数据类型列:

FLOAT、FLOAT16、DOUBLE

💡 存在的问题(选填)

1. 资料给了一个实现没有强制的约束:第 101 行说整数入参「输出 FLOAT32 类型」,按字面 out 只能是 FLOAT32;但第 113 行的 out 白名单又对全部入参统一写成 FLOAT、FLOAT16、DOUBLE。实现按后者执行:aclnn_asinh.cpp:74 只做 1in1out 的 dtype 白名单(不管入参是不是整型),:138 再用 Cast 无条件把结果降到 out 的 dtype。

2. 真机实测(A2 / 910B3 / CANN 9.2.0):整数入参配 fp16 出参被放行

用例 第一段 第二段 按资料应为
int32 → int32 161002 - 161002(out 不在白名单)
int32 → fp16 0 0 161002(整数入参必须输出 FLOAT32)
int64 → fp16 0 0 161002(同上)

也就是说「out dtype 不在白名单」这条路(int32→int32)是生效的,但「整数入参 → 必须 FLOAT32」这条独立约束只写在资料里,实现里没有对应分支。

3. 影响:按资料写用例/断言的人会认为 int32+fp16 组合应当报错,实际返回 0 并给出 fp16 结果;反向也会让「整数入参」这条路径的实际行为缺少文档依据(例如 int64 极值经 fp32 运算后再降 fp16 的精度损失口径)。

4. 复现(自包含):

// aclnnAsinh 支持面探针:A2(910B3) 上 bf16 与「整数入参 + fp16 出参」是否被放行
// 编译:g++ -O2 -std=c++17 probe.cpp -o probe -I/usr/local/Ascend/ascend-toolkit/latest/include \
//   -L/usr/local/Ascend/ascend-toolkit/latest/lib64 -lascendcl -lnnopbase -lopapi
#include <cstdio>
#include <vector>
#include "acl/acl.h"
#include "aclnnop/aclnn_asinh.h"

static void run(const char* tag, aclDataType inD, size_t inE, aclDataType outD, size_t outE,
                aclrtStream s)
{
    std::vector<int64_t> shp{2, 8};
    std::vector<int64_t> st{8, 1};
    void* a = nullptr;
    void* b = nullptr;
    aclrtMalloc(&a, 16 * inE, ACL_MEM_MALLOC_HUGE_FIRST);
    aclrtMalloc(&b, 16 * outE, ACL_MEM_MALLOC_HUGE_FIRST);
    std::vector<unsigned char> h(inE > outE ? 16 * inE : 16 * outE, 0);
    aclrtMemcpy(a, 16 * inE, h.data(), 16 * inE, ACL_MEMCPY_HOST_TO_DEVICE);
    aclrtMemcpy(b, 16 * outE, h.data(), 16 * outE, ACL_MEMCPY_HOST_TO_DEVICE);
    aclTensor* ta = aclCreateTensor(shp.data(), 2, inD, st.data(), 0, ACL_FORMAT_ND, shp.data(), 2, a);
    aclTensor* tb = aclCreateTensor(shp.data(), 2, outD, st.data(), 0, ACL_FORMAT_ND, shp.data(), 2, b);
    uint64_t ws = 0;
    aclOpExecutor* ex = nullptr;
    int r1 = aclnnAsinhGetWorkspaceSize(ta, tb, &ws, &ex);
    int r2 = -1;
    void* wsp = nullptr;
    if (r1 == 0) {
        if (ws > 0) aclrtMalloc(&wsp, ws, ACL_MEM_MALLOC_HUGE_FIRST);
        r2 = aclnnAsinh(wsp, ws, ex, s);
        if (r2 == 0) aclrtSynchronizeStream(s);
        if (wsp) aclrtFree(wsp);
    }
    printf("%-24s GetWorkspaceSize=%d Execute=%d\n", tag, r1, r2);
    aclDestroyTensor(ta);
    aclDestroyTensor(tb);
    aclrtFree(a);
    aclrtFree(b);
}

int main()
{
    aclInit(nullptr);
    aclrtSetDevice(1);
    aclrtStream s = nullptr;
    aclrtCreateStream(&s);
    run("fp32 -> fp32", ACL_FLOAT, 4, ACL_FLOAT, 4, s);
    run("bf16 -> bf16", ACL_BF16, 2, ACL_BF16, 2, s);
    run("int32 -> fp16", ACL_INT32, 4, ACL_FLOAT16, 2, s);
    run("int64 -> fp16", ACL_INT64, 8, ACL_FLOAT16, 2, s);
    aclrtDestroyStream(s);
    aclrtResetDevice(1);
    aclFinalize();
    return 0;
}

实测输出(910B3,CANN 9.2.0):

fp32 -> fp32             GetWorkspaceSize=0 Execute=0
int32 -> fp16            GetWorkspaceSize=0 Execute=0
int64 -> fp16            GetWorkspaceSize=0 Execute=0

5. 建议:二选一并保证两份文档一致——

  • 若设计意图是「整数入参结果必须 FLOAT32」:在 CheckParamsAsinh 补一条 NEED_CAST_DTYPE_LIST ∈ input.dtype ⇒ out.dtype == FLOAT 的校验(返回 161002),并在错误码表补该子项;
  • 若设计意图是「输出 dtype 由调用方 out 决定」:把第 101 行改成「转化为 FLOAT32 进行运算,结果再转换为 out 的数据类型」,并说明 int64 极值在 fp16 out 下的精度损失口径。

关联:#3801(dtype 范围注释修正,已关闭)。

likedislike
liuhanwen8liuhanwen8
22 days ago Added label: documentation
xujiachen8Collaborators
21 days ago Comments:

您好,感谢提供类型组合对照!核对 master b08e885e7fac370203a51904fd0680523b9a9205,资料仍写“转化为 FLOAT32 进行运算,输出 FLOAT32 类型”,但实际处理是整型/BOOL 输入先 Cast 为 FLOAT 计算 Asinh,再将结果 Cast 成调用方 out 的类型。入口分别检查输入和输出支持列表及可转换性,没有整数输入必须配 FLOAT 输出的专门分支。int32→int32 被拒绝不能证明实现要求输入输出严格同型,它首先涉及输出白名单。

现阶段可确认资料文字与转换链路需要统一。若保留既有转换能力,可将说明写成 FLOAT32 计算后再转换为 out,并明确精度边界;若设计要求只允许 FLOAT 输出,则需评估新增检查对现有 int→fp16/fp64 调用的兼容性,并同步错误码。不能只将当前放行一概判成实现错误。

INT64 超过 FP32 连续整数范围时,计算前的转换已经可能丢失信息,输出转为更宽类型也无法恢复;fp16 输出还会增加舍入及范围限制。本轮为源码核对,您提供的 A2/CANN 9.2.0 设备返回码尚未独立复测。

核对依据:aclnnAsinh、aclnnInplaceAsinh.md;aclnn_asinh.cpp;level2_base_math.h。

likedislike
Xxujiachen8Collaborators
21 days ago Assign yangjinwen as responsible person
Xxujiachen8Collaborators
21 days ago Added label: pending-confirmation
陈思陈思Collaborators
21 days ago Removed label: pending-confirmation
YyangjinwenCollaborators
21 days ago Assign yefeicoding as responsible person
YyangjinwenCollaborators
21 days ago Removed responsible person yangjinwen
CANN-robotCANN-robotCollaborators
5 days ago Close issue
CANN-robotCANN-robotCollaborators
5 days ago changed custom state from 进行中 to 已完成
CANN-robotCANN-robotCollaborators
5 days ago Added label: resolved