MongoDB $atan2

No MongoDB, o $atan2 operador de pipeline de agregação retorna o arco tangente (tangente inversa) de um valor dividido por outro.

Você fornece os dois valores em uma matriz. Cada um dos dois valores fornecidos para $atan2 pode ser qualquer expressão válida que resolva para um número.

O valor de retorno está em radianos.

O $atan2 O operador foi introduzido no MongoDB 4.2.

Exemplo

Suponha que tenhamos uma coleção chamada data com o seguinte documento:

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

Podemos usar o $atan2 operador para retornar o arco tangente do a campo dividido pelo b campo:

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

Resultado:

{ "arctangent" : 0.5880026035475675 }

Converter em graus

Como mencionado, $atan2 retorna seu resultado em radianos. Você pode usar o $radiansToDegrees operador se você quiser o resultado em graus.

Exemplo:

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

Resultado:

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

Neste exemplo, o primeiro campo apresenta o resultado em radianos e o segundo campo o apresenta em graus.

Valores decimais de 128 bits

Por padrão, o $atan2 operador retorna valores como um double , mas também pode retornar valores como um decimal de 128 bits, desde que a expressão resolva para um valor decimal de 128 bits.

Este é o caso mesmo quando apenas uma das expressões é decimal de 128 bits.

Suponha que adicionamos os seguintes documentos à nossa coleção:

{ "_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 }

Vamos executar o $atan2 operador contra esses documentos:

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

Resultado:

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

Em todos os casos, a saída é decimal de 128 bits.

Valores nulos

Valores nulos retornam null ao usar o $atan2 operador. Isso é verdade mesmo se a única das expressões for null .

Suponha que adicionamos os seguintes documentos à nossa coleção:

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

Vamos executar o $atan2 operador contra esses documentos:

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

Resultado:

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

Podemos ver que o resultado é null em todos os casos.

Valores NaN

Se o argumento for resolvido para NaN , $atan2 retorna NaN .

Exemplo:

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

Resultado:

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

Vamos mudar um pouco, para que multipliquemos o campo b em vez do campo a .

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

Resultado:

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

E agora vamos multiplicar os dois campos:

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

Resultado:

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

Campos inexistentes

Se o $atan2 operador é aplicado em um campo que não existe, null é devolvido.

Exemplo:

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

Resultado:

{ "result" : null }