numpy.arccos

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

Тригонометрический обратный косинус, поэлементно.

Обратная функция к cos, так что, если y = cos(x), то x = arccos(y).

Параметры

xarray_like

x-координата на единичной окружности. Для вещественных аргументов область определения — [-1, 1].

outndarray, None, or tuple of ndarray and None, optional

Расположение, в котором хранится результат. Если указано, оно должно иметь форму, на которую накладываются входные данные. Если не указано или равно None, возвращается только что выделенный массив. Кортеж (возможен только как ключевой аргумент) должен иметь длину, равную количеству выходов.

wherearray_like, optional

Это условие транслируется по входу. В местах, где условие истинно, массив out будет установлен на результат ufunc. В противном случае массив out сохранит свое исходное значение. Обратите внимание, что если массив out неинициализирован через значение по умолчанию out=None, места в нём, где условие ложно, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию ufunc.

Возвращает

anglendarray

Угол луча, пересекающего единичную окружность в данной x-координате в радианах [0, π]. Это скаляр, если x является скаляром.

См. также

cos, arctan, arcsin, emath.arccos

Примечания

arccos — многозначная функция: для каждого x существует бесконечно много чисел z таких, что cos(z) = x. Соглашение состоит в том, чтобы вернуть угол z действительная часть которого лежит в [0, pi].

Для вещественных типов входных данных arccos всегда возвращает вещественный результат. Для каждого значения, которое не может быть выражено как вещественное число или бесконечность, оно возвращает nan и устанавливает флаг ошибки плавающей точки invalid.

Для комплексных входных данных arccos — комплексная аналитическая функция, имеющая разрывы ветвей [-inf, -1] и [1, inf] и непрерывная сверху на первой и снизу на второй.

Обратная cos также известна как acos или cos^-1.

Ссылки

М. Абрамовиц и И.А. Стегун, «Справочник по математическим функциям», 10-е издание, 1964, стр. 79. http://www.math.sfu.ca/~cbm/aands/

Примеры

Ожидается, что arccos от 1 будет 0, а от -1 — π:

>>> np.arccos([1, -1])
array([ 0.        ,  3.14159265])

Построим график arccos:

>>> import matplotlib.pyplot as plt
>>> x = np.linspace(-1, 1, num=100)
>>> plt.plot(x, np.arccos(x))
>>> plt.axis('tight')
>>> plt.show()