NumPy arccosh() 函数
NumPy arccosh() 函数用于计算输入数组中每个元素的反双曲余弦值(arccosine hyperbolic)。该函数计算输入值作为其双曲余弦值的角(以弧度为单位)。输入值必须大于或等于 1。
- 定义域:该函数接受所有大于或等于 1 的实数作为输入值。它可以处理符合此要求的标量或数组。
- 范围:输出值在 [0, ) 范围内,因为 arccosh 函数只能返回非负值。
语法
以下是 NumPy arccosh() 函数的语法 -
numpy.arccosh(x, /, out=None, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj])
参数
此函数接受以下参数 -
- x: 输入数组或标量。该函数计算数组或标量中每个元素的反双曲余弦值。值必须大于或等于 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 中相应元素的反双曲余弦值(arccosine hyperbolic),以弧度为单位。
示例:arccosh() 函数的基本用法
在下面的示例中,我们使用 arccosh() 函数计算一维数组中每个元素的反双曲余弦值 -
import numpy as np # 创建一维数组 arr = np.array([1, 2, 3, 4]) # 对每个元素应用 arccosh result = np.arccosh(arr) print(result)
输出结果为 −
[0. 1.3169579 1.76274717 2.06343707]
示例:以度为单位的角度反余弦
在本例中,我们首先计算以弧度为单位的反双曲余弦,然后使用 numpy.degrees() 函数将结果转换为度数 −
import numpy as np # 创建值数组 values = np.array([1, 2, 3, 4]) # 计算弧度的反余弦值 radians_result = np.arccosh(values) # 将弧度转换为度数 degrees_result = np.degrees(radians_result) print(degrees_result)
这将产生以下结果 -
[ 0. 75.45612929 100.99797342 118.22623534]
示例:单个标量的反余弦值
在下面的示例中,我们使用 arccosh() 函数计算以下函数的反双曲余弦值单个标量值 −
import numpy as np # 标量值 scalar = 2 # 对标量应用 arccosh result = np.arccosh(scalar) print(result)
得到的输出为 −
1.3169578969248166
示例:小于 1 的值的反余弦值
在此示例中,我们尝试计算小于 1 的值的反双曲余弦值。该函数将返回 RuntimeWarning 并针对小于 1 的输入生成无效结果 −
import numpy as np # 小于 1 的值 invalid_values = np.array([0.5, 0, -1]) # 对数组应用 arccosh result = np.arccosh(invalid_values) print(result)
这将产生以下结果 -
/home/cg/root/6752d9ebbe88d/main.py:7: RuntimeWarning: invalid value encountered in arccoshresult = np.arccosh(invalid_values) [nan nan nan]
numpy_trigonometric_functions.html