NumPy arcsin() 函数

NumPy arcsin() 函数用于计算输入数组中每个元素的反正弦值(反正弦值)。它计算输入值作为其正弦值的角(以弧度为单位)。

• 定义域:该函数接受介于 -1 和 1 之间的输入值(含 -1 和 1)。超出此范围的值将导致错误。
• 范围:输出值位于 [-/2, /2] 范围内，因为反正弦函数返回的角度在此范围内。

语法

以下是 NumPy arcsin() 函数的语法 -

numpy.arcsin(x, /, out=None, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj])

参数

此函数接受以下参数 -

• x: 输入数组或标量，值应在 [-1, 1] 范围内。该函数计算数组或标量每个元素的反正弦值。
• out(可选): 存储结果的位置。如果提供，则必须具有输入广播到的形状。如果未提供或为 None，则返回一个新分配的数组。
• where(可选): 此条件通过输入进行广播。在条件为 True 的位置，将计算结果。否则，结果将保留其原始值。
• casting(可选): 控制可能发生的数据转换类型。默认为"same_kind"。
• order(可选): 控制结果的内存布局顺序。 'C' 表示 C 阶，'F' 表示 Fortran 阶，'A' 表示如果输入全部为 F，则为 'F'，否则为 'C'，'K' 表示尽可能匹配输入的布局。
• dtype(可选): 返回数组的类型以及处理元素的累加器的类型。除非指定 dtype，否则默认使用 x 的 dtype。
• subok(可选): 如果为 True，则将传递子类，否则返回的数组将被强制为基类数组。

返回值

此函数返回一个数组，其中每个元素都是输入数组 x 中相应元素的反正弦值(以弧度为单位)。

示例:arcsin() 函数的基本用法

在下面的示例中，我们使用 arcsin() 函数计算一维数组中每个元素的反正弦值 -

import numpy as np

# 创建一个值介于 -1 和 1 之间的一维数组
arr = np.array([-1, -0.5, 0, 0.5, 1])

# 对每个元素应用反正弦
result = np.arcsin(arr)
print(result)

输出结果为 −

[-1.57079633 -0.52359878  0.          0.52359878  1.57079633]

示例:以度为单位的角度的反正弦

在本例中，我们首先计算弧度的反正弦，然后使用 numpy.degrees() 函数将结果转换为度数 −

import numpy as np

# 创建一个介于 -1 和 1 之间的数组
values = np.array([-1, -0.5, 0, 0.5, 1])

# 计算弧度的反正弦
radians_result = np.arcsin(values)

# 将弧度转换为度数
degrees_result = np.degrees(radians_result)
print(degrees_result)

这将产生以下结果 -

[-90. -30. 0.  30.  90.]

示例:单个标量值的反正弦

在本例中，我们使用 arcsin() 函数计算单个标量值的反正弦 -

import numpy as np

# 标量值
scalar = 0.5

# 对标量应用反正弦
result = np.arcsin(scalar)
print(result)

得到的输出为 -

0.5235987755982989

示例:处理超出范围的值

在本例中，我们尝试计算对超出有效范围 [-1, 1] 的值进行反正弦运算。这将引发运行时警告，并返回 NaN 值 -

import numpy as np

# 值超出有效范围的数组
arr_out_of_range = np.array([2, -1.5, 0])

# 对数组应用反正弦
result = np.arcsin(arr_out_of_range)
print(result)

这将产生以下结果并引发运行时警告 -

/home/cg/root/673ae90fcf07d/main.py:7: RuntimeWarning: invalid value encountered in arcsin
  result = np.arcsin(arr_out_of_range)
[nan nan  0.]

numpy_trigonometric_functions.html