$sinh (aggregation)
$sinh
Returns the hyperbolic sine of a value that is measured in radians.
$sinh
has the following syntax:{ $sinh: <expression> } $sinh
takes any valid expression that resolves to a number, measured in radians. If the expression returns a value in degrees, use the$degreesToRadians
operator to convert the value to radians.By default
$sinh
returns values as adouble
.$sinh
can also return values as a 128-bit decimal if the<expression>
resolves to a 128-bit decimal value.For more information on expressions, see Expressions.
Behavior
null
, NaN
, and +/- Infinity
If the input argument resolves to a value of null
or refers to a
field that is missing, $sinh
returns null
. If the
argument resolves to NaN
, $sinh
returns NaN
. If
the argument resolves to negative or positive Infinity
,
$sinh
returns negative or positive Infinity
respectively.
Example | Results |
---|---|
|
|
|
|
|
|
|
|
Example
The following trigonometry
collection contains a document
that stores an angle
value measured in degrees:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d25" ), "angle" : NumberDecimal( "53.1301023541559787031443874490659" ) } )
The following aggregation operation uses the
$sinh
expression to calculate the hyperbolic sine
of angle
and adds it to the input document using the
$addFields
pipeline stage:
db.trigonometry.aggregate( [ { $addFields : { "sinh_output" : { $sinh : { $degreesToRadians : "$angle" } } } } ] )
The $degreesToRadians
expression converts the
angle
in degrees to radians.
Example output:
{ "_id" : ObjectId("5c50782193f833234ba90d25"), "angle" : NumberDecimal("53.1301023541559787031443874490659"), "sinh_output" : NumberDecimal("1.066020404405732132503284522731829") }
Because angle
is stored as a 128-bit decimal, the $sinh
output is also a
128-bit decimal.
The following trigonometry
collection contains a document
that stores an angle
value measured in radians:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d35" ), "angle" : NumberDecimal( "1.6301023541559787031443874490659" ) } )
The following aggregation operation uses the
$sinh
expression to calculate the hyperbolic sine
of angle
and adds it to the input document using the
$addFields
pipeline stage:
db.trigonometry.aggregate( [ { $addFields : { "sinh_output" : { $sinh : "$angle" } } } ] )
Example output:
{ "_id" : ObjectId("5c50782193f833234ba90d35"), "angle" : NumberDecimal("1.6301023541559787031443874490659"), "sinh_output" : NumberDecimal("2.454243813557362033961729701069671") }
Because angle
is stored as a 128-bit decimal, the $sinh
output is also
a 128-bit decimal.