En MongoDB, el $asin
El operador de canalización de agregación devuelve el arcoseno (seno inverso) de un valor, medido en radianes.
$asin
acepta cualquier expresión válida que se resuelva en un número entre -1
y 1
.
El $asin
El operador se introdujo en MongoDB 4.2.
Ejemplo
Supongamos que tenemos una colección llamada test
con el siguiente documento:
{ "_id" : 1, "data" : 0.5 }
Podemos usar el $asin
operador para devolver el arcocoseno de los data
campo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
{ "arcsine" : 0.5235987755982988 }
De forma predeterminada, $asin
el operador devuelve valores como double
, pero también puede devolver valores como un decimal de 128 bits siempre que la expresión se resuelva en un valor decimal de 128 bits.
Convertir a Grados
Como se mencionó, $asin
devuelve su resultado en radianes. Puede usar el $radiansToDegrees
operador si desea el resultado en grados.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
radians: { $asin: "$data" },
degrees: { $radiansToDegrees: { $asin: "$data" } }
}
}
]
)
Resultado:
{ "radians" : 0.5235987755982988, "degrees" : 29.999999999999996 }
En este ejemplo, el primer campo presenta el resultado en radianes y el segundo campo lo presenta en grados.
Valores decimales de 128 bits
Si la expresión proporcionada a $asin
es decimal de 128 bits, entonces el resultado se devuelve en decimal de 128 bits.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" : 2, "data" : NumberDecimal("0.1301023541559787031443874490659") }
Ejecutemos el $asin
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
{ "arcsine" : NumberDecimal("0.1304722105697547116336288178856500") }
La salida es decimal de 128 bits.
Valores nulos
Los valores nulos devuelven null
cuando se usa el $asin
operador.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" : 3, "data" : null }
Ejecutemos el $asin
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
{ "arcsine" : null }
Podemos ver que el resultado es null
.
Valores NaN
Si el argumento se resuelve en NaN
, $asin
devuelve NaN
.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
arcsine: { $asin: 1 * "String" }
}
}
]
)
Resultado:
{ "arcsine" : NaN }
En este caso, la expresión intentó multiplicar un número por una cadena, lo que resultó en NaN
siendo devuelto.
Infinito
Si el argumento se resuelve en Infinity
o -Infinity
, el $asin
operador devuelve un error.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" : 4, "data" : Infinity }
Ejecutemos $asin
contra el campo de datos:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $asin to inf, value must in [-1,1]", "code" : 50989, "codeName" : "Location50989" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
Ese es el error que me sale en mongo
shell al ejecutar ese código.
Campos Inexistentes
Si el $asin
el operador se aplica a un campo que no existe, null
es devuelto.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$wrong" }
}
}
]
)
Resultado:
{ "arcsine" : null }
Valores fuera de rango
Proporcionar un valor fuera de rango a $asin
resultará en un error. Ya hemos visto lo que sucede cuando proporcionamos Infinity
a $asin
. Ahora usemos un valor más realista, como, por ejemplo, 2
.
Supongamos que agregamos el siguiente documento a la colección:
{ "_id" : 5, "data" : 2 }
Ahora ejecutemos $asin
contra los data
campo:
db.test.aggregate(
[
{ $match: { _id: 5 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $asin to 2, value must in [-1,1]", "code" : 50989, "codeName" : "Location50989" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
Como indica el mensaje de error, el valor debe estar entre -1
y 1
.