log1p

Calcular el logaritmo natural de 1+X de manera precisa para valores pequeños de X

Sintaxis

Y = log1p(X)

Descripción

Y = log1p(X) calcula el logaritmo natural log(1+X) de cada elemento en el arreglo X sin calcular 1+X explícitamente. Si X < -1, Y es complejo. Esta función es más precisa para valores reales pequeños de X porque compensa el error de redondeo en 1+X.

Ejemplos

Logaritmo natural de 1+X para valores pequeños de X

Compare la precisión de log(1+X) y log1p(X).

Cree un vector de valores reales pequeños.

X = [-1e-16 1e-15 2e-14]

X = 1×3
10-13 ×

   -0.0010    0.0100    0.2000

Calcule el logaritmo natural de 1+X mediante la función log.

Y = log(1+X)

Y = 1×3
10-13 ×

   -0.0011    0.0111    0.1998

Los resultados pueden ser ceros o mostrar errores relativamente grandes. Por ejemplo, Y(2) no está cerca de X(2), que es 1e-15.

Y(2)

ans = 
1.1102e-15

Calcule el logaritmo natural de 1+X mediante la función log1p.

Y = log1p(X)

Y = 1×3
10-13 ×

   -0.0010    0.0100    0.2000

En este caso, donde log1p(X) es aproximadamente X, los resultados son más precisos. Por ejemplo, Y(2) está ahora cerca de X(2), que es 1e-15.

Y(2)

ans = 
1.0000e-15

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í

Capacidades ampliadas

Arreglos altos

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

La función log1p 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™.

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

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 log1p 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 log1p 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

log | expm1