a t a n 2

PHP関数リファレンス

atan2

(PHP 4, PHP 5)
atan2 — 2 変数のアークタンジェント

説明

float atan2 ( float y, float x )
この関数は、2 つの変数 x および y のアークタンジェントを計算します。 y / x のアークタンジェントを計算するのに似ていますが、 2 つの引数の符号を用いて結果の象限を定義することが異なっています。
この関数は、結果を -PI から PI の間(両端を含む)のラジアンで返します。
acos() および atan() も参照ください。

ウィキペディア

atan2

出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2024/11/29 19:53 UTC 版)

関数atan2(y, x)は、点(x, y)方向への半直線（レイ）と、x軸の正の向きとの間の角度θを返す。ただし、範囲は(−π, π]である

${\displaystyle y/x}$

この節には独自研究が含まれているおそれがあります。 問題箇所を検証し出典を追加して、記事の改善にご協力ください。議論はノートを参照してください。（2023年12月）

上の図は、角度 θの値が −π から +π までの場合におけるtangent関数（tan θ）のグラフ。その下に示したのは対応するy/x座標の符号である。緑の矢印が指し示しているのは atan2(−1, −1) および atan2(1, 1) の結果（戻り値）である。この図の通り、atan2関数は符号によって場合分けすることで角度θの正しい値を返してくれる。

atan2関数は、元々は特定のプログラミング言語に実装された関数（サブルーチン）の一つに過ぎなかったが、現在では他の科学技術の分野でもよく使われるものとなっている。その起源は少なくとも、FORTRANのATAN2(Y, X)にまで遡ることができ^[2]、現代的なプログラミング言語にも標準的な数学関数ライブラリやパッケージの形で実装されている。例を挙げると、C言語およびC++の標準ライブラリ（標準Cライブラリのmath.hにおけるatan2()関数あるいは標準C++ライブラリのcmathにおけるstd::atan2()関数）、Javaの標準ライブラリにおけるMath.atan2()メソッド、C#/F#/VB.NETなどから利用できる.NETの基本クラスライブラリにおけるSystem.Math.Atan2()メソッド^[3]、JavaScriptの標準組み込みオブジェクトMath、Pythonのmathモジュール、RubyのMathモジュール、Goのmathパッケージ^[4]、などであるが、他にも多数の言語に実装されている。さらに、Perlを始めとするスクリプト言語にも、C言語風のatan2(y, x)関数が実装されていることが多い。

また、単に「便利だから」と言うことも存在の理由の一つである。単一引数のみを取るarctan関数(アークタンジェント関数)では正反対の方向を区別できないと言う弱点がある。例えば、x軸とベクトル(1, 1)がなす反時計回りの角度をarctan関数を使って「arctan(1/1)」として計算した場合、「π/4ラジアン（度数法で45°）」という答えが返却される。しかし、x軸とベクトル(−1, −1)の間の角度を同様に「arctan(−1/−1)」として計算してみると、期待される返却値は「−3π/4ラジアン(−135°)」または「5π/4ラジアン(225°)」であるにもかかわらず、「π/4ラジアン」が返却される。さらに、x軸とベクトル(0, y)(ただし、y ≠ 0とする)がなす角度をarctan関数で計算しようとするとarctan(y/0)の評価が必要になってしまい、返却されるのはゼロ除算のエラーとなる。

atan2関数は2つの変数 y と xから一意なアークタンジェントの値を算出するが、そのとき両変数の正負の符号が実行結果の象限を決定するために利用される。それに基づいて「arctan(y/x)」を実行したときの結果の中から分岐先の結果を選んで返している。例を挙げると、arctan関数では同じ結果が返される「atan2(1, 1) = π/4」 と 「atan2(−1, −1) = −3π/4」では、入力値の符号を用いてどちらの解を正解と取るのかを判断している。また、例えば前述の「arctan(y/0)」を計算しようとしても、ゼロ除算のエラーの代わりに「atan2(1, 0) = π/2」を返却することも、同様の方法で行っている。

もちろん、上記の計算を自分で実装すれば極論atan2関数は必要ないが、その実装プログラム中のどこかでミスを犯す危険性がある。それよりも常に一意な正しい結果を返してくれるような関数が存在した方が圧倒的に便利である。そのような経緯からatan2関数が存在するのである。

定義と計算

定義

関数 atan2 は複素数 x + yi に偏角関数 arg を適用した時の主値を計算する。すなわち、atan2(y, x) = Pr arg(x + yi) = Arg(x + yi) である。偏角は、2π（原点を中心としたちょうど1周の回転に対応）の整数倍を加えたものも同じ角度になるが、atan2 を一意に定義するために範囲 ${\displaystyle (-\pi ,\pi ]}$

偏角の主値の導出は、この図を参照している。

注意:

• これにより、範囲 (−π, π] の結果が生成される。^{[注釈 3]}
• 上記のように、偏角の主値 atan2(y, x) は、三角法によって arctan(y/x) に関連付けることができる。 導出は次のようになる:

(x, y) = (r cos θ, r sin θ) のとき tan(θ/2) = y / (r + x) となる。その結果、次式が成立する。

${\displaystyle {\text{atan2}}(y,x)=\theta =2\,\theta /2=2\arctan {\frac {y}{{\sqrt {x^{2}+y^{2}}}+x}}.}$

任意の半直線上のatan2

この図は、ある半直線に沿ったatan2の値を単位円上に示している。atan2の値はラジアンであり、単位円内に記載されている。標準的な数学の方式に従い、角度は右方向の半直線をゼロとして反時計回りに増加する。ここで、2つの引数の順序が座標と比べて入れ替わっていることに注意が必要である。すなわち、関数atan2(y, x)は座標(x, y)に対応する角度を計算する。

アークタンジェントとatan2関数の比較

この図は${\displaystyle \arctan(\tan(\theta ))}$

加法定理

→詳細は「三角関数の公式の一覧 § 加法定理」を参照

${\displaystyle \operatorname {atan2} }$

原文と比べた結果、この節には多数の（または内容の大部分に影響ある）誤訳があることが判明しています。情報の利用には注意してください。 正確な表現に改訳できる方を求めています。 (2023年12月)

atan2の実装はプログラミング言語ごとに異なる。

• Microsoft Excel^[8]、OpenOffice.org Calc、LibreOffice Calc^[9]、Google Spreadsheets,^[10] iWork Numbers^[11]、およびANSI SQL:2008 standard^[12]では、2つの引数をもつatan2関数はそのままの順序の引数${\displaystyle (\operatorname {Re} ,\operatorname {Im} )}$