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-비트 십진수입니다.