MongoDB $atan2

I MongoDB, $atan2 aggregeringspipeline-operatorn returnerar arctangens (invers tangent) för ett värde dividerat med ett annat.

Du anger de två värdena i en array. Vart och ett av de två värdena som tillhandahålls till $atan2 kan vara vilket giltigt uttryck som helst som löser sig till ett tal.

Returvärdet är i radianer.

$atan2 operatören introducerades i MongoDB 4.2.

Exempel

Anta att vi har en samling som heter data med följande dokument:

{ "_id" : 1, "a" : 2, "b" : 3 }

Vi kan använda $atan2 operatorn för att returnera arctangensen för a fält dividerat med b fält:

db.data.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" ] }
      }
    }
  ]
)

Resultat:

{ "arctangent" : 0.5880026035475675 }

Konvertera till grader

Som nämnts, $atan2 returnerar sitt resultat i radianer. Du kan använda $radiansToDegrees operator om du vill ha resultatet i grader.

Exempel:

db.data.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        radians: { $atan2: [ "$a", "$b" ] },
        degrees: { $radiansToDegrees: { $atan2: [ "$a", "$b" ] } }
      }
    }
  ]
)

Resultat:

{ "radians" : 0.5880026035475675, "degrees" : 33.690067525979785 }

I det här exemplet visar det första fältet resultatet i radianer och det andra fältet visar det i grader.

128-bitars decimalvärden

Som standard är $atan2 operatorn returnerar värden som en double , men det kan också returnera värden som en 128-bitars decimal så länge uttrycket löser sig till ett 128-bitars decimalvärde.

Detta är fallet även när endast ett av uttrycken är 128-bitars decimal.

Anta att vi lägger till följande dokument i vår samling:

{ "_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 }

Låt oss köra $atan2 operatör mot dessa dokument:

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" ] }
      }
    }
  ]
)

Resultat:

{ "arctangent" : NumberDecimal("0.4877792766738730791507215461936449") }
{ "arctangent" : NumberDecimal("0.7539075768401526572881006364456838") }
{ "arctangent" : NumberDecimal("0.8168887499547439619432210551940676") }

I alla fall är utmatningen 128-bitars decimal.

Nullvärden

Nullvärden returnerar null när du använder $atan2 operatör. Detta är sant även om det enda av uttrycken är null .

Anta att vi lägger till följande dokument i vår samling:

{ "_id" : 5, "a" : null, "b" : 2 }
{ "_id" : 6, "a" : 2, "b" : null }
{ "_id" : 7, "a" : 2, "null" : null }

Låt oss köra $atan2 operatör mot dessa dokument:

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 5, 6, 7 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" ] }
      }
    }
  ]
)

Resultat:

{ "arctangent" : null }
{ "arctangent" : null }
{ "arctangent" : null }

Vi kan se att resultatet är null i samtliga fall.

NaN-värden

Om argumentet löser sig till NaN , $atan2 returnerar NaN .

Exempel:

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a" * 1, "$b" ] }
      }
    }
  ]
)

Resultat:

{ "arctangent" : NumberDecimal("NaN") }
{ "arctangent" : NumberDecimal("NaN") }
{ "arctangent" : NaN }

Låt oss ändra det något så att vi multiplicerar fältet b istället för fältet a .

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a", "$b" * 1 ] }
      }
    }
  ]
)

Resultat:

{ "arctangent" : NumberDecimal("NaN") }
{ "arctangent" : NaN }
{ "arctangent" : NumberDecimal("NaN") }

Och låt oss nu multiplicera båda fälten:

db.data.aggregate(
  [
    { $match: { _id: { $in: [ 2, 3, 4 ] } } },
    { $project: { 
        _id: 0,
        arctangent: { $atan2: [ "$a" * 1, "$b" * 1 ] }
      }
    }
  ]
)

Resultat:

{ "arctangent" : NaN }
{ "arctangent" : NaN }
{ "arctangent" : NaN }

Icke-existerande fält

Om $atan2 operatorn tillämpas mot ett fält som inte finns, null returneras.

Exempel:

db.data.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        result: { $atan2: [ "$a", "$name" ] }
      }
    }
  ]
)

Resultat:

{ "result" : null }