CANN/asc-devkit Exp函数API
Exp【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit产品支持情况Ascend 950PR/Ascend 950DT支持Atlas A3 训练系列产品/Atlas A3 推理系列产品不支持Atlas A2 训练系列产品/Atlas A2 推理系列产品不支持Atlas 200I/500 A2 推理产品不支持Atlas 推理系列产品AI Core不支持Atlas 推理系列产品Vector Core不支持Atlas 训练系列产品不支持功能说明头文件路径basic_api/reg_compute/kernel_reg_compute_vec_unary_intf.h。该接口根据mask对源操作数srcReg进行按元素指数操作将结果写入目的操作数dstReg。计算公式如下$$dstReg_i e^{srcReg_i}$$函数原型template typename T DefaultType, auto mode MaskMergeMode::ZEROING, typename U __simd_callee__ inline void Exp(U dstReg, U srcReg, MaskReg mask)参数说明表 1模板参数说明参数名描述T操作数数据类型。支持的数据类型请参考数据类型。mode可配置为MaskMergeMode枚举类型的枚举或ExpSpecificMode的结构体指针。• MaskMergeMode选择MERGING模式或ZEROING模式。• ZEROING模式下mask未筛选的元素在dstReg中置零。• MERGING模式当前不支持。• ExpSpecificMode定义如下enum class ExpAlgo {INTRINSIC 0,PRECISION_1ULP_FTZ_TRUE,PRECISION_1ULP_FTZ_FALSE,};struct ExpSpecificMode{MaskMergeMode mrgMode MaskMergeMode::ZEROING,ExpAlgo algo ExpAlgo::INTRINSIC;};• mrgMode选择MERGING模式或ZEROING模式。• algo用于配置Subnormal模式具体参考关键特性说明。• ExpAlgo::INTRINSIC、ExpAlgo::PRECISION_1ULP_FTZ_TRUE使用单指令计算得出结果所有Subnormal被近似为0。• ExpAlgo::PRECISION_1ULP_FTZ_FALSE支持Subnormal数据计算。U源操作数和目的操作数的RegTensor类型例如RegTensorhalf由编译器自动推导用户不需要填写。表 2参数说明参数名输入/输出描述dstReg输出目的操作数。类型为RegTensor。srcReg输入源操作数。类型为RegTensor。mask输入源操作数元素操作的有效指示详细说明请参考MaskReg。数据类型目的操作数与源操作数的数据类型需要保持一致。支持的数据类型为half、float。返回值说明无约束说明无关键特性说明最大精度误差ExpAlgo::INTRINSIC、ExpAlgo::PRECISION_1ULP_FTZ_TRUE、ExpAlgo::PRECISION_1ULP_FTZ_FALSE最大精度误差为1ULP。ExpAlgo::PRECISION_1ULP_FTZ_FALSE最大精度误差为1ULP。配置Subnormal模式FTZFlush To Zero一种浮点运算模式当结果为Subnormal时将其直接清零近似为0而非保留其精确的微小数值。只有将algo设置为ExpAlgo::PRECISION_1ULP_FTZ_FALSE时Exp接口才会保留并正确输出Subnormal结果其他模式下Subnormal均被FTZ。一般场景推荐使用性能更好的ExpAlgo::INTRINSIC、ExpAlgo::PRECISION_1ULP_FTZ_TRUE需要精确 Subnormal输出的场景如特定数据精度要求的算法、避免除零错误使用ExpAlgo::PRECISION_1ULP_FTZ_FALSE。表 3Exp Subnormal示例输出输入输出二进制输入二进制数据类型6.0975551605e-05-9.7031250 00000 11111111111 10010 0011011010half5.9604644775e-08-16.6406250 00000 00000000011 10011 0000101001half1.1754942107e-38-87.33654785156250 00000000 111111111111111111111111 10000101 01011101010110001010000float1.401298464324817e-45-103.27893066406250 00000000 000000000000000000000011 10000101 10011101000111011010000float调用示例templatetypename T __simd_vf__ inline void ExpVF(__ubuf__ T* dstAddr, __ubuf__ T* srcAddr, uint32_t count, uint16_t oneRepeatSize, uint16_t repeatTimes) { AscendC::Reg::RegTensorT srcReg; AscendC::Reg::RegTensorT dstReg; AscendC::Reg::MaskReg mask; // Subnormal模式 // static constexpr AscendC::Reg::ExpSpecificMode mode {Reg::MaskMergeMode::ZEROING, ExpAlgo::PRECISION_1ULP_FTZ_FALSE}; for (uint16_t i 0; i repeatTimes; i) { mask AscendC::Reg::UpdateMaskT(count); AscendC::Reg::LoadAlign(srcReg, srcAddr i * oneRepeatSize); AscendC::Reg::Exp(dstReg, srcReg, mask); // Subnormal模式 // AscendC::Reg::ExpT, mode(dstReg, srcReg, mask); AscendC::Reg::StoreAlign(dstAddr i * oneRepeatSize, dstReg, mask); } }【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考