mars.tensor.arcsin#

mars.tensor.arcsin(x, out=None, where=None, **kwargs)[来源]#

逐元素的反正弦。

Parameters

  • x (数组类似) – y坐标在单位圆上。

  • out (Tensor, None, 或 tuple 的 Tensor 和 None, 可选) – 结果存储的位置。如果提供，它必须具有和输入相同的广播形状。如果未提供或None，将返回一个新分配的张量。元组（仅作为关键字参数可能）必须具有与输出数量相等的长度。

  • where (array_like, 可选) – 值为 True 表示在该位置计算 ufunc，值为 False 表示保持输出中的该值不变。

  • **kwargs –

Returns

angle – 每个元素在 x 中的反正弦，单位为弧度，并在闭区间 [-pi/2, pi/2] 内。如果 x 是一个标量，则返回一个标量，否则返回一个张量。

Return type

张量

另请参阅

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

备注

arcsin 是一个多值函数：对于每个 x，有无限多个数 z，使得 \(sin(z) = x\)。约定是返回实部在 [-pi/2, pi/2] 范围内的角度 z。

对于实值输入数据类型，arcsin始终返回实数输出。 对于每个不能表示为实数或无穷大的值， 它返回nan并设置无效浮点错误标志。

对于复数值输入，arcsin 是一个复解析函数，按照约定，其支路切割为 [-inf, -1] 和 [1, inf]，在前者为上连续，而在后者为下连续。

反正弦也被称为 asin 或 sin^{-1}。

参考文献

Abramowitz, M. 和 Stegun, I. A.，数学函数手册， 第10版，纽约：多弗，1964年，第79页及以下。 http://www.math.sfu.ca/~cbm/aands/

示例

>>> import mars.tensor as mt
>>> mt.arcsin(1).execute()     # pi/2
1.5707963267948966
>>> mt.arcsin(-1).execute()    # -pi/2
-1.5707963267948966
>>> mt.arcsin(0).execute()
0.0