문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
연산자
/
집계 파이프라인 연산자

asin(집계)

이 페이지의 내용

  • 행동
  • 예제
$asin

값의 사인의 역함수(아크 사인)를 반환합니다.

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

{ $asin: <expression> }

$asin 은 -1 에서 1 사이의 숫자로 해석되는 모든 유효한 표현식 을 사용합니다(예: -1 <= value <= 1.

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

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

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

행동

인수가 null 값으로 확인되거나 누락된 필드를 참조하는 경우 $asin는 null을 반환합니다. 인수가 NaN으로 확인되는 경우 $asin는 NaN을 반환합니다. 인수가 [-1, 1] 범위를 벗어난 값으로 확인되는 경우 $asin는 오류를 발생시킵니다.

예제
결과
{ $asin: NaN }
NaN
{ $asin: null }
null

{ $asin : Infinity}

또는

{ $asin : -Infinity }

다음과 같은 형식의 출력과 유사한 오류 메시지를 표시합니다.

"errmsg" :
  "Failed to optimize pipeline :: caused by :: cannot
  apply $asin to -inf, value must in [-1,1]"

예제

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

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

다음 애그리게이션 작업에서는 $asin 표현식을 사용하여 side_a 와 반대되는 각도를 계산하고 $addFields 파이프라인 단계를 사용하여 입력 문서에 추가합니다.

db.trigonometry.aggregate([
  {
    $addFields : {
      "angle_a" : {
        $radiansToDegrees : {
          $asin : {
            $divide : [ "$side_a", "$hypotenuse" ]
          }
        }
      }
    }
  }
])

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

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

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

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

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

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

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

db.trigonometry.aggregate([
  {
    $addFields : {
      "angle_a" : {
        $asin : {
          $divide : [ "$side_a", "$hypotenuse" ]
        }
      }
    }
  }
])

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

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

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

돌아가기

$arrayToObject

다음

$asinh

이 페이지의 내용