$atan2

Nouveau depuis la version 8.0.1.

L'$atan2opérateur dans Amazon DocumentDB renvoie la tangente inverse (arc tangente) dey / x, où y et x sont les première et deuxième valeurs transmises à l'expression respectivement.

Les deux expressions doivent être résolues en valeurs numériques. L'opérateur utilise le signe des deux arguments pour déterminer le quadrant correct.

Le résultat est exprimé en radians. Pour obtenir des degrés, appliquez $radiansToDegrees à la sortie.

Le type de retour est double par défaut. Si les entrées sont des décimales de 128 bits, la sortie est également une décimale de 128 bits.

Paramètres

• expression 1(y) : expression qui se résout en un nombre représentant la coordonnée y.

• expression 2(x) : expression qui se résout en un nombre représentant la coordonnée X.

Comportement

null et NaN

Si l'un des arguments est null (ou fait référence à un champ manquant), le résultat estnull. Si l'un des arguments l'estNaN, le résultat estNaN. Lorsque l'un des arguments l'est null et que l'autre l'estNaN, null a la priorité.

Exemple	Résultats
{ $atan2: [ NaN, <value> ] }	NaN
{ $atan2: [ <value>, NaN ] }	NaN
{ $atan2: [ null, <value> ] }	null
{ $atan2: [ <value>, null ] }	null
{ $atan2: [ NaN, null ] }	null
{ $atan2: [ null, NaN ] }	null

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$atan2opérateur pour calculer l'arctangente de y/x pour un ensemble de points.

Créez des exemples de documents

db.points.insertMany([
  { "_id": 1, "y": 1, "x": 1 },
  { "_id": 2, "y": 1, "x": 0 },
  { "_id": 3, "y": -1, "x": -1 }
]);

Exemple de requête

db.points.aggregate([
  { $project: {
    "angle": { $atan2: ["$y", "$x"] }
  }}
]);

Sortie

[
  { "_id": 1, "angle": 0.7853981633974483 },
  { "_id": 2, "angle": 1.5707963267948966 },
  { "_id": 3, "angle": -2.356194490192345 }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de l'$atan2opérateur, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

Node.js

const { MongoClient } = require('mongodb');

async function main() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('points');

  const result = await collection.aggregate([
    { $project: {
      "angle": { $atan2: ["$y", "$x"] }
    }}
  ]).toArray();

  console.log(result);
  await client.close();
}

main();

Python

from pymongo import MongoClient

def main():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['points']

    result = list(collection.aggregate([
        { '$project': {
            'angle': { '$atan2': ['$y', '$x'] }
        }}
    ]))

    print(result)
    client.close()

if __name__ == "__main__":
    main()