In MongoDB, de $atan2
aggregatiepijplijnoperator retourneert de arctangens (inverse tangens) van een waarde gedeeld door een andere.
U geeft de twee waarden op in een array. Elk van de twee waarden geleverd aan $atan2
kan elke geldige uitdrukking zijn die wordt omgezet in een getal.
De geretourneerde waarde is in radialen.
De $atan2
operator werd geïntroduceerd in MongoDB 4.2.
Voorbeeld
Stel dat we een verzameling hebben met de naam data
met het volgende document:
{ "_id" :1, "a" :2, "b" :3 }
We kunnen de $atan2
. gebruiken operator om de arctangens van de a
. te retourneren veld gedeeld door de b
veld:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
arctangent: { $atan2: [ "$a", "$b" ] }
}
}
]
)
Resultaat:
{ "arctangent" :0.5880026035475675 }
Omzetten naar graden
Zoals vermeld, $atan2
geeft het resultaat terug in radialen. U kunt de $radiansToDegrees
. gebruiken operator als u het resultaat in graden wilt.
Voorbeeld:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
radians: { $atan2: [ "$a", "$b" ] },
degrees: { $radiansToDegrees: { $atan2: [ "$a", "$b" ] } }
}
}
]
)
Resultaat:
{ "radialen" :0.5880026035475675, "graden" :33.690067525979785 }
In dit voorbeeld geeft het eerste veld het resultaat weer in radialen en het tweede veld geeft het weer in graden.
128-bits decimale waarden
Standaard is de $atan2
operator retourneert waarden als een double
, maar het kan ook waarden retourneren als een 128-bits decimaal, zolang de uitdrukking wordt omgezet in een 128-bits decimale waarde.
Dit is zelfs het geval wanneer slechts één van de uitdrukkingen 128-bits decimaal is.
Stel dat we de volgende documenten aan onze collectie toevoegen:
{ "_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 }
Laten we de $atan2
. uitvoeren operator tegen die documenten:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 2, 3, 4 ] } } },
{ $project: {
_id: 0,
arctangent: { $atan2: [ "$a", "$b" ] }
}
}
]
)
Resultaat:
{ "arctangent" :NumberDecimal("0.4877792766738730791507215461936449") }{ "arctangent" :NumberDecimal("0.7539075768401526572881006364456838") }{ "arctangent" :NumberDecimal("0.81688749954794061943")In alle gevallen is de uitvoer 128-bits decimaal.
Null-waarden
Null-waarden retourneren
null
bij gebruik van de$atan2
exploitant. Dit geldt zelfs als de enige van de expressiesnull
. is .Stel dat we de volgende documenten aan onze collectie toevoegen:
{ "_id" :5, "a" :null, "b" :2 }{ "_id" :6, "a" :2, "b" :null }{ "_id" :7, "a " :2, "null" :null }Laten we de
$atan2
. uitvoeren operator tegen die documenten:db.data.aggregate( [ { $match: { _id: { $in: [ 5, 6, 7 ] } } }, { $project: { _id: 0, arctangent: { $atan2: [ "$a", "$b" ] } } } ] )
Resultaat:
{ "arctangent" :null }{ "arctangent" :null }{ "arctangent" :null }We kunnen zien dat het resultaat
null
. is in alle gevallen.NaN-waarden
Als het argument wordt omgezet in
NaN
,$atan2
retourneertNaN
.Voorbeeld:
db.data.aggregate( [ { $match: { _id: { $in: [ 2, 3, 4 ] } } }, { $project: { _id: 0, arctangent: { $atan2: [ "$a" * 1, "$b" ] } } } ] )
Resultaat:
{ "arctangent" :NumberDecimal("NaN") }{ "arctangent" :NumberDecimal("NaN") }{ "arctangent" :NaN }Laten we het iets veranderen, zodat we veld
b
. vermenigvuldigen in plaats van velda
.db.data.aggregate( [ { $match: { _id: { $in: [ 2, 3, 4 ] } } }, { $project: { _id: 0, arctangent: { $atan2: [ "$a", "$b" * 1 ] } } } ] )
Resultaat:
{ "arctangent" :NumberDecimal("NaN") }{ "arctangent" :NaN }{ "arctangent" :NumberDecimal("NaN") }En laten we nu beide velden vermenigvuldigen:
db.data.aggregate( [ { $match: { _id: { $in: [ 2, 3, 4 ] } } }, { $project: { _id: 0, arctangent: { $atan2: [ "$a" * 1, "$b" * 1 ] } } } ] )
Resultaat:
{ "arctangent" :NaN }{ "arctangent" :NaN }{ "arctangent" :NaN }Niet-bestaande velden
Als de
$atan2
operator wordt toegepast op een veld dat niet bestaat,null
wordt geretourneerd.Voorbeeld:
db.data.aggregate( [ { $match: { _id: 1 } }, { $project: { _id: 0, result: { $atan2: [ "$a", "$name" ] } } } ] )
Resultaat:
{ "result" :null }