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 を選ぶ主な理由です。処理速度はワークロードによって異なり、どの入力サイズでも必ず速くなるとは限りません。