Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

log

Natural logarithm

Syntax

Description

example

Y = log(X) returns the natural logarithm ln(x) of each element in array X.

The log function's domain includes negative and complex numbers, which can lead to unexpected results if used unintentionally. For negative and complex numbers z = u + i*w, the complex logarithm log(z) returns

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

If you want negative and complex numbers to return error messages rather than return complex results, use reallog instead.

Examples

collapse all

Show that the natural logarithm of -1 is $i \pi$.

log(-1)
ans =

   0.0000 + 3.1416i

Input Arguments

collapse all

Input array, specified as a scalar, vector, matrix, or multidimensional array.

Data Types: single | double
Complex Number Support: Yes

Output Arguments

collapse all

Logarithm values, returned as a scalar, vector, matrix, or multidimensional array.

For positive real values of X in the interval (0, Inf), Y is in the interval (-Inf,Inf). For complex and negative real values of X, Y is complex. The data type of Y is the same as that of X.

More About

collapse all

Tall Array Support

This function fully supports tall arrays. For more information, see Tall Arrays.

See Also

| | | | | | | |

Introduced before R2006a

Was this topic helpful?