maxframe.tensor.arcsin#

maxframe.tensor.arcsin(x, out=None, where=None, **kwargs)[源代码]#

逐元素计算反正弦值。

参数:

  • x (array_like) -- 单位圆上的 y 坐标。

  • out (Tensor, None, or tuple of Tensor and None, optional) -- 用于存储结果的位置。如果提供了该参数，则其形状必须可以广播到输入形状。如果未提供或为 None，则返回一个新分配的 tensor。元组（只能作为关键字参数）的长度必须等于输出的数量。

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

  • **kwargs

返回:

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

返回类型:

Tensor

参见

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

备注

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

对于实数类型的输入数据，arcsin 总是返回实数输出。对于无法表示为实数或无穷大的值，它会返回 nan 并设置 invalid 浮点数错误标志。

对于复数输入，arcsin 是一个复解析函数，按惯例其分支切割为 [-inf, -1] 和 [1, inf]，并在前一个区间上从上方连续，在后一个区间上从下方连续。

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

引用

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

示例

>>> import maxframe.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