log

自然对数

语法

Y = log(X)

说明

Y = log(X) 返回数组 X 中每个元素的自然对数 ln(x)。

log 函数的域包含负数和复数，如果使用不当，可能会导致意外结果。对于负数和复数 z = u + i*w，复数对数 log(z) 返回

log(abs(z)) + 1i*angle(z)

如果想要负数和复数返回错误消息而不是返回复数结果，改用 reallog。

示例

全部折叠

负数的自然对数

打开实时脚本

显示 -1 的自然对数是 $i π$ 。

log(-1)

ans = 0.0000 + 3.1416i

输入参数

全部折叠

`X` — 输入数组
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

输入数组，指定为标量、向量、矩阵、多维数组、表或时间表。

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

输出参量

全部折叠

`Y` — 对数值
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

对数值，以标量、向量、矩阵、多维数组、表或时间表形式返回。

对于 X 在区间 (0, Inf) 中的正实数值，Y 位于区间 (-Inf,Inf) 中。对于 X 的复数值和负实数值，Y 为复数。Y 与 X 具有相同的数据类型。

扩展功能

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

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

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

用法说明和限制：

当输入值 x 为实数，但输出应为复数时，模拟将结束并返回错误。要得到复数结果，需要通过 complex(x) 来传递输入值，以使其变为复数。

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

用法说明和限制：

当输入值 x 为实数，但输出应为复数时，模拟将结束并返回错误。要得到复数结果，需要通过 complex(x) 来传递输入值，以使其变为复数。

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

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

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

用法说明和限制：

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

有关详细信息，请参阅Run MATLAB Functions on a GPU (Parallel Computing Toolbox)。

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

此函数完全支持分布式数组。有关详细信息，请参阅Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部展开

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

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

另请参阅

log

语法

说明

示例

负数的自然对数

输入参数

X — 输入数组 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

输出参量

Y — 对数值 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

扩展功能

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: 直接对表和时间表执行计算

另请参阅

WeChat

`X` — 输入数组
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

`Y` — 对数值
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

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™ 在集群的组合内存中对大型数组进行分区。