Skip to content

Log10

产品支持情况​

  • Ascend 950PR&950DT系列产品:支持
  • Atlas A3系列产品:不支持
  • Atlas A2系列产品:不支持
  • Atlas 200I/500 A2推理产品:不支持
  • Atlas推理系列产品AI Core:不支持
  • Atlas推理系列产品Vector Core:不支持
  • Atlas训练系列产品:不支持
  • KirinX90处理器系列产品:支持
  • Kirin9020处理器系列产品:支持
  • Kirin9030处理器系列产品:支持
  • Kirin9050处理器系列产品:支持

功能说明​

头文件路径:"basic_api/reg_compute/kernel_reg_compute_vec_unary_intf.h"。

该接口根据mask逐元素对源操作数求以10为底的对数,将结果写入目的操作数。

计算公式如下:

函数原型​

C++
template <typename T = DefaultType, auto mode = MaskMergeMode::ZEROING, typename U>
__simd_callee__ inline void Log10(U& dstReg, U& srcReg, MaskReg& mask)

参数说明​

表1 模板参数说明

参数名描述
T操作数数据类型。支持的数据类型请参考数据类型。
mode可配置为MaskMergeMode枚举值或指向Log10SpecificMode结构体的指针。
• 配置MaskMergeMode:选择MERGING模式或ZEROING模式。
  • ZEROING模式下,mask未筛选的元素在dstReg中置零。
  • MERGING模式当前不支持。
• 配置Log10SpecificMode,定义如下:
enum class Log10Algo {
INTRINSIC = 0,
PRECISION_1ULP_FTZ_TRUE,
PRECISION_1ULP_FTZ_FALSE,
};
struct Log10SpecificMode {
MaskMergeMode mrgMode = MaskMergeMode::ZEROING;
Log10Algo algo = Log10Algo::INTRINSIC;
};

• mrgMode:选择MERGING模式或ZEROING模式。
• algo:用于选择Log10算法及配置Subnormal模式,详细说明请参考关键特性说明。
  • Log10Algo::INTRINSIC:默认算法,最大精度误差为1ulp。对于half、float类型,Subnormal处理受编译选项--cce-ftz控制(默认值为true)。
  • Log10Algo::PRECISION_1ULP_FTZ_TRUE:使用单指令计算,最大精度误差为1ulp。
  • Log10Algo::PRECISION_1ULP_FTZ_FALSE:通过软件仿真实现,支持Subnormal数据计算,最大精度误差为1ulp。
U目的操作数的RegTensor类型,例如RegTensor<half>,由编译器自动推导,用户不需要填写。

表2 参数说明

参数名输入/输出描述
dstReg输出目的操作数。
类型为RegTensor。
srcReg输入源操作数。
类型为RegTensor。
mask输入源操作数元素操作的有效指示,详细说明请参考MaskReg。

数据类型​

目的操作数与源操作数的数据类型需要保持一致。支持的数据类型为:half、float。

返回值说明​

无

约束说明​

无

关键特性说明​

精度提升​

当源操作数数据类型为half时,将half提升精度到float后进行计算,再将结果转为half后输出。

最大精度误差​

Log10Algo::INTRINSIC、Log10Algo::PRECISION_1ULP_FTZ_TRUE和Log10Algo::PRECISION_1ULP_FTZ_FALSE的最大精度误差均为1ulp。

配置Subnormal模式​

FTZ(Flush-To-Zero):一种浮点运算模式,当结果为Subnormal时,将其直接清零(近似为0),而非保留其精确的微小数值。

默认算法​

Log10Algo::INTRINSIC为默认算法。--cce-ftz=false时保留Subnormal;--cce-ftz=true(默认值)时采用FTZ模式。

显式指定的算法​

  • Log10Algo::PRECISION_1ULP_FTZ_TRUE使用单指令计算,始终采用FTZ模式。
  • Log10Algo::PRECISION_1ULP_FTZ_FALSE通过软件仿真实现,支持Subnormal数据计算。

使用建议​

由于保留Subnormal的计算行为通过软件仿真实现,在--cce-ftz=true(默认值)时,一般场景建议使用默认的Log10Algo::INTRINSIC或显式选择Log10Algo::PRECISION_1ULP_FTZ_TRUE,以获得更好的性能;需要精确输出Subnormal时,使用Log10Algo::PRECISION_1ULP_FTZ_FALSE。

调用示例​

C++
template<typename T>
__simd_vf__ inline void Log10VF(__ubuf__ T* dstAddr, __ubuf__ T* srcAddr, uint32_t count, uint16_t oneRepeatSize, uint16_t repeatTimes)
{
    AscendC::Reg::RegTensor<T> srcReg;
    AscendC::Reg::RegTensor<T> dstReg;
    AscendC::Reg::MaskReg mask;
    // 1ulp精度及Subnormal模式
    // static constexpr AscendC::Reg::Log10SpecificMode mode = {
    //     AscendC::Reg::MaskMergeMode::ZEROING, AscendC::Log10Algo::PRECISION_1ULP_FTZ_FALSE};
    for (uint16_t i = 0; i < repeatTimes; i++) {
        mask = AscendC::Reg::UpdateMask<T>(count);
        AscendC::Reg::LoadAlign(srcReg, srcAddr + i * oneRepeatSize);
        AscendC::Reg::Log10(dstReg, srcReg, mask);
        // 1ulp精度及Subnormal模式
        // AscendC::Reg::Log10<DTYPE, &mode>(dstReg, srcReg, mask);
        AscendC::Reg::StoreAlign(dstAddr + i * oneRepeatSize, dstReg, mask);
    }
}

免责声明:本站内容由 asc-devkit 仓 master 分支自动编译生成,属于持续开发版本,可能存在缺陷,仅供预览与参考。如需稳定及商用资料,请查阅官方 昇腾社区。