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()
../../_images/numpy-sin-1.png