$ln (operador de expresión)

Definición

$ln

Calcula el logaritmo natural ln (es decir, log e) de un número y devuelve el resultado como doble.

$ln tiene la siguiente sintaxis:

{ $ln: <number> }

La expresión <number> puede ser cualquier valor válido. Expresión siempre que se resuelva en un número no negativo. Para más información sobre expresiones, consulte Expresiones.

$ln es equivalente a la $log: [ <number>, Math.E ] expresión, donde Math.E es una representación de JavaScript para el número e de Euler.

Comportamiento

El tipo de retorno por defecto es un double. Si al menos un operando es un decimal, entonces el tipo de retorno es un decimal.

Si el argumento se resuelve en un valor de null o hace referencia a un campo que falta, $ln devuelve null. Si se resuelve en NaN, $ln devuelve NaN.

Ejemplo

Una colección sales contiene los siguientes documentos:

db.sales.insertMany( [
   { _id: 1, year: "2000", sales: 8700000 },
   { _id: 2, year: "2005", sales: 5000000 },
   { _id: 3, year: "2010", sales: 6250000 }
] )

El siguiente ejemplo transforma los datos sales:

db.sales.aggregate( [ { $project: { x: "$year", y: { $ln: "$sales"  } } } ] )

La operación devuelve los siguientes resultados:

{ "_id" : 1, "x" : "2000", "y" : 15.978833583624812 }
{ "_id" : 2, "x" : "2005", "y" : 15.424948470398375 }
{ "_id" : 3, "x" : "2010", "y" : 15.648092021712584 }