已关闭
[Documentation|文档反馈]:接口注释写错了,调用 AscendC::Reg::LoadDist::DIST_UNPACK_B16>接口时,描述为unpack到VL/4长度,实际上应该是unpack到VL长度,请确认,谢谢 #1894
LetsAiGo创建于  13 天前关闭于  11 天前
LetsAiGo
13 天前 创建

Document Link(文档链接)

接口注释写错了,
调用 AscendC::Reg::LoadDist::DIST_UNPACK_B16>接口,描述为 unpack到VL/4长度,实际上应该是unpack到VL长度

位置:examples/01_simd_cpp_api/03_basic_api/02_reg_vector_compute/cast/cast.asc

https://gitcode.com/cann/asc-devkit/blob/master/examples/01_simd_cpp_api/03_basic_api/02_reg_vector_compute/cast/cast.asc

问题所在位置截图:

image.png

Issues Section(问题文档片段)

位置:examples/01_simd_cpp_api/03_basic_api/02_reg_vector_compute/cast/cast.asc

https://gitcode.com/cann/asc-devkit/blob/master/examples/01_simd_cpp_api/03_basic_api/02_reg_vector_compute/cast/cast.asc

image.png

Existing Issues(存在的问题)

接口注释写错了,
调用 AscendC::Reg::LoadDist::DIST_UNPACK_B16>接口,写成unpack到VL/4长度,实际上应该是unpack到VL长度

likedislike
liuliu876成员
11 天前 评论:

您好,感谢您的反馈。

我们已确认 examples/01_simd_cpp_api/03_basic_api/02_reg_vector_compute/cast/cast.asc 第34行注释有误:"unpack到VL/4长度"应为"unpack到VL长度"。

核实依据如下:

  1. LoadAlign 接口官方文档(docs/zh/api/SIMD-API/basic_api/reg_vector_compute/reg_data_load/LoadAlign_continuous.md 表3)中对 DIST_UNPACK_B16 的说明为:解压缩模式,按无符号整型u16加载VL/2数据量,每个元素后会补1个值为0元素,即unpack到VL。
  2. 从语义上看,每个u16元素后补0使数量翻倍(VL/2 → VL),结果铺满整个寄存器,不可能为VL/4。
  3. 该样例自身README中的描述"搬入数据至2N位置,同时2N+1位置置0"也与"unpack到VL长度"一致。

该错误仅此一处,我们会在后续版本中修正该注释。感谢您对提升文档质量的贡献,欢迎继续反馈问题。

likedislike
Lliuliu876成员
11 天前 将 liuliu876 设为负责人
CANN-robotCANN-robot成员
11 天前 关闭了 issue
CANN-robotCANN-robot成员
11 天前 添加了label:resolved