Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【PHP8.x】atan2()関数の使い方

atan2関数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

atan2関数は、2つの引数に基づいたアークタンジェントを計算する関数です。具体的には、atan2(y, x)のように呼び出し、y / x のアークタンジェントをラジアンで返します。この関数は、x軸から点 (x, y) までの角度を計算する際に特に有用です。通常の atan(y/x) 関数と異なり、atan2 関数は x の符号も考慮するため、全象限において正しい角度を決定できます。

x が正の場合、返り値は atan(y/x) と同じになります。x が 0 で y が正の場合、返り値は PI/2 になります。x が 0 で y が負の場合、返り値は -PI/2 になります。x が負の場合、返り値は atan(y/x) + PI となります。引数には数値または数値に変換可能な値を指定できます。戻り値は、-PI から PI までのラジアンで表された角度です。この関数は、三角関数や座標変換などを扱うプログラムで、角度を正確に求める必要がある場合に利用されます。

構文(syntax)

1atan2 ( float $y , float $x ) : float

引数(parameters)

float $y, float $x

  • float $y: y座標を指定する浮動小数点数
  • float $x: x座標を指定する浮動小数点数

戻り値(return)

float

atan2関数は、指定された2つの数値(Y座標とX座標)から、原点(0,0)と点(X,Y)を結ぶ線分がX軸の正の方向となす角度をラジアン単位で返します。

サンプルコード

PHP atan2で座標から角度を計算する

1<?php
2
3// `atan2`関数は、与えられたY座標とX座標から、その点とX軸のなす角度をラジアンで計算します。
4// 結果は -π から π の範囲で返され、4つの象限すべてを正確に扱えます。
5// 幾何学的な計算や、2点間の方向を求める際などに利用されます。
6
7/**
8 * 指定された座標の角度を計算し、ラジアンと度数で表示します。
9 *
10 * @param float $y Y座標
11 * @param float $x X座標
12 */
13function calculateAndDisplayAngle(float $y, float $x): void
14{
15    // atan2関数で角度をラジアンで計算します。
16    $radians = atan2($y, $x);
17    // ラジアンを度数に変換します (1ラジアンは約57.2958度)。
18    $degrees = rad2deg($radians);
19
20    echo "座標 (x: $x, y: $y):\n";
21    echo "  ラジアン: " . $radians . "\n";
22    echo "  度数: " . $degrees . "°\n\n";
23}
24
25// さまざまな座標における角度の計算例
26
27// 正のX軸上 (角度0度)
28calculateAndDisplayAngle(0.0, 1.0);
29
30// 正のY軸上 (角度90度)
31calculateAndDisplayAngle(1.0, 0.0);
32
33// 負のX軸上 (角度180度)
34calculateAndDisplayAngle(0.0, -1.0);
35
36// 負のY軸上 (角度-90度 または 270度)
37calculateAndDisplayAngle(-1.0, 0.0);
38
39// 第1象限 (X, Y共に正、例: 45度)
40calculateAndDisplayAngle(1.0, 1.0);
41
42// 第2象限 (Xが負、Yが正、例: 135度)
43calculateAndDisplayAngle(1.0, -1.0);
44
45// 第3象限 (X, Y共に負、例: -135度)
46calculateAndDisplayAngle(-1.0, -1.0);
47
48// 第4象限 (Xが正、Yが負、例: -45度)
49calculateAndDisplayAngle(-1.0, 1.0);
50
51?>

PHPのatan2関数は、与えられたY座標($y)とX座標($x)から、その点がX軸の正の方向となす角度を計算する数学関数です。この関数は、引数としてfloat型のY座標とX座標を受け取り、結果としてfloat型のラジアン値を返します。戻り値の角度は-π(約-3.14159)からπ(約3.14159)の範囲で表現され、4つの象限すべてを正確に扱えるのが大きな特徴です。特に、X座標が0の場合や、同じ絶対値の角度でも象限によって異なる符号を持つ場合でも、YとXの両方の情報から正確な角度を導き出します。

サンプルコードでは、calculateAndDisplayAngle関数を使って、様々なX、Y座標におけるatan2関数の動作を示しています。例えば、正のX軸上、正のY軸上、そして第1象限から第4象限までの代表的な座標について、atan2関数で計算されたラジアン値と、それをrad2deg関数で度数に変換した値が表示されます。これにより、atan2関数が点の位置に応じてどのような角度を返すのか、視覚的に理解できます。この関数は、幾何学的な計算や、2点間の方向を求める際など、位置関係を扱う様々なプログラミングで活用されます。

atan2関数を利用する際は、引数の順序がY座標、X座標の順であることに注意してください。一般的な座標表記と異なり、atan2($y, $x)となります。また、本関数の戻り値はラジアン単位ですので、度数で扱いたい場合はrad2deg関数を用いて変換する必要があります。結果は-πからπ(-180度から180度)の範囲で返されるため、0度から360度の範囲で角度が必要な場合は、負の値に360度を加えるなどの調整が必要になることがあります。これらの点を理解し、幾何学的な計算や二点間の方向算出に活用してください。

PHP atan2 関数で座標から角度を計算する

1<?php
2
3/**
4 * このスクリプトは、PHPの atan2() 関数を使用して、座標 (x, y) からX軸に対する角度を計算する方法を示します。
5 * atan2() は、円周上のどの象限に点があるかを考慮して正確な角度を返します。
6 * 戻り値はラジアン単位なので、rad2deg() を使って度数に変換して表示します。
7 */
8
9// 点(x, y)の座標を定義します。
10// 例1: 第一象限 (x=1, y=1)
11$x1 = 1.0;
12$y1 = 1.0;
13
14// atan2() 関数を呼び出して角度(ラジアン)を計算します。
15// 引数の順番は atan2(y, x) であることに注意してください。
16$angle1_radians = atan2($y1, $x1);
17
18// ラジアンを度数に変換します。
19$angle1_degrees = rad2deg($angle1_radians);
20
21echo "点 (x={$x1}, y={$y1}):\n";
22echo "  角度 (ラジアン): {$angle1_radians}\n";
23echo "  角度 (度数):   {$angle1_degrees}度\n\n";
24
25// 例2: 第二象限 (x=-1, y=1)
26$x2 = -1.0;
27$y2 = 1.0;
28
29$angle2_radians = atan2($y2, $x2);
30$angle2_degrees = rad2deg($angle2_radians);
31
32echo "点 (x={$x2}, y={$y2}):\n";
33echo "  角度 (ラジアン): {$angle2_radians}\n";
34echo "  角度 (度数):   {$angle2_degrees}度\n\n";
35
36// 例3: 第三象限 (x=-1, y=-1)
37$x3 = -1.0;
38$y3 = -1.0;
39
40$angle3_radians = atan2($y3, $x3);
41$angle3_degrees = rad2deg($angle3_radians);
42
43echo "点 (x={$x3}, y={$y3}):\n";
44echo "  角度 (ラジアン): {$angle3_radians}\n";
45echo "  角度 (度数):   {$angle3_degrees}度\n\n";
46
47// 例4: 第四象限 (x=1, y=-1)
48$x4 = 1.0;
49$y4 = -1.0;
50
51$angle4_radians = atan2($y4, $x4);
52$angle4_degrees = rad2deg($angle4_radians);
53
54echo "点 (x={$x4}, y={$y4}):\n";
55echo "  角度 (ラジアン): {$angle4_radians}\n";
56echo "  角度 (度数):   {$angle4_degrees}度\n\n";
57
58?>

このサンプルコードは、PHPのatan2()関数を使用して、指定された座標(x, y)からX軸に対する角度を計算する方法を示しています。atan2()関数は、通常のatan()関数とは異なり、X座標とY座標の両方を引数として受け取ることで、点がどの象限(座標平面上の領域)にあるかを正確に判断し、-πからπラジアン(-180度から180度)の範囲で正しい角度を返します。

引数には、最初にY座標を示す$y、次にX座標を示す$xをそれぞれ浮動小数点数で渡します。戻り値は、計算された角度を浮動小数点数のラジアン単位で返します。ラジアンは数学や物理学で用いられる角度の単位ですが、人間が理解しやすい度数に変換するには、rad2deg()関数を使用します。

サンプルコードでは、第一象限から第四象限までの異なる座標の例を通して、atan2()関数がどのように機能するか、そしてrad2deg()関数で度数に変換して表示するまでの一連の流れを確認できます。これにより、数学的な角度計算をプログラミングで行う際の基礎を理解できます。

atan2()関数を使用する際は、引数の順序がY座標、次にX座標である点にご注意ください。戻り値はラジアン単位(float型)で返されるため、度数に変換したい場合はrad2deg()関数を利用します。この関数は、与えられた座標がどの象限にあるかを考慮し、X軸からの正確な角度を-180度から180度の範囲で計算します。これにより、通常のatan()関数では対応できない象限による角度の違いも適切に扱え、より信頼性の高い座標計算が可能です。

関連コンテンツ

関連プログラミング言語