MongoDB $ acos

Dans MongoDB, le $acos L'opérateur de pipeline d'agrégation renvoie l'arc cosinus (cosinus inverse) d'une valeur, mesurée en radians.

$acos accepte toute expression valide qui se résout en un nombre entre -1 et 1 .

Le $acos L'opérateur a été introduit dans MongoDB 4.2.

Exemple

Supposons que nous ayons une collection appelée test avec le document suivant :

{ "_id" : 1, "data" : 0.5 }

Nous pouvons utiliser le $acos opérateur pour renvoyer l'arccosinus de la data champ :

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        arccosine: { $acos: "$data" }
      }
    }
  ]
)

Résultat :

{ "arccosine" : 1.0471975511965976 }

Par défaut, le $acos l'opérateur renvoie les valeurs sous la forme d'un double , mais il peut également renvoyer des valeurs sous forme décimale de 128 bits tant que l'expression se résout en une valeur décimale de 128 bits.

Pi

Fournir -1 se résout en la constante mathématique pi (π).

Supposons que nous ajoutions le document suivant à notre collection, qui contient une valeur de données de -1 .

{ "_id" : 2, "data" : -1 }

Exécutons maintenant le $acos opérateur sur ce champ :

db.test.aggregate(
  [
    { $match: { _id: 2 } },
    { $project: { 
        _id: 0,
        arccosine: { $acos: "$data" }
      }
    }
  ]
)

Résultat :

{ "arccosine" : 3.141592653589793 }

Ce résultat est de π à 15 décimales.

Convertir en degrés

Comme mentionné, $acos renvoie son résultat en radians. Vous pouvez utiliser le $radiansToDegrees opérateur si vous voulez le résultat en degrés.

Exemple :

db.test.aggregate(
  [
    { $match: { _id: 2 } },
    { $project: { 
        _id: 0,
        radians: { $acos: "$data" },
        degrees: { $radiansToDegrees: { $acos: "$data" } }
      }
    }
  ]
)

Résultat :

{ "radians" : 3.141592653589793, "degrees" : 180 }

Dans cet exemple, le premier champ présente le résultat en radians et le second le présente en degrés.

Valeurs nulles

Les valeurs nulles renvoient null lors de l'utilisation du $acos opérateur.

Supposons que nous ajoutions le document suivant à notre collection :

{ "_id" : 3, "data" : null }

Exécutons le $acos opérateur sur ce document :

db.test.aggregate(
  [
    { $match: { _id: 3 } },
    { $project: { 
        _id: 0,
        arccosine: { $acos: "$data" }
      }
    }
  ]
)

Résultat :

{ "arccosine" : null }

Nous pouvons voir que le résultat est null .

Valeurs NaN

Si l'argument se résout en NaN , $acos renvoie NaN .

Exemple :

db.test.aggregate(
  [
    { $match: { _id: 3 } },
    { $project: { 
        _id: 0,
        arccosine: { $acos: 1 * "oops!" }
      }
    }
  ]
)

Résultat :

{ "arccosine" : NaN }

Dans ce cas, j'ai essayé de multiplier un nombre par une chaîne, ce qui a donné NaN être retourné.

Infini

Si l'argument se résout en Infinity ou -Infinity , le $acos l'opérateur renvoie une erreur.

Supposons que nous ajoutions le document suivant à notre collection :

{ "_id" : 4, "data" : Infinity }

Lançons $acos contre le champ de données :

db.test.aggregate(
  [
    { $match: { _id: 4 } },
    { $project: { 
        _id: 0,
        arccosine: { $acos: "$data" }
      }
    }
  ]
)

Résultat :

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "cannot apply $acos to inf, value must in [-1,1]",
	"code" : 50989,
	"codeName" : "Location50989"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

C'est l'erreur que j'obtiens dans le mongo shell lors de l'exécution de ce code.

Champs inexistants

Si le $acos l'opérateur est appliqué sur un champ qui n'existe pas, null est renvoyé.

Exemple :

db.test.aggregate(
  [
    { $match: { _id: 4 } },
    { $project: { 
        _id: 0,
        arccosine: { $acos: "$oops" }
      }
    }
  ]
)

Résultat :

{ "arccosine" : null }

Valeurs hors plage

Fournir une valeur hors plage à $acos entraînera une erreur.

Supposons que nous ajoutions le document suivant à la collection :

{ "_id" : 5, "data" : 2 }

Exécutons maintenant $acos par rapport aux data champ :

db.test.aggregate(
  [
    { $match: { _id: 5 } },
    { $project: { 
        _id: 0,
        radians: { $acos: "$data" }
      }
    }
  ]
)

Résultat :

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "cannot apply $acos to 2, value must in [-1,1]",
	"code" : 50989,
	"codeName" : "Location50989"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

Comme le message d'erreur y fait allusion, la valeur doit être comprise entre -1 et 1 .