numpy.sin

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

逐元素计算三角正弦。

参数：

xarray_like

以弧度为单位的角度 (\(2 \pi\) 弧度等于 360 度)。

outndarray、None 或 ndarray 和 None 的元组，可选

存储结果的位置。如果提供，其形状必须与输入广播到的形状一致。如果未提供或为 None，则返回一个新分配的数组。元组（仅作为关键字参数可能）的长度必须等于输出的数量。

wherearray_like，可选

此条件在输入上进行广播。在条件为 True 的位置，out 数组将设置为 ufunc 结果。在其他位置，out 数组将保留其原始值。请注意，如果通过默认的 out=None 创建未初始化的 out 数组，则其中条件为 False 的位置将保持未初始化。

**kwargs**

对于其他仅限关键字的参数，请参阅 ufunc 文档。

返回值：

yarray_like

x 的每个元素的正弦。如果 x 是标量，则为标量。

另请参阅

arcsin、sinh、cos

备注

正弦是三角学（三角形的数学研究）的基本函数之一。考虑一个以原点为中心的半径为 1 的圆。一条射线从 \(+x\) 轴射入，在原点形成一个角度（从该轴逆时针测量），然后从原点射出。射线与单位圆交点的 \(y\) 坐标是该角度的正弦。它的范围从 \(x=3\pi / 2\) 的 -1 到 \(\pi / 2.\) 的 +1。该函数在角度为 \(\pi\) 的倍数时为零。介于 \(\pi\) 和 \(2\pi\) 之间的角度的正弦为负。正弦和相关函数的众多性质包含在任何标准三角学教科书中。

示例

>>> import numpy as np

打印一个角度的正弦

>>> np.sin(np.pi/2.)
1.0

打印以度为单位给定的角度数组的正弦

>>> np.sin(np.array((0., 30., 45., 60., 90.)) * np.pi / 180. )
array([ 0.        ,  0.5       ,  0.70710678,  0.8660254 ,  1.        ])

绘制正弦函数

>>> import matplotlib.pylab as plt
>>> x = np.linspace(-np.pi, np.pi, 201)
>>> plt.plot(x, np.sin(x))
>>> plt.xlabel('Angle [rad]')
>>> plt.ylabel('sin(x)')
>>> plt.axis('tight')
>>> plt.show()