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), и лучом, исходящим из начала координат и проходящим через точку (x2, x1). (Обратите внимание на обратное расположение операндов: «y-координата» — это первый параметр функции, а «x-координата» — второй.) По соглашению IEEE, эта функция определена для x2 = +/-0 и для любого или обоих x1 и x2 = +/-бесконечности (см. Примечания для конкретных значений).

Эта функция не определена для комплексных аргументов; для так называемого аргумента комплексных значений используйте angle.

Параметры:

x1 : array_like, вещественное значение y-координаты. x2 : array_like, вещественное значение x-координаты. x2 должно быть транслируемым для соответствия форме x1 или наоборот. out : ndarray, None или кортеж из ndarray и None, необязательно Расположение, в которое сохраняется результат. Если указано, оно должно иметь форму, к которой транслируются входные данные. Если не указано или None, возвращается только что выделенный массив. Кортеж (возможен только в качестве ключевого аргумента) должен иметь длину, равную количеству выходных данных. where : array_like, необязательно Значения True указывают на вычисление ufunc в этом положении, значения False указывают на оставление значения в выходных данных неизменным. **kwargs Для других ключевых аргументов см. документацию ufunc.

Возвращает:

angle : ndarray Массив углов в радианах, в диапазоне [-pi, pi].

См. также

arctan, tan, angle

Примечания

arctan2 идентично функции atan2 в базовой C библиотеке. Следующие специальные значения определены в стандарте C: [R6]

x1	x2	arctan2(x1,x2)
+/- 0	+0	+/- 0
+/- 0	-0	+/- пи
> 0	+/-бесконечность	+0 / +пи
< 0	+/-бесконечность	-0 / -пи
+/-бесконечность	+бесконечность	+/- (пи/4)
+/-бесконечность	-бесконечность	+/- (3*пи/4)

Обратите внимание, что +0 и -0 — это разные числа с плавающей запятой, как и +бесконечность и -бесконечность.

Ссылки

[R6]	(1, 2) Стандарт 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])