NumPy参考 >例行程序 >Mathematical functions > numpy.arctan2
numpy.
arctan2
(X1,X2,/,出=无,*,其中=真,铸造= 'same_kind' ,为了= 'K' ,D型细胞=无,subok =真[,签名,extobj ] )= <ufunc 'arctan2'> ¶x1/x2
正确选择象限的逐元素反正切。
选择象限(即分支),使之成为以原点结束并通过点(1,0)的光线与以原点结束并通过点(x2,x1)。(请注意角色反转:“ y-坐标”是第一个函数参数,“ x-坐标”是第二个函数参数。)按照IEEE惯例,此函数定义为
x2 = +/- 0以及以下任一个或两个x1和x2 = +/- inf(有关特定值,请参见注释)。arctan2(x1, x2)
未为复数值参数定义此函数;对于复杂值的所谓参数,请使用angle
。
y坐标。
x坐标。如果为,则必须将它们广播为通用形状(成为输出的形状)。x1.shape != x2.shape
结果存储的位置。如果提供,它必须具有输入广播到的形状。如果未提供或没有,则返回一个新分配的数组。元组(只能作为关键字参数)的长度必须等于输出的数量。
此条件通过输入广播。在条件为True的位置,将out数组设置为ufunc结果。在其他地方,out数组将保留其原始值。请注意,如果通过default创建未初始化的out数组out=None
,则条件为False的数组中的
位置将保持未初始化。
有关其他仅关键字的参数,请参见 ufunc docs。
以弧度为单位的角度数组,范围为。如果x1和x2均为标量,则为标量。[-pi, pi]
笔记
arctan2与基础C库的atan2函数相同。C标准中定义了以下特殊值:[1]
x1 |
2倍 |
arctan2(x1,x2) |
---|---|---|
+/- 0 |
+0 |
+/- 0 |
+/- 0 |
-0 |
+/-圆周率 |
> 0 |
+/- inf |
+0 / + pi |
<0 |
+/- inf |
-0 / -pi |
+/- inf |
+ inf |
+/-(pi / 4) |
+/- inf |
-inf |
+/-(3 * pi / 4) |
请注意,+ 0和-0是不同的浮点数,+ inf和-inf也是如此。
参考文献
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])