/ /

$atan2 (operador de expresión)

$atan2

Devuelve la tangente inversa (arco tangente) de y / x, donde y y x son el primer y segundo valor pasados a la expresión respectivamente.

$atan2 tiene la siguiente sintaxis:

{ $atan2: [ <expression 1>, <expression 2> ] }

$atan2 toma cualquier válido expresión que se resuelve en un número.

$atan2 devuelve valores en radianes. Utilice el operador para convertir el valor de salida de radianes a $radiansToDegrees grados.

De forma predeterminada, devuelve $atan2 valores double como. también puede$atan2 128devolver valores como un decimal de bits siempre que se <expression> resuelva en un 128valor decimal de bits.

Para obtener más información sobre las expresiones, consulta Expresiones.

Comportamiento

`null` y `NaN`

Si alguno de los argumentos dados a $atan2 es null, la expresión devuelve null. Si alguno de los argumentos es NaN, la expresión devuelve NaN. Si un argumento es null y el otro es NaN, la expresión devuelve null.

Ejemplo	Resultados
`{ $atan2: [ NaN, <value> ] }`	`NaN`
`{ $atan2: [ <value>, NaN ] }`	`NaN`
`{ $atan2: [ null, <value> ] }`	`null`
`{ $atan2: [ <value>, null ] }`	`null`
`{ $atan2: [ NaN, null ] }`	`null`
`{ $atan2: [ null, NaN ] }`	`null`

Ejemplo

La colección trigonometry contiene un documento que almacena tres lados de un triángulo rectángulo:

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : Decimal128("3"),
  "side_b" : Decimal128("4"),
  "hypotenuse" : Decimal128("5")
}

La siguiente operación de agregación utiliza la expresión para calcular el ángulo adyacente $atan2 a side_a y agregarlo al documento $addFields de entrada utilizando la etapa de canalización.

db.trigonometry.aggregate([
  {
    $addFields : {
      "angle_a" : {
        $radiansToDegrees : {
          $atan2 : [ "$side_b", "$side_a" ]
        }
      }
    }
  }
])

La expresión convierte $radiansToDegrees $atan2 el valor en radianes devuelto por al valor equivalente en grados.

El comando devuelve la siguiente salida:

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : Decimal128("3"),
  "side_b" : Decimal128("4"),
  "hypotenuse" : Decimal128("5"),
  "angle_a" : Decimal128("53.13010235415597870314438744090658")
}

Dado side_b que y side_a se almacenan como 128decimales de bits, la salida de es $atan2 un 128decimal de bits.

La colección trigonometry contiene un documento que almacena tres lados de un triángulo rectángulo:

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : Decimal128("3"),
  "side_b" : Decimal128("4"),
  "hypotenuse" : Decimal128("5")
}

db.trigonometry.aggregate([
  {
    $addFields : {
      "angle_a" : {
        $atan2 : [ "$side_b", "$side_a" ]
      }
    }
  }
])

El comando devuelve la siguiente salida:

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : Decimal128("3"),
  "side_b" : Decimal128("4"),
  "hypotenuse" : Decimal128("5"),
  "angle_a" : Decimal128("0.9272952180016122324285124629224287")
}

Dado side_b que y side_a se almacenan como 128decimales de bits, la salida de es $atan2 un 128decimal de bits.

Volver

$atan

$atanh

Comportamiento

null y NaN

Ejemplo

`null` y `NaN`