numpy.arctan2

numpy.arctan2(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj]) = <ufunc 'arctan2'>

元素方向的弧正切 x1/x2 正确选择象限。

选择象限(即分支),以便 arctan2(x1, x2) 是光线在原点结束并通过点(1,0)与光线在原点结束并通过点之间的有符号角度(弧度) (x2x1 )(注意角色转换:“y”坐标是第一个函数参数,“x”坐标是第二个。)根据IEEE约定,此函数定义为 x2 =+/-0,对于其中一个或两个 x1x2 =+/-inf(具体数值见注释)。

此函数不是为复杂值参数定义的;对于所谓的复杂值参数,请使用 angle .

参数
x1类数组,实值

y -坐标。

x2类数组,实值

x -坐标。如果 x1.shape != x2.shape ,它们必须可以广播到公共形状(成为输出的形状)。

outndarray、none或ndarray和none的元组,可选

存储结果的位置。如果提供,它必须具有输入广播到的形状。如果未提供或没有,则返回新分配的数组。元组(只能作为关键字参数)的长度必须等于输出数。

where阵列式,可选

这种情况通过输入广播。在条件为真的位置 out 数组将被设置为ufunc结果。在其他地方 out 数组将保留其原始值。请注意,如果未初始化 out 数组是通过默认值创建的 out=None ,其中条件为False的位置将保持未初始化状态。

**kwargs

有关其他仅限关键字的参数,请参见 ufunc docs .

返回
angle恩达雷

以弧度表示的角度数组,在范围内 [-pi, pi] . 这是一个标量,如果两者都是 x1x2 是标量。

参见

arctan, tan, angle

笔记

ARCANT2atan2 基础C库的函数。C标准中定义了以下特殊值: [1]

x1

x2

arctan2(x1,x2)

+/- 0

+0

+/- 0

+/- 0

-0

+/-PI

> 0

+/-INF

+0/+PI

< 0

+/-INF

-0 / -pi

+/-INF

+INF

+/-(PI/4)

+/-INF

-INF

+/-(3×π/ 4)

注意+0和-0是不同的浮点数,如+inf和-inf。

工具书类

1

ISO/IEC标准9899:1999,“编程语言C”。

实例

考虑不同象限中的四个点:

>>> x = np.array([-1, +1, +1, -1])
>>> y = np.array([-1, -1, +1, +1])
>>> np.arctan2(y, x) * 180 / np.pi
array([-135.,  -45.,   45.,  135.])

注意参数的顺序。 arctan2 也在以下情况下定义 x2 =0,在其他几个特殊点,获得范围内的值 [-pi, pi]

>>> np.arctan2([1., -1.], [0., 0.])
array([ 1.57079633, -1.57079633])
>>> np.arctan2([0., 0., np.inf], [+0., -0., np.inf])
array([ 0.        ,  3.14159265,  0.78539816])