numpy.arcsin

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

Обратный синус, поэлементно.

Параметры

xarray_like

y-координата на единичной окружности.

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

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

wherearray_like, optional

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

**kwargs

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

Возвращает

anglendarray

Обратный синус каждого элемента в x, в радианах и в замкнутом интервале [-pi/2, pi/2]. Это скалярное значение, если x является скалярным.

См. также

sin, cos, arccos, tan, arctan, arctan2, emath.arcsin

Примечания

arcsin — многозначная функция: для каждого x существует бесконечно много чисел z таких, что \(sin(z) = x\). Принято возвращать угол z действительная часть которого лежит в интервале [-pi/2, pi/2].

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

Для комплексных входных данных, arcsin является комплексной аналитической функцией, которая, по соглашению, имеет разрезы ветвей [-бесконечность, -1] и [1, бесконечность] и непрерывна сверху на первом и снизу на втором.

Обратный синус также известен как арксинус или sin^{-1}.

Ссылки

Abramowitz, M. and Stegun, I. A., Справочник по математическим функциям, 10-е издание, Нью-Йорк: Dover, 1964, с. 79 и далее. http://www.math.sfu.ca/~cbm/aands/

Примеры

>>> np.arcsin(1)     # pi/2
1.5707963267948966
>>> np.arcsin(-1)    # -pi/2
-1.5707963267948966
>>> np.arcsin(0)
0.0