numpy.tan#
- numpy.tan(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'tan'>#
逐元素计算正切.
等效于逐元素计算
np.sin(x)/np.cos(x).- 参数:
- xarray_like
输入数组.
- outndarray, None, or tuple of ndarray and None, optional
存储结果的位置.如果提供,则它必须具有输入广播到的形状.如果未提供或为None,则返回一个新分配的数组.一个元组(可能仅作为关键字参数)的长度必须等于输出的数量.
- 其中类数组,可选
此条件会在输入上进行广播.在条件为True的位置, out 数组将被设置为ufunc结果.否则, out 数组将保留其原始值.请注意,如果通过默认的
out=None创建一个未初始化的 out 数组,则其中条件为False的位置将保持未初始化.- \kwargs
对于其他仅限关键字的参数,请参见 ufunc docs .
- 返回:
- yndarray
对应的正切值.如果 x 是标量,则这是一个标量.
注释
如果提供了 out ,则该函数会将结果写入其中,并返回对 out 的引用.(参见示例)
参考文献
M. Abramowitz and I. A. Stegun, Handbook of Mathematical Functions. New York, NY: Dover, 1972.
示例
>>> import numpy as np >>> from math import pi >>> np.tan(np.array([-pi,pi/2,pi])) array([ 1.22460635e-16, 1.63317787e+16, -1.22460635e-16]) >>> >>> # Example of providing the optional output parameter illustrating >>> # that what is returned is a reference to said parameter >>> out1 = np.array([0], dtype='d') >>> out2 = np.cos([0.1], out1) >>> out2 is out1 True >>> >>> # Example of ValueError due to provision of shape mis-matched `out` >>> np.cos(np.zeros((3,3)),np.zeros((2,2))) Traceback (most recent call last): File "<stdin>", line 1, in <module> ValueError: operands could not be broadcast together with shapes (3,3) (2,2)