HOWTO · Python
Pythonで逆余弦(アークコサイン)を計算する
acos()関数と NumPy ライブラリを使用して、Python で余弦の逆関数を計算できます
このページの内容
逆余弦(アークコサイン)は、与えられた値を余弦とする主値の角度を求めます。余弦の逆関数であり、逆数(1 / cos(x))ではありません。Python では、1つの数値には math.acos()、配列の計算には numpy.arccos() を使います。どちらも角度をラジアンで返します。
1つの値に math.acos() を使う
標準ライブラリの math.acos() 関数は、-1 以上 1 以下の実数を1つ受け取ります。たとえば、余弦が 0.5 となる角度は π/3 ラジアン、つまり 60 度です。
次の例を実行してください。
このセクションのコードと表示されるラベルや出力は英語のままです。
import math
cosine_value = 0.5
angle_radians = math.acos(cosine_value)
print(angle_radians)
1.0471975511965979
この例は角度をラジアンで表示します。戻り値は約 1.0472 で、π/3 に相当します。逆余弦の主値は 0 以上 π 以下のラジアンです。
結果をラジアンから度に変換する
結果を度に変換するには math.degrees() を使います。degrees() は math モジュールの関数で、単独で使える組み込み関数ではありません。書式指定で表示する小数桁数を調整できますが、元の浮動小数点値の精度は変わりません。
このセクションのコードと表示されるラベルや出力は英語のままです。
import math
cosine_value = 0.5
angle_radians = math.acos(cosine_value)
angle_degrees = math.degrees(angle_radians)
print(f"{angle_degrees:.1f} degrees")
60.0 degrees
この例では角度を小数点以下1桁で表示します。出力の「degrees」というラベルはコード例のとおり英語のままです。書式化した文字列の小数桁数は、.1f の数字を増減して指定できます。
配列に numpy.arccos() を使う
NumPy はサードパーティ製パッケージなので、この例を使う前に実行環境へインストールしてください。arccos 演算は配列の各要素に適用されます。入力がすでに NumPy のデータとしてまとまっている場合に便利です。
このセクションのコードと表示されるラベルや出力は英語のままです。
import numpy as np
cosine_values = np.array([0.5, 1.0, -1.0])
angles_radians = np.arccos(cosine_values)
print(angles_radians)
[1.04719755 0. 3.14159265]
結果には各入力に対応するラジアン単位の角度が1つずつ含まれ、値は順に約 π/3、0、π です。NumPy でも1つの値の逆余弦を計算できますが、スカラー値を1つだけ求める場合は math.acos() のほうが簡潔です。
入力範囲と math.acos()、numpy.arccos() の選び方
実数の逆余弦を求める場合、各入力値は -1 以上 1 以下でなければなりません。この範囲外の値には実数のアークコサインがありません。範囲外の値を math.acos() に渡すと ValueError が発生します。NumPy の通常のエラー設定では、numpy.arccos() は該当する要素に nan を返し、実行時警告を出します。計算した余弦値の確認や範囲内への補正は、その計算の意味に合う場合に限って行ってください。補正によって、上流で発生した誤りが見えなくなることがあります。正規化済みベクトルの内積から得た値は、浮動小数点の丸めによって範囲をわずかに外れることがあります。丸め誤差だと分かっている場合に限って補正し、それ以外の場合は計算を調べてください。配列の場合は、結果を使う前に範囲外の要素を確認します。
スカラー値1つには math.acos()、配列やベクトル化計算には numpy.arccos() を選びます。NumPy は Python の標準ライブラリには含まれません。ここでは、配列指向のインターフェースが NumPy を選ぶ主な理由です。処理速度はワークロードによって異なり、どの入力サイズでも必ず速くなるとは限りません。