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

atan2(アークタンジェント2)は、関数の一種。「2つの引数を取るarctan(アークタンジェント)」という意味である。x軸の正の向きと、点(x, y) (ただし、(0, 0)ではない)まで伸ばした半直線(レイ)との間の、ユークリッド平面上における角度として定義される。関数はもしくはの形をとり、値はラジアンで返ってくる。

関数は、プログラミング言語のFortran(IBM社が1961年に実装したFORTRAN-IV)において最初に登場した。元々は、角度θを直交座標系の(x, y)から極座標系の(r, θ)に変換する際に、正確で一意な値が返ってくることを意図して導入された。また、は複素数の偏角[注釈 1]を求める際にも利用される。

関数 は、−π < θ ≤ πの範囲で、

(ただし、r > 0)となる単一の値θを返す。

なお、arctanを使って角度θを求める際に注意すべきことであるが、が真であるからと言って、

であるということが常に言えるとは限らない。

これは、x > 0だった場合にのみ当てはまる。もしx < 0だった場合は、上の式から導出された角度は、正しい角度とは正反対の方向を指し示している。そして、デカルト点(x, y)をユークリッド平面上の正しい象限に配置するには、(度数法で言うと180°)の値をθに加算または減算する必要がある[1]。これはつまり、正しい角度を出すためにはxおよびyの符号の情報がそれぞれ別個に必要とされると言うことであり、もし単にyをxで除算した場合は、その情報が失われてしまうというわけである。その点、atan2は細かいことを気にしなくてもyとxに代入すれば普通に正しい角度を返してくれるので便利である。

関数の戻り値である角度θについては、xとyの値を変更しないままでも角度θに2πの任意の整数倍を加算することが可能であるため、つまり区間を適切に設定しないと戻り値が曖昧になってしまうため、関数atan2はその主値として、区間を(−π, π]としたものが戻り値として返ってくるようになっている(関数arctanの戻り値の区間が(−π/2 , π/2)である点との違いに注意)。角度θは符号付き角度であり、反時計回りの角度は正、時計回りは負となる。具体的は、もしy ≥ 0だった場合は[0, π]の区間にあり、もしy < 0だった場合には(−π, 0)の区間にある、となるように関数の内部で場合分けをしている。

atan2が生み出された経緯と動機

上の図は、角度 θの値が −π から +π までの場合における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 を一意に定義するために範囲 の主値を使用する。つまり、−π < atan2(y, x) ≤ π とする。

標準の arctan 関数(値域 (−π/2, π/2))を用いて、次のように表すことができる:

重複する4つの半平面を用いたコンパクトな式:

アイバーソンの記法を用いれば、さらにコンパクトな式が可能:

[注釈 2]

一見すると条件式のない数式:

タンジェントの半角の公式から派生した次の式で atan2 を定義することもできる:

この式は、上記の定義よりもシンボリックな使用に適している場合がある。ただし、 の丸め誤差の影響が領域 x < 0, y = 0 の近くで拡大するため、一般的な浮動小数点数の計算用途には適していない(これにより、yがゼロで除算されることもある)。

これらの膨らんだ丸め誤差を回避するため、先ほどの式を変形:

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

注意:

(x, y) = (r cos θ, r sin θ) のとき tan(θ/2) = y / (r + x) となる。その結果、次式が成立する。
問題の領域は √x2 + y2 + x ≠ 0 であることに注意。

微分

関数 atan2 は2変数関数であるため、2つの偏導関数がある。これらの導関数が存在する点では、atan2 は定数項を除いた arctan(y/x) に等しくなる。したがって、x > 0 または y ≠ 0 の場合、

したがって、atan2 の勾配は次式で与えられる。

関数 atan2 を角度関数 θ(x, y) = atan2(y, x) (定数を除いて定義)として省略して表すと、全微分について次の式が得られる:

関数 atan2 は、負の x 軸に沿って不連続であるが、角度を連続的に定義できないという事実を反映して、この導関数は原点を除いて連続的に定義される。これは、角度の微小な(そして実際には局所的な)変化が原点を除くすべての場所で定義できるという事実を反映している。この導関数をパスに沿って積分するとパス全体の角度が全体的に変化し、閉ループで積分すると回転数が得られる。

微分幾何学の言語では、この導関数は1-形式であり、閉である(導関数が0である)が、完全ではない(0-形式の導関数、つまり関数ではない)。実際、1点を除いた平面(Punctured Plane)の1次のド・ラームコホモロジーを生成する。これはそのような形式の最も基本的な例であり、微分幾何学の基本である。

atan2 の偏導関数には三角関数が含まれていないため、三角関数の評価にコストがかかる可能性がある多くのアプリケーション(例:組み込みシステム)で特に役立つ。

図による可視化

任意の半直線上のatan2

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

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

この図はと、におけるの値を示している。両方の関数ともに奇関数であり、それぞれとの周期関数である。このため、の実数値における補角となることができる。一例としてのにおける分岐截断、およびのにおける分岐截断が明確に確認できる[5]。

下記の2つの図は、atan2(y, x)およびarctan(y/x)の上から見た3次元図である。ここで、atan2(y, x)におけるX/Y平面の原点から伸びる半直線が定数値なのに対し、arctan(y/x)ではX/Y平面の原点を通る直線が定数値である。x > 0において、2つの図は同一の値となる。

加法定理

の和は、下記の定理によれば1つの式にまとめることができる。

...ここで.

証明には、 または 、および かつ の二つのケースにわけて行う必要がある。 ここでは前者の または のケースのみにおいて考える。最初に、下記の考察を行う:

  1. において または .
  2. であり、は複素数の偏角の数値計算である。
  3. である限り、が成り立つ(オイラーの公式により)。
  4. .

(4)において、複素数の偏角の定理により、ここで 、従って となる。さらに、全ての正の実数値に対してが成り立ち、 および とすると、となる。

上記より、次の等式が成り立つ:

Corollary(推論): もし および が2次元のベクトルであり、これらベクトル間の角度を計算するのに を用いた差分の式が頻繁に用いられているとすると、計算結果はの区間となることから、ほとんどのケースではレンジチェックは不要となる。


東-反時計回り、北-時計回り および 南-時計回り等の変換

関数は元々数学的に多く用いられる、原点から右の半直線から反時計回りに動く場合の変化について定義している(ここではこれを東-反時計回りと言う)。一方実際の実装系では、北-時計回り および 南-時計回りの変換がよく用いられる。 例えば気象学において、風向は関数を用いて、風の東および北向きの成分を引数として利用して計算されている。[6] 同様に太陽の方位角(英語版)も東および北方向の成分を引数として用いている。風向きは通常北-時計回りで定義されているためであり、太陽の方位角は北-時計回り および 南-時計回り両方を用いて広く計算されていためである。[7] これらの異なる変換は、下記のように位置の置換およびx/y座標の符号を下記のように変更することで実現できる:

例として、 で の場合、東-反時計回りの場合には、北-時計回りでは、南-時計回りのようになる。

x/y成分の符号の変更と位置の転換は結果として8つのの定義が可能となる。それらは時計回り・反時計回りの4つの方角・東西南北を始点とする。

プログラミング言語における実装

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

入れ替わった順序の引数は下記で用いられている:

この定義は-0の定義に従ったものとなる。

関連項目

脚注

[脚注の使い方]

注釈

  1. ↑ 「位相」とも言う。
  2. ↑ 従って
      および、
      (全てのに対し)
  3. ↑ 結果の周期性を適用して、別の目的の範囲に写像できる。e.g. 負の結果に 2π を加算すると [0, 2π) に写像できる。
  4. ↑ "Why don't you compile Matlab/Python/R/… code to Julia?" のセクションを参照のこと。

    出典

    1. ↑ http://scipp.ucsc.edu/~haber/ph116A/arg_11.pdf
    2. ↑ Organick, Elliott I. (1966). A FORTRAN IV Primer. Addison-Wesley. pp. 42. "Some processors also offer the library function called ATAN2, a function of two arguments (opposite and adjacent)."
    3. ↑ Math.Atan2(Double, Double) Method (System) | Microsoft Learn
    4. ↑ “src/math/atan2.go”. The Go Programming Language. 20 April 2018閲覧。
    5. ↑ “Wolf Jung: Mandel, software for complex dynamics”. www.mndynamics.com. 20 April 2018閲覧。
    6. ↑ Wind Direction Quick Reference, NCAR UCAR Earth Observing Laboratory. https://www.eol.ucar.edu/content/wind-direction-quick-reference
    7. ↑ Zhang, Taiping; Stackhouse, Paul W.; MacPherson, Bradley; Mikovitz, J. Colleen (2021). “A solar azimuth formula that renders circumstantial treatment unnecessary without compromising mathematical rigor: Mathematical setup, application and extension of a formula based on the subsolar point and atan2 function”. Renewable Energy 172: 1333–1340. doi:10.1016/j.renene.2021.03.047.
    8. ↑ “Microsoft Excel Atan2 Method”. Microsoft. 9 Jan 2022閲覧。
    9. ↑ “LibreOffice Calc ATAN2”. Libreoffice.org. 9 Jan 2022閲覧。
    10. ↑ “Functions and formulas – Docs Editors Help”. support.google.com. 9 Jan 2022閲覧。
    11. ↑ “Numbers' Trigonometric Function List”. Apple. 9 Jan 2022閲覧。
    12. ↑ “ANSI SQL:2008 standard”. Teradata. 2015年8月20日時点のオリジナルよりアーカイブ。9 Jan 2022閲覧。
    13. ↑ “CLHS: Function ASIN, ACOS, ATAN”. LispWorks. 9 Jan 2022閲覧。
    14. ↑ “Mathematics · The Julia Language”. docs.julialang.org. 9 Jan 2022閲覧。
    15. ↑ “Frequently Asked Questions · The Julia Language”. docs.julialang.org. 9 Jan 2022閲覧。
    16. ↑ IA-32 Intel Architecture Software Developer’s Manual. Volume 2A: Instruction Set Reference, A-M, 2004.
    17. ↑ Burger, Wilhelm; Burge, Mark J. (7 July 2010). Principles of Digital Image Processing: Fundamental Techniques. Springer Science & Business Media. ISBN 978-1-84800-191-6 20 April 2018閲覧。
    18. ↑ Glisson, Tildon H. (18 February 2011). Introduction to Circuit Analysis and Design. Springer Science & Business Media. ISBN 9789048194438 20 April 2018閲覧。

    外部リンク

    その他のatan2の実装・コード


    ⌬ Phoenix Mesh CID: 未登録 IPFS未登録 📡 0ピア N=1 CRITICAL PQS A90