CANN Ascend C饱和函数文档

__saturatef

【免费下载链接】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 训练系列产品：不支持

功能说明

将输入数据转换至[0.0, 1.0]区间。具体来说，若输入数据大于或等于1，则结果为1，若输入数据小于或等于0，则结果为0，若输入数据在[0.0, 1.0]区间，则结果为原输入数据。

函数原型

float __saturatef(float x)

参数说明

表1参数说明

参数名	输入/输出	描述
x	输入	源操作数。

返回值说明

输入数据转换至[0.0, 1.0]区间的结果。

• 当x≤0时，返回值为0。
• 当x≥1时，返回值为1。
• 当0<x<1时，返回值为x。
• 当x为nan时，返回值为0。

约束说明

无

需要包含的头文件

使用该接口需要包含"simt_api/device_functions.h"头文件。

#include "simt_api/device_functions.h"

调用示例

• SIMT编程场景：

  __global__ __launch_bounds__(256) void compute_saturate_intrinsic(float *result, const float *x, uint32_t count) { const uint32_t idx = blockIdx.x * blockDim.x + threadIdx.x; if (idx >= count) { return; } result[idx] = __saturatef(x[idx]); }

• SIMD与SIMT混合编程场景：

  __simt_vf__ __launch_bounds__(256) inline void compute_saturate_intrinsic_vf(__gm__ float *result, __gm__ const float *x, uint32_t count) { const uint32_t idx = blockIdx.x * blockDim.x + threadIdx.x; if (idx >= count) { return; } result[idx] = __saturatef(x[idx]); } __global__ __vector__ void run_saturate_intrinsic(__gm__ float *result, __gm__ const float *x, uint32_t count) { asc_vf_call<compute_saturate_intrinsic_vf>(dim3(256), result, x, count); }

输入输出示例如下：

x：0.25, 0.75, 1.25, 1.75 result: 0.25 0.75 1 1

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit