⋮

2026a

# log

自然对数

# 语法

Y = log(X)

# 说明

Y = log(X) 返回数组 X 中每个元素的自然对数。对于 X 的复数元素，log(X) 生成复数结果。对于 X 的负元素，log(X)会报错。复数对数 log(z) 返回 log(abs(z)) + 1im*angle(z)。同样可以使用log计算矩阵指数。示例

如果您希望复数输入返回错误消息而不是复数结果，请改用 reallog。

# 示例

复数的自然对数

显示 -1 + 0im 的自然对数是 iπ。

log(-1 + 0im)

ans = 0.0 + 3.141592653589793im

# 输入参数

X - 输入数组

标量 | 向量 | 矩阵 | 多维数组

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

提示

当 X 是方阵时：

log(X) 是矩阵求自然对数，使用线性代数的方法计算，适用于整个矩阵结构；
log.(X) 是逐元素求自然对数，对矩阵中的每个元素单独应用标量自然对数函数。

因此，log(X) 和 log.(X) 的结果不同，是因为它们处理矩阵的方式和目的不同。

数据类型： Int64 | Int32 | Int16 | Int128 | Float16 | Float32 | Float64

复数支持： 是

# 输出参数

Y - 指数值

标量 | 向量 | 矩阵 | 多维数组

指数值，以标量、向量、矩阵或多维数组的形式返回。

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

# 另请参阅

log1p | log2 | log10 | exp | reallog

log 自然对数语法说明 Y = log(X) 返回数组 X 中每个元素的自然对数 $ln(x)$。对于 X 的复数元素，log(X) 生成复数结果。对于 X 的负元素，log(X)会报错。复数对数 log(z) 返回 log(abs(z)) + 1im*angle(z)。同样可以使用log计算矩阵指数。示例如果您希望复数输入返回错误消息而不是复数结果，请改用 reallog。示例复数的自然对数显示 -1 + 0im 的自然对数是 iπ。输入参数 X - 输入数组标量向量矩阵多维数组输入数组，指定为标量、向量、矩阵或多维数组。 :::tip 提示当 X 是方阵时：是矩阵求自然对数，使用线性代数的方法计算，适用于整个矩阵结构；是逐元素求自然对数，对矩阵中的每个元素单独应用标量自然对数函数。因此，和的结果不同，是因为它们处理矩阵的方式和目的不同。 ::: 数据类型： Int64 Int32 Int16 Int128 Float16 Float32 Float64 复数支持：是输出参数 Y - 指数值标量向量矩阵多维数组指数值，以标量、向量、矩阵或多维数组的形式返回。对于 X 在区间 (0, Inf) 中的正实数值，Y 位于区间 (-Inf,Inf) 中。对于 X 的复数值，Y 为复数。Y 与 X 具有相同的数据类型。另请参阅 log1p log2 log10 exp reallog