【Ruby3.x】atan2()関数の使い方
atan2関数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
atan2関数は、与えられた2つの直交座標（y座標とx座標）から、その点がX軸の正の方向となす角度を計算し、ラジアン単位で返す関数です。この関数は、引数としてまずy座標、次にx座標の順に2つの数値を指定します。戻り値は-πからπ（およそ-3.14159から3.14159）の範囲の浮動小数点数で、この範囲で全周の角度を表すことができます。
一般的なアークタンジェント関数（atan）は、y/xの比率から角度を計算しますが、yとxの符号の違いによってどの象限に属するかを正確に判断できない場合があります。それに対し、atan2関数はyとxを個別の引数として受け取るため、座標が第一象限から第四象限のどこにあっても、X軸の正の方向からの反時計回りの角度を正確に判断し、適切な符号の角度を返します。
この特性により、グラフィック処理におけるオブジェクトの回転角度の計算や、ゲーム開発でのキャラクターの向きの決定、ロボット制御など、広範囲な分野で活用されます。特に、特定の座標への相対的な向きを正確に求めたい場合に非常に有用です。システムエンジニアを目指す初心者の方も、点と点の間の方角や、直交座標から角度を求める必要がある際に、このatan2関数が強力なツールとなることを覚えておくと良いでしょう。
構文(syntax)
1puts Math.atan2(1, 1)
引数(parameters)
y, x
- y: 浮動小数点数: y座標を指定します
- x: 浮動小数点数: x座標を指定します
戻り値(return)
Float
与えられたx座標とy座標から、原点からその点へのベクトルがx軸の正の方向となす角度をラジアン単位で返します。