atanh

反双曲正切

全页折叠

语法

Y = atanh(X)

说明

Y = atanh(X) 返回 X 的元素的反双曲正切。该函数同时接受实数和复数输入。所有的角度都以弧度表示。

示例

全部折叠

向量的反双曲正切

打开实时脚本

计算向量 X 的各元素的反双曲正切。atanh 函数按元素处理 X。

X = [2 -3 1+2i];
Y = atanh(X)

Y = 1×3 complex

   0.5493 + 1.5708i  -0.3466 - 1.5708i   0.1733 + 1.1781i

绘制反双曲正切函数

打开实时脚本

在区间 $- 1 < x < 1$ 上绘制反双曲正切函数。

x = -0.99:0.01:0.99; 
plot(x,atanh(x))
grid on
xlabel('x')
ylabel('atanh(x)')

Figure contains an axes object. The axes object with xlabel x, ylabel atanh(x) contains an object of type line.

输入参数

全部折叠

`X` — 角的双曲正切
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

角的双曲正切，指定为标量、向量、矩阵、多维数组、表或时间表。如果 X 为非标量，则按元素执行 atanh 运算。

数据类型: single | double | table | timetable
复数支持: 是

详细信息

全部折叠

反双曲正切

对于域 $- 1 < x < 1$ 中的实数值 $x$ ，反双曲正切满足

$\tanh^{- 1} (x) = \frac{1}{2} \log (\frac{1 + x}{1 - x}) .$

对于复数 $z = x + i y$ 以及区域 $- \infty < z < - 1$ 和 $1 < z < \infty$ 中的实数值，调用 atanh(z) 将返回复数结果。

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

atanh 函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

当输入值 x 为实数而输出应为复数时，将在仿真过程中生成错误并在生成的代码中返回 NaN。要得到复数结果，需要通过传入 complex(x) 使输入值变成复数。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

atanh 函数支持 GPU 数组输入，但有以下用法说明和限制：

如果在 GPU 上运行的函数的输出可能为复数，则必须将其输入参量显式指定为复数。有关详细信息，请参阅在 GPU 上处理复数 (Parallel Computing Toolbox)。

有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部展开

R2023a: 直接对表和时间表执行计算

atanh 函数可以对表或时间表中的所有变量执行计算，而无需通过索引访问这些变量。所有变量都必须具有支持计算的数据类型。有关详细信息，请参阅Direct Calculations on Tables and Timetables。

另请参阅

atan2 | atan | tanh | asinh | acosh

atanh

语法

说明

示例

向量的反双曲正切

绘制反双曲正切函数

输入参数

X — 角的双曲正切 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

详细信息

反双曲正切

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2023a: 直接对表和时间表执行计算

另请参阅

`X` — 角的双曲正切
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

tall 数组
对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。