$asinhRetorna o seno hiperbólico inverso (seno do arco hiperbólico) de um valor.
$asinhtem a seguinte sintaxe:{ $asinh: <expression> } $asinhusa qualquer expressão válida que resolva para um número.$asinhretorna valores em radianos. Utilize o operador para converter o valor de saída de radianos para$radiansToDegreesgraus.Por padrão , retorna
$asinhvaloresdoublecomo. também pode$asinh128retornar valores como um decimal de bits, desde que o seja<expression>resolvido para um 128valor decimal de bits.Para mais informações sobre expressões, consulte Expressões.
Comportamento
null, NaN e +/- Infinity
Se o argumento for resolvido para um valor de null ou se referir a um campo ausente, $asinh nullretornará. Se o argumento se resolve NaN em, $asinh NaNretorna. Se o argumento resolver para infinito negativo ou positivo, retornará infinito negativo ou positivo$asinh respectivamente.
Exemplo | Resultados |
|---|---|
|
|
|
|
|
|
|
|
Exemplo
A coleção trigonometry contém um documento que armazena um valor ao longo do eixo x de um gráfico 2-D:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : Decimal128("1") }
A operação de agregação a seguir usa a expressão para calcular o seno hiperbólico inverso $asinh de x-coordinate e adicioná-lo ao documento de entrada usando o estágio de pipeline.$addFields
db.trigonometry.aggregate([ { $addFields : { "y-coordinate" : { $radiansToDegrees : { $asinh : "$x-coordinate" } } } } ])
A expressão converte o $radiansToDegrees $asinh valor radianos retornado por para o valor equivalente em graus.
O comando retorna a seguinte saída:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : Decimal128("1"), "y-coordinate" : Decimal128("50.49898671052621144221476300417157") }
Como x-coordinate é armazenado como um 128decimal de bits, a saída de é $asinh um 128decimal de bits.
A coleção trigonometry contém um documento que armazena um valor ao longo do eixo x de um gráfico 2-D:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : Decimal128("1") }
A operação de agregação a seguir usa a expressão para calcular o seno hiperbólico inverso $asinh de x-coordinate e adicioná-lo ao documento de entrada usando o estágio de pipeline.$addFields
db.trigonometry.aggregate([ { $addFields : { "y-coordinate" : { $asinh : "$x-coordinate" } } } ])
O comando retorna a seguinte saída:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : Decimal128("1"), "y-coordinate" : Decimal128("1.818446459232066823483698963560709") }
Como x-coordinate é armazenado como um 128decimal de bits, a saída de é $asinh um 128decimal de bits.