ATB RingMLA C++示例

加速库RingMLA C++ Demo

【免费下载链接】ascend-transformer-boost本项目是CANN提供的是一款高效、可靠的Transformer加速库，基于华为Ascend AI处理器，提供Transformer定制化场景的高性能融合算子。项目地址: https://gitcode.com/cann/ascend-transformer-boost

介绍

该目录下为加速库RingMLA C++调用示例。

使用说明

• 首先source 对应的CANN和nnal包的安装路径

  1. source [cann安装路径]/set_env.sh 默认：source /usr/local/Ascend/ascend-toolkit/set_env.sh
  2. source [nnal安装路径]/set_env.sh
     默认：source /usr/local/Ascend/nnal/atb/set_env.sh
     ①. 如果使用加速库源码编译，source [加速库源码路径]/output/atb/set_env.sh
     例如： source ./ascend-transformer-boost/output/atb/set_env.sh

• 运行demo

  bash build.sh

  注意：

  • 使用cxx_abi=0（默认）时，设置D_GLIBCXX_USE_CXX11_ABI为0，即：

    g++ -D_GLIBCXX_USE_CXX11_ABI=0 -I ...

  • 使用cxx_abi=1时，更改D_GLIBCXX_USE_CXX11_ABI为1，即：

    g++ -D_GLIBCXX_USE_CXX11_ABI=1 -I ...

  • 生成的二进制文件***_demo可以额外传入一个int参数作为deviceId，默认为0，如：

    ./ring_mla_demo 0

额外说明

示例中生成的数据不代表实际场景，如需数据生成参考请查看根目录下的python用例目录： tests/apitest/opstest/python/operations/ring_mla/

产品支持情况

RingMLA仅Atlas A2/A3系列

场景说明

1. RingMLA：
   • 基础场景，对于query，key分别传入带与不带rope转置的矩阵
   • 传入固定shape，512x512的上三角mask
   • 默认编译脚本可编译运行
   • 该demo仅支持在Atlas A2/A3系列上运行

Demo分段参数/tensor规格设置

因为RingMLA和其他的算子较为不同，第一次运算时不带前次生成的prevOut和prevLse，但是从第二次起使用时需要带上，这里分两段描述：

1. 第一轮

参数设置：

注意：qkScale设置值为RingMLA做rope转置前query，key合一的headSize，即128(nope) + 64(rope) = 192

数据规格：

q第一维度为总词元长度，对应sum(seqlen[0])，k，v第一维度对应sum(seqlen[1])

1. 第二轮 第二轮中会使用第一轮新生成的output和softmaxLse进行计算。

参数设置：

需要额外更改param里的calcType为CALC_TYPE_DEFAULT，其他保持一致

数据规格：

第二轮使用第一轮新生成的output和softmaxLse来作为prevOut和prevLse。

【免费下载链接】ascend-transformer-boost本项目是CANN提供的是一款高效、可靠的Transformer加速库，基于华为Ascend AI处理器，提供Transformer定制化场景的高性能融合算子。项目地址: https://gitcode.com/cann/ascend-transformer-boost