Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
연산자
/
집계 파이프라인 연산자

atan2(집계)

이 페이지의 내용

  • 행동
  • 예시
$atan2

y / x 의 역탄젠트(아크 탄젠트)를 반환하며, 여기서 y 및 x 는 각각 표현식에 전달된 첫 번째 값과 두 번째 값입니다.

$atan2 의 구문은 다음과 같습니다:

{ $atan2: [ <expression 1>, <expression 2> ] }

$atan2 은(는) 숫자로 해석되는 유효한 표현식 을 사용합니다.

$atan2는 값을 라디안 단위로 반환합니다. 출력 값을 라디안에서 각도로 변환하려면 $radiansToDegrees 연산자를 사용하세요.

기본적으로 $atan2 은 값을 double 로 반환합니다. $atan2 는 <expression> 가 128비트 십진수 값으로 해석되는 한 값을 128비트 십진수 로 반환할 수도 있습니다.

표현식에 대한 자세한 내용은 표현식을 참조하세요 .

행동

null 개인정보 정책에 NaN

$atan2 에 제공된 인수 중 하나라도 null 이면 표현식은 null 를 반환합니다. 두 인수 중 하나가 NaN 이면 표현식은 NaN 를 반환합니다. 한 인수가 null 이고 다른 인수가 NaN 인 경우 표현식은 null 을 반환합니다.

예시
결과

{ $atan2: [ NaN, <value> ] }

NaN

{ $atan2: [ <value>, NaN ] }

NaN

{ $atan2: [ null, <value> ] }

null

{ $atan2: [ <value>, null ] }

null

{ $atan2: [ NaN, null ] }

null

{ $atan2: [ null, NaN ] }

null

예시

trigonometry 컬렉션에는 직각 삼각형의 세 변을 저장하는 문서가 포함되어 있습니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : NumberDecimal("3"),
  "side_b" : NumberDecimal("4"),
  "hypotenuse" : NumberDecimal("5")
}

다음 집계 작업은 $atan2 표현식 을 사용하여 side_a 에 인접한 각도를 계산하고 $addFields 파이프라인 단계를 사용하여 입력 문서 에 추가합니다.

db.trigonometry.aggregate([
  {
    $addFields : {
      "angle_a" : {
        $radiansToDegrees : {
          $atan2 : [ "$side_b", "$side_a" ]
        }
      }
    }
  }
])

$radiansToDegrees 표현식 은 $atan2 에서 반환된 라디안 값을 해당 값(단위: 도)으로 변환합니다.

이 명령은 다음 출력을 반환합니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : NumberDecimal("3"),
  "side_b" : NumberDecimal("4"),
  "hypotenuse" : NumberDecimal("5"),
  "angle_a" : NumberDecimal("53.13010235415597870314438744090658")
}

side_b 및 side_a 는 128비트 십진수 로 저장되므로 $atan2 의 출력은 128비트 십진수입니다.

trigonometry 컬렉션에는 직각 삼각형의 세 변을 저장하는 문서가 포함되어 있습니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : NumberDecimal("3"),
  "side_b" : NumberDecimal("4"),
  "hypotenuse" : NumberDecimal("5")
}

다음 집계 작업은 $atan2 표현식 을 사용하여 side_a 에 인접한 각도를 계산하고 $addFields 파이프라인 단계를 사용하여 입력 문서 에 추가합니다.

db.trigonometry.aggregate([
  {
    $addFields : {
      "angle_a" : {
        $atan2 : [ "$side_b", "$side_a" ]
      }
    }
  }
])

이 명령은 다음 출력을 반환합니다.

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "side_a" : NumberDecimal("3"),
  "side_b" : NumberDecimal("4"),
  "hypotenuse" : NumberDecimal("5"),
  "angle_a" : NumberDecimal("0.9272952180016122324285124629224287")
}

side_b 및 side_a 는 128비트 십진수 로 저장되므로 $atan2 의 출력은 128비트 십진수입니다.

돌아가기

$atan

다음

$atanh

이 페이지의 내용