log

R2026b

Logarithme naturel

Syntaxe

Y = log(X)

Description

Y = log(X) renvoie le logarithme naturel ln(x) pour chaque élément dans un tableau X.

Le domaine de la fonction log inclut des nombres négatifs et complexes, ce qui peut produire des résultats inattendus en cas d’utilisation involontaire. Pour les nombres négatifs et complexes z = u + i*w, le logarithme complexe log(z) renvoie

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

Si vous souhaitez que les nombres négatifs et complexes renvoient des messages d’erreur plutôt que des résultats complexes, utilisez plutôt reallog.

Exemples

Logarithme naturel d’un nombre négatif

Démontrez que le logarithme naturel de -1 est $$i\pi$$.

log(-1)

ans = 
0.0000 + 3.1416i

Arguments d'entrée

X — Tableau en entrée

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Tableau en entrée, spécifié sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable.

Types de données : single | double | table | timetable
Support des nombres complexes : Oui

Arguments de sortie

Y — Valeurs de logarithme

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Valeurs de logarithme, renvoyées sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable.

Pour des valeurs réelles positives de X dans l’intervalle (0, Inf), Y se trouve dans l’intervalle (-Inf, Inf). Pour des valeurs réelles complexes et négatives de X, Y est complexe. Le type de données de Y est le même que celui de X.

Capacités étendues

Tall arrays

Calculer avec des arrays possédant plus de rangées que la mémoire ne peut en contenir.

La fonction log supporte entièrement les tall arrays. Pour plus d’informations, consultez Tall array.

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Lorsque la valeur d’entrée x est réelle, mais que la sortie devrait être complexe, la simulation se termine par une erreur. Pour produire le résultat complexe, rendez la valeur en entrée complexe en la passant par complex(x).

Génération de code GPU

Générez du code CUDA® pour les GPU NVIDIA® avec GPU Coder™.

Notes d’usage et limitations :

• Lorsque la valeur d’entrée x est réelle, mais que la sortie devrait être complexe, la simulation se termine par une erreur. Pour produire le résultat complexe, rendez la valeur en entrée complexe en la passant par complex(x).

Génération de code HDL

Générez du code VHDL, Verilog et SystemVerilog pour les designs FPGA et ASIC avec HLD Coder™.

La fonction log supporte la génération de code HDL en virgule flottante native pour les types de données single et double. Pour plus d’informations, consultez Support for Functions in Math Function Block (HDL Coder).

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

La fonction log supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction log supporte les GPU arrays avec les notes d’usage et limitations suivantes :

• Si la sortie de la fonction exécutée sur le GPU peut être complexe, vous devez explicitement spécifier que ses arguments en entrée sont complexes. Pour plus d’informations, consultez Work with Complex Numbers on a GPU (Parallel Computing Toolbox).

Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

La fonction log supporte entièrement les distributed arrays. Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

R2026a: Amélioration des performances en double précision

La fonction log est plus performante lorsqu’elle calcule des logarithmes naturels en double précision. Par exemple, le code suivant calcule les logarithmes naturels de 100 000 000 nombres réels dans l’intervalle de 0 à 1 000. Le code est environ 2,8 fois plus rapide que dans les versions précédentes.

function t = timingLog
x = rand(1,1e8)*1000;
y = @() log(x);
t = timeit(y);
end

Les temps d’exécution approximatifs sont les suivants :

R2025a : 0,79 s

R2026a : 0,28 s

Le code a été chronométré sur un système de test Windows^® 11 équipé d’un processeur AMD EPYC™ 74F3 24 cœurs à 3,19 GHz avec un appel de la fonction timingLog.

Considérations liées à la compatibilité

Cette amélioration des performances découle de modifications de code qui entraînent également un comportement légèrement différent pour les arrondis en double précision, ce qui donne des résultats généralement plus précis. Par exemple, le code suivant envoie un résultat plus précis jusqu’au 15e chiffre après la virgule décimale, en notation scientifique longue.

format longE
Y = log(1.63340913276288)

Y =
     4.906693231856701e-01

Auparavant, ce même code renvoyait le résultat suivant.

format longE
Y = log(1.63340913276288)

Y =
     4.906693231856700e-01

Notez que MATLAB^® convertit un nombre décimal en entrée tel que 1.63340913276288 vers la valeur binaire double précision la plus proche pouvant être représentée, laquelle peut ne pas être exactement égale à l’entrée décimale d’origine. Pour cette raison, même si la fonction log est désormais plus précise en double précision, le résultat peut être différent de celui d’un calcul effectué avec la représentation exacte de l’entrée.

R2023a: Effectuer des calculs directement dans les tableaux et les timetables

La fonction log peut procéder au calcul sur toutes les variables au sein d’un tableau ou d’une timetable sans indexation pour accéder à ces variables. Toutes les variables doivent avoir des types de données qui supportent les calculs. Pour plus d’informations, consultez Direct Calculations on Tables and Timetables.

Voir aussi

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