$atan (agregação)
Nesta página
$atan
Retorna a tangente inversa (tangente arco) de um valor.
$atan
tem a seguinte sintaxe:{ $atan: <expression> } $atan
usa qualquerexpressão válida que resolva para um número.$atan
retorna valores em radianos. Utilize o operador$radiansToDegrees
para converter o valor de saída de radianos para graus.Por padrão,
$atan
retorna valores comodouble
.$atan
também pode retornar valores como um decimal de 128 bits, desde que o<expression>
resolva para um valor decimal de 128 bits.Para mais informações sobre expressões, consulte Operadores de Expressão.
Comportamento
null
e a NaN
Se o argumento for resolvido para um valor de null
ou se referir a um campo ausente, $atan
retornará null
. Se o argumento se resolve em NaN
, $tan
retornará NaN
.
Exemplo | Resultados |
---|---|
{ $atan: NaN } | NaN |
{ $atan: null } | null |
Exemplo
A coleção trigonometry
contém um documento que armazena três lados de um triângulo retângulo:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : NumberDecimal("3"), "side_b" : NumberDecimal("4"), "hypotenuse" : NumberDecimal("5") }
A operação de agregação a seguir usa a expressão $atan
para calcular o ângulo adjacente a side_a
e adicioná-lo ao documento de entrada usando o estágio de pipeline $addFields
.
db.trigonometry.aggregate([ { $addFields : { "angle_a" : { $radiansToDegrees : { $atan : { $divide : [ "$side_b", "$side_a" ] } } } } } ])
A expressão $radiansToDegrees
converte o valor radianos retornado por $atan
para o valor equivalente em graus.
O comando retorna a seguinte saída:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : NumberDecimal("3"), "side_b" : NumberDecimal("4"), "hypotenuse" : NumberDecimal("5"), "angle_a" : NumberDecimal("53.13010235415597870314438744090658") }
Como side_b
e side_a
são armazenados como decimais de 128bits, a saída de $atan
é um decimal de 128bits.
A coleção trigonometry
contém um documento que armazena três lados de um triângulo retângulo:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : NumberDecimal("3"), "side_b" : NumberDecimal("4"), "hypotenuse" : NumberDecimal("5") }
A operação de agregação a seguir usa a expressão $atan
para calcular o ângulo adjacente a side_a
e adicioná-lo ao documento de entrada usando o estágio de pipeline $addFields
.
db.trigonometry.aggregate([ { $addFields : { "angle_a" : { $atan : { $divide : [ "$side_b", "$side_a" ] } } } } ])
O comando retorna a seguinte saída:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "side_a" : NumberDecimal("3"), "side_b" : NumberDecimal("4"), "hypotenuse" : NumberDecimal("5"), "angle_a" : NumberDecimal("0.9272952180016122324285124629224287") }
Como side_b
e side_a
são armazenados como decimais de 128bits, a saída de $atan
é um decimal de 128bits.