atan2f
产品支持情况
- Ascend 950PR/Ascend 950DT：支持
- Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
- Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
- Atlas 200I/500 A2 推理产品：不支持
- Atlas 推理系列产品AI Core：不支持
- Atlas 推理系列产品Vector Core：不支持
- Atlas 训练系列产品：不支持
功能说明
获取输入数据y/x的反正切值。
函数原型
C++
inline float atan2f(float y, float x)
参数说明
表1 参数说明
| 参数名 | 输入/输出 | 描述 |
|---|---|---|
| y | 输入 | 源操作数。 |
| x | 输入 | 源操作数。 |
返回值说明
y/x的反正切值。
特殊取值场景下的返回值如下表所示。
| 输入值x | 输入值y | 返回值 |
|---|---|---|
| 任意值 | nan | nan |
| nan | 任意值 | nan |
| 正值（含+0） | +0 | +0 |
| 正值（含+0） | -0 | -0 |
| 负值（含-0） | +0 | π |
| 负值（含-0） | -0 | -π |
| inf | inf | π/4 |
| inf | -inf | -π/4 |
| inf | 1 | 0.0 |
| -inf | inf | 3π/4 |
| -inf | -inf | -3π/4 |
| -inf | 1 | π |
| 1 | inf | π/2 |
| 1 | -inf | -π/2 |
约束说明
针对Ascend 950PR/Ascend 950DT，本接口不支持Subnormal场景：本接口内部实现使用到了除法运算符，由于除法运算符不支持Subnormal场景，当x和y均为Subnormal数据时，本接口最终返回nan；当仅y为Subnormal数据且x为正数且非Subnormal数据时，本接口最终返回0；当仅y为Subnormal数据且x为负数且非Subnormal数据时，本接口最终返回与y同号的π。
需要包含的头文件
使用该接口需要包含"simt_api/math_functions.h"头文件。
C++
#include "simt_api/math_functions.h"
调用示例
SIMT编程场景：
C++__global__ __launch_bounds__(256) void compute_atan2f(float *result, const float *x, const float *y, uint32_t count) { const uint32_t idx = blockIdx.x * blockDim.x + threadIdx.x; if (idx >= count) { return; } result[idx] = atan2f(y[idx], x[idx]); }SIMD与SIMT混合编程场景：
C++__simt_vf__ __launch_bounds__(256) inline void compute_atan2f_vf(__gm__ float *result, __gm__ const float *x, __gm__ const float *y, uint32_t count) { const uint32_t idx = blockIdx.x * blockDim.x + threadIdx.x; if (idx >= count) { return; } result[idx] = atan2f(y[idx], x[idx]); } __global__ __vector__ void run_atan2f(__gm__ float *result, __gm__ const float *x, __gm__ const float *y, uint32_t count) { asc_vf_call<compute_atan2f_vf>(dim3(256), result, x, y, count); }
输入输出示例如下：
Text
y：1.5, 2.5, 3.5, 4.5
x：0.25, 0.75, 1.25, 1.75
result: 1.405648 1.27934 1.227772 1.199905