Python math.atanh() 方法

---

---

Python 的 math.atanh() 方法返回给定数字的反双曲正切值。

反双曲正切方法，记作 tanh^-1(x) 或有时记作 artanh(x)，是一种数学方法，用于检索其双曲正切值为给定数字 x 的值。换句话说，如果您有一个介于 -1 和 1 之间的数值 x，反双曲正切方法将返回其双曲正切等于 x 的数字。

数学上，这表示为：

tanh-1(x) = value y such that tanh(y) = x

反双曲正切方法的定义域限制在区间 (-1, 1)，因为双曲正切方法的值域也是 (-1, 1)。反双曲正切方法的输出将始终为实数。

语法

以下是 Python math.atanh() 方法的基本语法：

math.atanh(x)

参数

此方法接受一个在 (-1 到 1) 范围内的数字作为参数，您需要为此数字求反双曲正切值。

返回值

此方法返回给定数字在 (-∞, ∞) 范围内的反双曲正切值。

示例 1

0 的双曲正切为 0。因此，当我们将 0 作为参数传递给 math.atanh() 方法时，它返回 0.0：

import math
x = 0
result = math.atanh(x)
print(result) 

输出

获得的输出如下：

0.0

示例 2

如果我们将分数值传递给 math.atanh() 方法，它将返回一个实数：

import math
from fractions import Fraction
x = Fraction(5, -9)
result = math.atanh(x)
print(result) 

输出

以上代码的输出如下：

-0.626381484247684

示例 3

在这里，我们使用 math.atanh() 方法获取负数的反双曲正切值：

import math
x = -0.5
result = math.atanh(x)
print(result)  

输出

我们得到如下所示的输出：

-0.5493061443340548

示例 4

当我们将一个较大的数字传递给 math.atanh() 方法时，它会导致域错误，因为反双曲正切方法仅针对 -1 到 1（不包括）之间的数字定义：

import math
x = 1000
result = math.atanh(x)
print(result) 

输出

产生的结果如下所示：

Traceback (most recent call last):
  File "/home/cg/root/65fbd333dfa67/main.py", line 3, in <module>
result = math.atanh(x)
ValueError: math domain error