atan、atan2、atanhとは実際には何なのか
命名パターンを共有する3つの関数だが、それぞれ打ち消す対象が異なる。
atan(ratio)はtanを打ち消す。傾き、つまり の比率を1つ渡すと、常に-90°から90°の間のどこかにある角度が返ってくる。atan2(dy, dx)も角度を返すが、事前に割り算された1つの比率ではなく、dyとdxという2つの別個の数値から計算する。その答えは円全体、つまり半分だけではなく-180°から180°までをカバーする。atanh(x)は角度とはまったく関係がない。これは を打ち消すもので、すでに(-1, 1)に押し込まれた数値を、任意の実数へと再び展開する。この記事の終盤にある余談のセクションで、これ単独について扱う。
atan と atan2 は語幹を共有し、どちらもtangentを打ち消す。
atanh は他の2つとは命名パターンだけを共有している。
直感的な理解
「」
は1つの関数のように聞こえるため、atan、atan2、atanh を同じアイデアの異なる表記として扱いたくなる。しかしそれらは違うものであり、特に atan と atan2 の違いにこそ、その思い込みが崩れる地点がある。
tan(angle)はdy / dxという比率だけに依存する。(1, 1)と(-1, -1)のような正反対の2点は、まったく同じ比率を生む。1 / 1と-1 / -1はどちらも1だからだ。atanはその比率に対して単一の答えを返さなければならない。45°を選ぶが、これは(1, 1)には正しく、実際には-135°にある(-1, -1)には間違っている。atan2はまさにこの情報損失を打ち消すために存在する。dyとdxを別々に読み取るため、それぞれの符号を確認し、4つの象限すべてを正しく解決できる。
スクリーン座標系のドラッグから角度を求める例でも、まさにこの理由から atan2 に頼っていた。この記事はその1つのメカニズムに留まり、入力をどう加工しても atan が同じ仕事をできない理由を見ていく。
- →Screen Coordinate Systems Aren't CartesianThe drag-to-angle case this post keeps coming back to: why atan2 is the inverse that survives a y-down screen's flipped rotation direction.
- →Polar to Cartesian: What cos and sin Are Actually ComputingThe forward direction atan2 undoes: turning an angle and radius into an (x, y) point in the first place.
具体例:同じ比率、異なる2つの方向
import kotlin.math.atan
import kotlin.math.atan2
val dy1 = 1.0; val dx1 = 1.0 // down-and-right (y grows downward on screen)
val dy2 = -1.0; val dx2 = -1.0 // up-and-left, the opposite direction
// Same ratio (1/1 == -1/-1), so atan returns the same angle for both,
// even though the two points face opposite ways.
Math.toDegrees(atan(dy1 / dx1)) // 45.0
Math.toDegrees(atan(dy2 / dx2)) // 45.0 (wrong, this point is at -135°)
// atan2 sees dy and dx separately instead of one pre-divided ratio, so
// it tells the two points apart correctly.
Math.toDegrees(atan2(dy1, dx1)) // 45.0
Math.toDegrees(atan2(dy2, dx2)) // -135.0ここで atan に不具合があるわけではない。「このtangentを持つのはどの角度か」という、問われた唯一の質問に答えているだけであり、1つの比率が実際に180°離れた2つの異なる角度に対応してしまうのだ。atan2 は別の問いを扱う。「この (dx, dy) の点に到達する角度は何か」という問いで、こちらは原点そのものを除くすべての点に対して一意の答えを持つ。
atan(dy/dx): 0°
atan2(dy, dx): 0° — atan gives 0 degrees, atan2 gives the correct 0 degrees
Screen
drag the dot
ドットを4つの象限すべてにドラッグしてみてほしい。atan2 は一周する間、真の角度を追跡し続ける。atan はドラッグが中心を挟んで反対側にある対称点を横切るたびに、同じ読み取り値に戻ってしまう。これは、atan が目にする入力がそれしかないためだ。
根本原理
atan2(dy, dx) は2引数の逆関数である。atan(ratio) は除算を生き残った情報しか見ることができないのに対し、atan2 は何かが割られる前の分子と分母を受け取るため、1引数の比率がすでに捨ててしまった象限を復元できる。
これは atan のデフォルト値を改善した変種ではない。厳密により大きな問題、すなわち「この点はどの方向にあるか」を解いているのであり、「このtangentを持つのはどの角度か」を解いているわけではない。
他の言語でも:同じ根本原理、異なるフレームワーク
- JavaScript:
Math.atan2(y, x)は同じ順序で同じ2つの引数を取り、理由も同じで、下記の(0, 0)のエッジケースに至るまで同様だ。 - GLSL:1引数版と同じ関数名を使う2引数オーバーロードである
atan(y, x)は、フラグメントシェーダー内で-πからπまでの全範囲を同じ方法で解決する。これは、あるフラグメントの中心からのオフセットを、手続き的な図形のための角度に変換する際によく使われる。 - Swift:引数ラベルなしでC言語のlibmからそのまま取り込まれた
atan2(y, x)は、同じ名前を持つ同じ関数である。なぜなら、基礎となる数学と、2つ目の引数が必要となる理由は言語が変わっても変わらないからだ。
エッジケース
Android上の kotlin.math.atan2 はJVMの Math.atan2 にそのまま委譲するため、「この点への方向」がまったく答えを持たないように聞こえる入力、つまり原点に対してさえ、定義された答えを引き継いでいる。
import kotlin.math.atan
import kotlin.math.atan2
val dy = 0.0
val dx = -0.0 // negative zero: a distinct, valid Double value
dy / dx // NaN (0/0 is indeterminate no matter the signs involved)
atan(dy / dx) // NaN, so there's no angle to read at all
atan2(dy, dx) // ~3.14159 (π)atan2 は dy を dx で割ることが一切ないため、0/0 の不定形にそもそも触れない。それぞれのゼロの符号を直接読み取る。正の dy と負の dx は「負の x 方向を指している」として読み取られ、これは π である。dx を正のゼロに戻すと、atan2 は代わりに正のゼロを返す。これは、== では 0.0 と等しいと見なされる Double 値(-0.0)に対する異なる答えだ。すでに NaN へと崩れてしまった比率から出発する atan には、これらのケースを区別する手段がない。
atan2がさらにどこで登場するか
ドラッグによる回転ノブや向きのロジック、たとえばスクリーン座標系に関する姉妹記事に出てきたドラッグ・角度デモは、もっと長いリストのうち2つの項目にすぎない。(dx, dy) のペアから距離ではなく方向を取り出す必要があるときは、たいてい atan2 が使われる。
UIとタッチ操作:
- ドラッグ式の回転ノブやダイヤル(ボリュームノブ、カラーホイール、円形スライダー、時計風のピッカー):中心からタッチ位置への角度が回転を駆動する。
- ラジアル/パイメニュー:メニューの中心に対するタップの角度を計算することで、タップがどのくさびに当たったかをヒットテストする。
- スワイプ方向の分類:スワイプの
atan2(dy, dx)を上下左右(または8方向)の範囲に振り分ける。 - ポインターを追跡する要素:常にカーソルを指す矢印やインジケーター、ラジアル選択ハイライトなど。
動きと向き:
- 速度ベクトルからの向き:移動方向にスプライト/オブジェクトを向けるため、フレームごとの変位の
atan2(dy, dx)を使う。 - 「見る」/照準ロジック:タレットの回転、ゲーム内の敵がプレイヤーに向く処理、カメラがターゲットに向く処理。
- ジョイスティック/ゲームパッド入力:アナログスティックの生の
(x, y)を、8方向移動やデッドゾーン処理のために方向(角度)と大きさ(半径)に分割する。 - 2点間の方位角:ナビゲーション/経路探索のための
atan2(y2 - y1, x2 - x1)。GPS/コンパス方位のバージョンも、球面上での同じ考え方だ。
グラフィックスとデータビジュアライゼーション:
- 円弧・円グラフの幾何学:セグメントの開始/終了角度を計算すること、あるいは逆に、クリックがどのスライスに当たったかを求めること。
- 一般的な直交座標から極座標への変換:
(x, y)から(r, θ)を求める必要がある場所すべてであり、上記のすべての項目が当てはまる包括的なケース。
信号処理とその他の分野:
- 複素数の偏角:
atan2(imaginary, real)は複素数の位相角を与える。 - DSPにおけるI/Q復調:同相/直交成分から位相を復元する。
- ロボティクス:現在位置とターゲットからの、ウェイポイントへの方位計算。
別種の逆関数:atanh
atan と atan2 はどちらも角度を生成する関数を打ち消す。atanh は代わりに、前述の直感セクションで登場した押し込み関数である tanh を打ち消す。この逆関数を実際に展開すると、独自の形になる。ゼロ付近ではゆっくりと成長し、入力が±1に近づくにつれて無限大へと急激に向かう。これは tanh が同じ端で平坦化していく速さの鏡像だ。
ここにはドラッグジェスチャーや回転は一切関わらない。これは atan2 と同じ「逆関数」というアイデアを、まったく異なる関数のペアに適用したものであり、Android UIコードから遠く離れた場所、つまりある値が自然に境界を持ち、その先の処理で境界のない形に戻す必要がある場所に現れる。
atanh(x): 0.693
tanh(atanh(x)): 0.600 — atanh of 0.60 is 0.693, and tanh of that round-trips back to 0.600
x = 0.60
具体例を1つ挙げる。相関係数 r は常に (-1, 1) に収まるため、これに通常の有意性検定を直接適用するのは扱いにくい。そうした検定は、より正規分布に近いものを想定しているからだ。
は、まさに atanh(r) である。
import kotlin.math.atanh
// r is bounded in (-1, 1); z is not, which is the entire point.
fun fisherZ(r: Double): Double = atanh(r)
fisherZ(0.6) // 0.693
fisherZ(0.99) // 2.647 (close to the edge, so z grows fast here)kotlin.math.atanh は標準ライブラリに含まれており、Android上でも問題なく動作する。ただUIコードでこれを使う理由はほとんどない。UIコードは通常、境界のない値を打ち消す側ではなく、境界のある値(アルファ値、進行度の割合など)を生成する側だからだ。
実際に使うべきメンタルモデル
逆関数は、その入力が見せてくれる範囲のものしか返せない。atan は崩れた1つの比率しか見えないため象限を推測しなければならず、atan2 は符号付きの2つの数値を見るため推測の必要がなく、atanh は境界のある値を見て、tanh がそこから押し込んだ境界のない範囲へと再び展開する。



