log

Logaritmo natural

Sintaxis

Y = log(X)

Descripción

Y = log(X) devuelve el logaritmo natural ln(x) de cada elemento del arreglo X.

El dominio de la función log incluye números negativos y complejos, lo que puede dar lugar a resultados inesperados si se utiliza involuntariamente. Para los números negativos y complejos z = u + i*w, el logaritmo complejo log(z) devuelve

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

Si desea que los números negativos y complejos devuelvan mensajes de error en lugar de resultados complejos, utilice reallog en su lugar.

Ejemplos

Logaritmo natural de un número negativo

Muestre que el logaritmo natural de -1 es $$i\pi$$.

log(-1)

ans = 
0.0000 + 3.1416i

Argumentos de entrada

X — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Arreglo de entrada, especificado como escalar, vector, matriz, arreglo multidimensional, tabla u horario.

Tipos de datos: single | double | table | timetable
Soporte de números complejos: Sí

Argumentos de salida

Y — Valores del logaritmo

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Valores del logaritmo, devueltos como escalar, vector, matriz, arreglo multidimensional, tabla u horario.

Para los valores reales positivos de X en el intervalo (0, Inf), Y está en el intervalo (-Inf,Inf). Para los valores reales complejos y negativos de X, Y es complejo. El tipo de datos de Y es el mismo que el de X.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función log es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Cuando el valor de entrada x es real, pero la salida debería ser compleja, la simulación finaliza con un error. Para producir el resultado complejo, convierta el valor de entrada en complejo pasándolo a complex(x).

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• Cuando el valor de entrada x es real, pero la salida debería ser compleja, la simulación finaliza con un error. Para producir el resultado complejo, convierta el valor de entrada en complejo pasándolo a complex(x).

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función log es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Si la salida de la función que se ejecuta en la GPU puede ser compleja, debe especificar explícitamente sus argumentos de entrada como complejos. Para obtener más información, consulte Work with Complex Numbers on a GPU (Parallel Computing Toolbox).

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2023a: Realizar cálculos directamente en tablas y horarios

La función log puede realizar cálculos sobre todas las variables de una tabla u horario sin indexar para acceder a dichas variables. Todas las variables deben tener tipos de datos que admitan el cálculo. Para obtener más información, consulte Direct Calculations on Tables and Timetables.

Consulte también

log1p | log2 | log10 | exp | logm | reallog | loglog | semilogx | semilogy