/ /

$asin（式演算子）

$asin

値の逆サイン（アークサイン）を返します。

$asin の構文は次のとおりです。

{ $asin: <expression> }

は、から$asin までの数値に変換される有効な式であればどれでもかまいません（例: -11-1 <= value <= 1）。

$asinはラジアンで値を返します。$radiansToDegrees 演算子を使用して出力値をラジアンから度に変換します。

$asinデフォルトでは、は値をdouble として返します。$asin 128<expression>は、が128 ビットの 10 進数値に解決される限り、ビットの 10 進数として値を返すこともできます。

式の詳細については、「式」を参照してください。

動作

引数がの値に解決されるか、欠落しているフィールドを参照する場合、null $asinnullはを返します。引数が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コレクションには、直角三角形の 3 つの面を保存するドキュメントが含まれています。

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

次の集計操作では、式を使用して$asin と反対の角度を計算し、それをside_a $addFieldsパイプラインステージを使用して入力ドキュメントに追加します。

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

$radiansToDegrees式は、$asin によって返されたラジアン値を度単位の同等の値に変換します。

このコマンドは、次の出力を返します。

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

side_aとはhypotenuse 128ビットの 10 進数として保存されているため、$asin の出力は128 ビットの 10 進数になります。

trigonometryコレクションには、直角三角形の 3 つの面を保存するドキュメントが含まれています。

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

次の集計操作では、式を使用して$asin に隣接する角度を計算し、それをside_a $addFieldsパイプラインステージを使用して入力ドキュメントに追加します。

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

このコマンドは、次の出力を返します。

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

side_aとはhypotenuse 128ビットの 10 進数として保存されているため、$asin の出力は128 ビットの 10 進数になります。

戻る

$arrayToObject

$asinh