gather_ld_reg样例概述本样例基于Reg编程接口实现将离散数据从UB(Unified Buffer)搬入到RegTensor(Reg矢量计算基本单元)的功能支持两种场景通过 CMake 编译参数SCENARIO_NUM选择场景。SCENARIO_NUM搬入场景1Gather从UB按索引将单点数据收集到RegTensor2GatherB从UB按索引将DataBlock大小的数据收集到RegTensor本样例支持的产品及CANN软件版本产品CANN软件版本Ascend 950PR/Ascend 950DT CANN 9.1.0目录结构介绍├── reg_load_gather │ ├── scripts │ │ ├── gen_data.py // 输入数据和真值数据生成脚本 │ ├── CMakeLists.txt // 编译工程文件 │ ├── data_utils.h // 数据读入写出函数 │ ├── gather_ld_reg.asc // AscendC样例实现 调用样例 │ └── README.md // 样例介绍样例描述样例功能根据索引从源数据中离散收集元素到目的地址。场景1Gather模式使用Gather接口从UB按元素索引收集数据到RegTensor按元素收集dst[i] src[index[i]]源数据量为1024个元素索引数据量为128个元素输出数据量为128个元素。样例规格样例类型(OpType)AIV样例样例输入nameshapedata typesrc[1, 1024]halfindex[1, 128]uint16样例输出dst[1, 128]half核函数名gather_ld_reg样例实现 GatherVF函数内先通过LoadAlign加载索引数据到indexReg再调用Gather接口从源地址按索引收集数据到dstReg最后通过StoreAlign将结果写回UB。调用实现 使用内核调用符调用核函数启动1个核。场景2GatherB模式使用GatherB接口按32字节DataBlock收集源数据量为1024个元素索引数据量为8个元素对应8个DataBlock输出数据量为128个元素。样例规格样例类型(OpType)AIV样例样例输入nameshapedata typesrc[1, 1024]halfindex[1, 8]uint32样例输出dst[1, 128]half核函数名gather_ld_reg样例实现 GatherBVF函数内先通过LoadAlign加载索引数据到indexReg再调用GatherB接口按DataBlock从源地址收集数据到dstReg最后通过StoreAlign将结果写回UB。调用实现 使用内核调用符调用核函数启动1个核。编译运行在本样例根目录下执行如下步骤编译并执行样例。配置环境变量 请根据当前环境上CANN开发套件包的安装方式配置环境变量。source ${install_path}/cann/set_env.sh说明${install_path}为CANN包安装目录未指定安装目录时默认安装至/usr/local/Ascend下。样例执行在本样例目录下执行如下命令。SCENARIO_NUM1 # 选择执行场景1Gather2GatherB mkdir -p build cd build; # 创建并进入build目录 cmake -DSCENARIO_NUM$SCENARIO_NUM -DCMAKE_ASC_ARCHITECTURESdav-3510 ..;make -j; # 编译工程默认npu模式 python3 ../scripts/gen_data.py -scenarioNum $SCENARIO_NUM # 生成测试输入数据 ./demo # 执行编译生成的可执行程序执行样例使用 CPU调试 或 NPU仿真 模式时添加-DCMAKE_ASC_RUN_MODEcpu或-DCMAKE_ASC_RUN_MODEsim参数即可。示例如下cmake -DSCENARIO_NUM$SCENARIO_NUM -DCMAKE_ASC_RUN_MODEcpu -DCMAKE_ASC_ARCHITECTURESdav-3510 ..;make -j; # cpu调试模式 cmake -DSCENARIO_NUM$SCENARIO_NUM -DCMAKE_ASC_RUN_MODEsim -DCMAKE_ASC_ARCHITECTURESdav-3510 ..;make -j; # NPU仿真模式注意切换编译模式或场景前需清理 cmake 缓存可在 build 目录下执行rm CMakeCache.txt后重新 cmake。编译选项说明选项可选值说明SCENARIO_NUM1、2样例执行场景场景1Gather模式、场景2GatherB模式CMAKE_ASC_RUN_MODEnpu默认、cpu、sim运行模式NPU 运行、CPU调试、NPU仿真CMAKE_ASC_ARCHITECTURESdav-3510NPU 架构dav-3510 对应 Ascend 950PR/Ascend 950DT执行结果执行结果如下说明精度对比成功。test pass!创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考