LN

Syntaxe

Paramètres

Description

Cette fonction permet de demander le logarithme naturel de la valeur spécifié.

Remarques

• Calcul du logarithme naturel en base e : La fonction LN calcule le logarithme naturel, c'est-à-dire le logarithme en base e (environ 2,718). C'est une opération courante en mathématiques, notamment en analyse, en statistiques, et en modélisation exponentielle. Elle permet de transformer des données multiplicatives en données additives.
• La valeur d'entrée doit être strictement positive : Le paramètre X doit obligatoirement être supérieur à zéro. Si l'on fournit une valeur négative ou nulle, la fonction renvoie NULL ou provoque une erreur. Il est donc recommandé de filtrer ou valider les données avant d'appliquer LN.
• Très utilisée en science des données et en modélisation : LN est souvent utilisée pour normaliser des distributions, notamment lorsque les données suivent une croissance exponentielle (exemple : revenus, population,...). Elle permet aussi de linéariser certaines relations non linéaires pour les rendre exploitables dans des modèles statistiques.
• Différence avec LOG10 et LOG : Il ne faut pas confondre LN, qui utilise la base e, avec LOG10, utilisant la base 10. BigQuery propose également LOG(X, base) pour spécifier une base personnalisée. Le choix de la base dépend du domaine d'application : e est courant en mathématiques pures, 10 est souvent utilisé en ingénierie.
• Retourne un résultat de type FLOAT64 : Le résultat de la fonction LN est toujours un nombre flottant (FLOAT64), même si l'entrée est un entier. Cela permet d'effectuer des calculs précis avec une grande variété de types numériques, mais peut nécessiter un formatage si une sortie entière est attendue.
• Peut être combinée avec EXP pour inverser l'opération : LN et EXP sont deux fonctions inverses : EXP(LN(x)) = x et LN(EXP(x)) = x, pour les valeurs valides. Cette propriété est utile pour encoder/décoder des transformations logarithmiques dans des équations mathématiques ou des modèles.
• Attention aux données nulles ou invalides : Si la valeur fournie est NULL, la fonction LN retourne également NULL, ce qui peut fausser les calculs si ces cas ne sont pas traités explicitement. Il est bon d'utiliser des fonctions comme IFNULL ou SAFE.LN si l'on veut éviter les interruptions de requête.
• Utile pour des transformations log-log ou log-lin : En visualisation de données ou en analyse de régression, LN est souvent utilisée pour produire des échelles logarithmiques. Cela permet de mieux observer des relations de proportion, de croissance, ou des données à grande échelle avec moins de distorsion visuelle.