MongoDB聚合运算符：$cosh

$cosh聚合运算符用来计算双曲余弦值，返回指定表达式的双曲余弦值。

语法

{ $cosh: <expression> }

• 为可被解析为数值的表达式
• $cosh返回弧度，使用$radiansToDegrees运算符可以把弧度转换为角度
• $cosh默认返回双精度数double，如果表达式解析为128-bit decimal则返回同样类型。

使用

如果参数解析为null或引用不存在的字段，则结果返回null；如果参数解析为NaN，返回NaN；如果参数为负无穷或正无穷，则返回正无穷。如果如下表所示：

示例	结果
{ $cosh: NaN }	NaN
{ $cosh: null }	null
{ $cosh: 正无穷 }	正无穷
{ $cosh: 负无穷 }	正无穷

举例

双曲余弦值角度

trigonometry集合中有下面的文档，包含了以度为单位的角度值：

db.trigonometry.insertOne(
   {
      "_id" : ObjectId( "5c50782193f833234ba90d85" ),
      "angle" : NumberDecimal( "53.1301023541559787031443874490659" )
   }
)

下面的聚合操作使用$radiansToDegrees运算符将angle转换为度数，使用$cosh表达式计算双曲余弦值，然后，最后使用$addFields管道阶段将其添加到输入文档。

db.trigonometry.aggregate( [
   {
      $addFields : {
         "cosh_output" : { $cosh : { $degreesToRadians : "$angle" } }
      }
   }
] )

执行的结果为：

{
   "_id" : ObjectId("5c50782193f833234ba90d85"),
   "angle" : NumberDecimal("53.1301023541559787031443874490659"),
   "cosh_output" : NumberDecimal("1.461642741099671277595921778079396")
}

双曲余弦值弧度

trigonometry集合中有下面的文档，包含了以弧度为单位的角度值：

db.trigonometry.insertOne(
   {
      "_id" : ObjectId( "5c50782193f833234ba90d15" ),
      "angle" : NumberDecimal( "1.6301023541559787031443874490659" )
   }
)

下面的聚合操作使用$cosh表达式计算angle的双曲余弦，然后使用$addFields管道阶段将其添加到输入文档。

db.trigonometry.aggregate([
  {
    $addFields : {
      "side_b" : {
        $multiply : [
          { $cosh : "$angle_a" },
          "$hypotenuse"
        ]
      }
    }
  }
])

结果为：

{
   "_id" : ObjectId("5c50782193f833234ba90d15"),
   "angle" : NumberDecimal("1.6301023541559787031443874490659"),
   "cosh_output" : NumberDecimal("2.650153334504361016712328539738000")
}