log

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).

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.

Cette fonction 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™.

Cette fonction 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

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