$cos (余弦)
最終更新：2026-10-09
$cos (余弦)
$cos はラジアンで表した値の余弦を返します。ベクトルの射影、波形解析、回転の計算に使われます。null または欠落した引数は null を返し、NaN 入力は NaN を返し、±Infinity はエラーになります。余弦の範囲は -1 から 1 で、逆関数は $acos です。度とラジアンの変換は、手計算で π を掛けるのではなく $degreesToRadians と $radiansToDegrees を使います。
| カテゴリ | 数学 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
{ $cos: <numeric-expression> }⚙️ パラメータ
| ラジアン値 | ラジアン単位の数値式。 |
|---|
戻り値：入力ラジアンの余弦。null または欠落している場合は null、±Infinity の場合はエラー
▶ 例
以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：
// $cos: 度をラジアンに変換して余弦
db.trig.aggregate([
{ $project: {
x: { $cos: { $degreesToRadians: '$deg' } }
} }
])出力：
{ '_id': 1, 'x': 0.5 }
{ '_id': 2, 'x': 0.8660254037844387 }📌 注意事項
- 入力はラジアン。角度は先に変換する
- 範囲は -1 から 1 の間
- $sin と組むと座標を分解でき、それぞれの 2 乗の和は常に 1
🏷️ 関連タグ
💡 関連ケース
さらなる実践ケースを近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Q$cos はどの単位を期待しますか？
Aラジアンです。角度は先に $degreesToRadians で変換してください。
Q$cos の結果の範囲は？
A-1 から 1 の間です。
Q$cos と $sin の関係は？
A同じ角度では $cos と $sin の 2 乗の和が 1 になるため、相互に変換できます。
