この記事を開いてくださったこと、心から感謝しています。MathArctanとMathArctan2は名前がよく似ていて、どちらで角度を出せばよいのか、迷っている人も多いはずです。
結論から言うと、MathArctanは1つの値(正接)から角度を返す関数、MathArctan2は縦(y)と横(x)の2つの値から角度を返す関数です。どちらも戻り値はラジアンで、公式に書かれています。
また、確認した公式ページに書かれていない点もありました。たとえば、非数や無限大を渡したときの動き、ベクトルを渡す形の説明、マイナスの0の扱いです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、引数、戻り値の範囲、象限ごとの決まり、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathArctanとMathArctan2は、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。受け取る値の数が違い、そのせいで、返せる角度の範囲も違います。
MathArctanは、1つの値から角度を返す関数である
MathArctanの形は、double MathArctan(double value) です。引数のvalueは、正接の値、つまり、縦と横の比にあたる数です。
公式には、xが0のときは0を返す、と書かれています。また、MathArctanの代わりにatanという名前も使える、という説明があります。
戻り値は、-π/2からπ/2までの範囲のラジアンです。円周率の半分を境にした、ちょうど半円分の範囲になります。両端の値を含むかどうかは、公式のページには書かれていません。
- 引数は、正接の値を1つ
- 戻り値は、-π/2からπ/2のラジアン
- 0を渡すと0が返る
- atanという別名も使える
MathArctan2は、縦と横の2つの値から角度を返す関数である
MathArctan2の形は、double MathArctan2(double y, double x) です。1つ目が縦(y)の値、2つ目が横(x)の値で、順番に注意が必要です。
公式には、2つの数の商が正接になる角度をラジアンで返す、と書かれています。戻り値は、-πからπまでの範囲です。MathArctanの2倍の幅があり、全方向を表せます。
公式には、MathArctan2の代わりにatan2という名前も使える、という説明があります。ページ上の形の表記では、2つの引数のあいだのカンマが抜けていますが、これは公式ページ側の表記のずれと見られます。
- 引数は、縦(y)と横(x)の順に2つ
- 戻り値は、-πからπのラジアン
- atan2という別名も使える
- ページの形の表記は、カンマが抜けている
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathArctan | MathArctan2 |
|---|---|---|
| 引数の数 | 1つ(正接の値) | 2つ(縦yと横x) |
| 戻り値の範囲 | -π/2からπ/2 | -πからπ |
| 向きの区別 | できない | 象限ごとに区別できる |
| 別名 | atan | atan2 |
| 非数や無限大 | 記載なし | 記載なし |
| ベクトルを渡す形 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
MathArctan2は、象限をどう扱うのか?
2つの関数の最大の違いは、角度が、どの向きなのかまで決められるかどうかです。公式には、MathArctan2の象限ごとの決まりが、細かく書かれています。
象限ごとに、角度の範囲が決まっている
公式には、横と縦の組み合わせごとに、角度の範囲が書かれています。右上、左上、左下、右下の4つの区画に分けた形です。
| 象限 | 角度θの範囲 |
|---|---|
| 第1象限(右上) | 0より大きく、π/2より小さい |
| 第2象限(左上) | π/2より大きく、π以下 |
| 第3象限(左下) | -πより大きく、-π/2より小さい |
| 第4象限(右下) | -π/2より大きく、0より小さい |
※公式の説明をもとにした、筆者の整理です。
MathArctanは、縦と横の比を1つの値にまとめて渡すため、右上と左下のように、比が同じになる位置を区別できません。この点は、公式の説明そのものではなく、筆者の補足です。
境目の値も、細かく決まっている
縦や横が0のときの動きも、公式に書かれています。座標の軸の上にある場合の決まりです。
| 条件 | 角度θ |
|---|---|
| yが0で、xが負でない | 0 |
| yが0で、xが負 | π |
| yが正で、xが0 | π/2 |
| yが負で、xが0 | -π/2 |
| yが0で、xも0 | 0 |
※公式の説明をもとにした、筆者の整理です。
xが0のとき、縦と横の比は割り算ができない形になります。MathArctan2は、その場合でも、決まった角度を返すと書かれています。MathArctanには、このような場合分けの説明は、ありません。
- 軸の上でも、決まった角度が返る
- xとyが両方0でも、0が返る
- マイナスの0の扱いは、記載なし
書かれていない点は、自分で確かめる
非数や無限大を渡したときの動きは、どちらの関数でも、確認した公式ページには書かれていません。マイナスの0を渡したときの結果も、記載がありません。
- 非数や無限大を渡したとき:記載なし
- マイナスの0を渡したとき:記載なし
- GetLastErrorとの関係:記載なし
- ベクトルを渡す形:記載なし
このため、結果をそのまま使う前に、自分の環境で、代表的な値を使って確かめる流れにしておくと安心です。
公式サンプルは、どう読めばよいのか?
公式ページのサンプルは、ベクトルを使って、たくさんの値を一度に作る作りです。それぞれの読み方を整理します。
MathArctanのサンプルは、0から2πまでの値に当てている
MathArctanのサンプルでは、101個の要素を持つベクトルに、0から2πまでを等しい間隔で入れます。そのベクトルにMathArctanを当てて、結果を曲線として描きます。
描いたあとは、ESCキーで終了、PgDnキーで画面の保存ができる作りです。結果の欄は画像で示されており、文字としての出力はありません。
- 0から2πまでを、101個の点に分ける
- MathArctanを当てて、曲線を描く
- ESCで終了、PgDnで保存
曲線は、値が大きくなるにつれて、ゆるやかに頭打ちになる形になります。これは、戻り値が-π/2からπ/2の範囲に収まるためで、公式の説明からの読み取りです。
MathArctan2のサンプルは、10個の値を並べている
MathArctan2のサンプルでは、10個の要素を持つベクトルで、0から90までを10刻みで作ります。縦と横に同じ値を入れて、配列に変えてから、1つずつMathArctan2を当てます。
ただし、サンプルでは、計算した結果の配列が、そのあと表示にも描画にも使われていません。描かれるのは、縦と横の値の組のほうです。コメントの文言も、実際の要素の数とずれています。
- 縦と横に、同じ値を入れている
- 結果の配列は、使われていない
- コメントの文言と、実際の数がずれている
このように、公式サンプルは、関数の呼び方を示すのが主な目的で、結果をそのまま読み取るものではありません。実際に使うときは、自分で結果を表示して、確かめてください。
サンプルが、ベクトルを渡している点に注意する
公式の形の説明は、実数を受け取る関数ですが、MathArctanのサンプルでは、ベクトルをそのまま渡しています。ベクトルを渡す形の説明は、確認した公式ページには、書かれていません。
- 形の説明は、実数のみ
- サンプルは、ベクトルを渡している
- ベクトル版の説明は、記載なし
正弦や余弦のほうの関数は、MathSinとMathCosの記事で整理しています。逆に、角度から値を求める側の整理として、あわせて読むと流れがつかみやすくなります。
どう使い分ければよいのか?
縦と横の両方が分かっているなら、MathArctan2が基本です。正接の値だけが手元にあり、向きを区別しなくてよい場合は、MathArctanを選びます。
比の値だけから角度を出すなら、MathArctanを選ぶ
縦と横の比が、すでに1つの数になっていて、右向きの範囲だけで足りるなら、MathArctanで十分です。呼び方も単純で、引数が1つで済みます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
向きまで決めたいなら、MathArctan2を選ぶ
縦と横の値がそれぞれ分かっていて、左右や上下の向きまで区別したいなら、MathArctan2を選びます。象限ごとの決まりがあるため、向きの取り違えを防げます。
- 縦と横の値が、それぞれ分かっている
- 向きまで区別したい
- 戻り値は、-πからπ
引数の順番は、縦(y)が先で、横(x)が後です。数学の記法と、順番が逆になるように感じる人もいるため、呼ぶときに、順番を確かめておくと安心です。
正弦の逆の関数も、公式にある
公式には、正弦の逆にあたるMathArcsinという関数もあります。引数が-1から1の範囲の外にあると、非数が返ると書かれています。戻り値は、-π/2からπ/2のラジアンです。
ただし、関数の形の横の注釈は「-1<value<1」となっており、両端の-1と1を含むかどうかは、はっきり読み取れません。この表記のずれは、公式ページ側のものです。
- MathArcsinは、正弦の逆の関数
- 範囲外では、非数が返る
- 両端の扱いは、表記があいまい
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、簡単な値を使って、スクリプトで確かめるのが安心です。
まずは、軸の上の値で確かめる
最初は、縦や横が0になる値を渡して、MathArctan2の結果を表示します。公式の決まりどおりの角度が返るかを、自分の目で確かめます。
- yが0で、xが正の値
- yが正で、xが0
- 結果が決まりどおりか見る
次に、4つの象限を順に確かめる
次に、右上、左上、左下、右下のそれぞれで、1つずつ値を渡します。MathArctanの結果と並べて表示すると、向きの違いが見えてきます。
- 4つの象限から、1つずつ選ぶ
- MathArctanの結果と並べる
- 向きの違いを確かめる
最後に、結果の単位を確かめる
戻り値は、どちらもラジアンです。度数で見たいときは、自分で変換する必要がありますが、その方法は、公式のこのページには、載っていません。









- まず、軸の上の値で確かめる
- 次に、4つの象限を順に確かめる
- 最後に、結果の単位を確かめる
結果を表示するときの桁数をそろえたい場合は、NormalizeDoubleとMathRoundの記事で、丸めの関数の違いを整理しています。
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
MathArctan2の引数は、どちらが先なのか?
公式の形は、MathArctan2(y, x) で、縦(y)が先、横(x)が後です。逆に渡すと、意図とは違う角度になるため、呼ぶときに順番を確かめましょう。
- 1つ目は、縦(y)
- 2つ目は、横(x)
度数で、結果を受け取れるのか?
公式には、戻り値はラジアンと書かれています。度数への変換の方法は、このページには、記載がありません。自分で計算して変換する形になります。
- 戻り値は、ラジアン
- 度数への変換は、記載なし
非数や無限大を渡すと、どうなるのか?
確認した公式ページには、書かれていません。記載なしなので、自分の環境で、実際に試してから使うのが安心です。
- 公式には、記載なし
- 自分の環境で確かめる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のMathArctanとMathArctan2、傾きの値だけから角度を出す手軽さと縦横の2つの値から向きまで決める確かさどっちを使う?」
1つの値だけで足りるならMathArctan、縦と横の向きまで決めるならMathArctan2です。どちらもラジアンで返るため、記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










