MongoDB $ atan2

MongoDBでは、$atan2 集計パイプライン演算子は、ある値を別の値で割ったアークタンジェント（逆タンジェント）を返します。

配列で2つの値を指定します。 $atan2に提供される2つの値のそれぞれ数値に解決される任意の有効な式にすることができます。

戻り値はラジアンです。

$atan2 演算子はMongoDB4.2で導入されました。

例

dataというコレクションがあるとします。次のドキュメントで：

{ "_id" : 1, "a" : 2, "b" : 3 }

$atan2を使用できます aのアークタンジェントを返す演算子フィールドをbで割った値フィールド：

db.data.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" ] }
      }
    }
  ]
)

結果：

{ "arctangent" : 0.5880026035475675 }

度に変換

前述のように、$atan2 結果をラジアンで返します。 $radiansToDegreesを使用できます結果を度で表示したい場合は演算子。

例：

db.data.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        radians: { $atan2: [ "$a", "$b" ] },
        degrees: { $radiansToDegrees: { $atan2: [ "$a", "$b" ] } }
      }
    }
  ]
)

結果：

{ "radians" : 0.5880026035475675, "degrees" : 33.690067525979785 }

この例では、最初のフィールドは結果をラジアンで表示し、2番目のフィールドは結果を度で表示します。

128ビットの10進値

デフォルトでは、$atan2 演算子は値をdoubleとして返します、ただし、式が128ビットの10進数値に解決される限り、128ビットの10進数として値を返すこともできます。

これは、式の1つだけが128ビットの10進数である場合でも当てはまります。

コレクションに次のドキュメントを追加するとします。

{ "_id" : 2, "a" : NumberDecimal("1.1301023541559787031443874490659"), "b" : NumberDecimal("2.1301023541559787031443874490659") }
{ "_id" : 3, "a" : 2, "b" : NumberDecimal("2.1301023541559787031443874490659") }
{ "_id" : 4, "a" : NumberDecimal("2.1301023541559787031443874490659"), "b" : 2 }

$atan2を実行してみましょうそれらのドキュメントに対するオペレーター：

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" ] }
      }
    }
  ]
)

結果：

{ "arctangent" : NumberDecimal("0.4877792766738730791507215461936449") }
{ "arctangent" : NumberDecimal("0.7539075768401526572881006364456838") }
{ "arctangent" : NumberDecimal("0.8168887499547439619432210551940676") }

いずれの場合も、出力は128ビットの10進数です。

ヌル値

ヌル値はnullを返します $atan2を使用する場合オペレーター。これは、式の1つだけがnullであっても当てはまります。。

コレクションに次のドキュメントを追加するとします。

{ "_id" : 5, "a" : null, "b" : 2 }
{ "_id" : 6, "a" : 2, "b" : null }
{ "_id" : 7, "a" : 2, "null" : null }

$atan2を実行してみましょうそれらのドキュメントに対するオペレーター：

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 5, 6, 7 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" ] }
      }
    }
  ]
)

結果：

{ "arctangent" : null }
{ "arctangent" : null }
{ "arctangent" : null }

結果がnullであることがわかりますすべての場合。

NaN値

引数がNaNに解決された場合、$atan2 NaNを返します。

例：

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a" * 1, "$b" ] }
      }
    }
  ]
)

結果：

{ "arctangent" : NumberDecimal("NaN") }
{ "arctangent" : NumberDecimal("NaN") }
{ "arctangent" : NaN }

フィールドbを乗算するように、少し変更してみましょう。フィールドaの代わりに。

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" * 1 ] }
      }
    }
  ]
)

結果：

{ "arctangent" : NumberDecimal("NaN") }
{ "arctangent" : NaN }
{ "arctangent" : NumberDecimal("NaN") }

それでは、両方のフィールドを乗算してみましょう。

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a" * 1, "$b" * 1 ] }
      }
    }
  ]
)

結果：

{ "arctangent" : NaN }
{ "arctangent" : NaN }
{ "arctangent" : NaN }

存在しないフィールド

$atan2の場合存在しないフィールド、nullに対して演算子が適用されます返されます。

例：

db.data.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        result: { $atan2: [ "$a", "$name" ] }
      }
    }
  ]
)

結果：

{ "result" : null }