HOWTO · Python

在 Python 中計算反餘弦

我們可以使用 acos() 函式和 NumPy 庫在 Python 中計算反餘弦

本頁內容

反餘弦(也稱為 arccos)會求出餘弦值等於指定數值的主值角。它是餘弦函式的反函式,不是餘弦的倒數(1 / cos(x))。在 Python 中,單一數值可使用 math.acos(),陣列計算則可使用 numpy.arccos()。兩者回傳的角度單位都是弧度。

使用 math.acos() 計算單一數值

標準函式庫中的 math.acos() 函式接受介於 -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

此範例會將角度顯示至小數點後一位,輸出中的單位標籤 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]

結果會為每個輸入值提供一個以弧度表示的角度:依序約為 π/3、0 和 π。NumPy 也能計算單一數值的反餘弦,但若只需要一個純量結果,math.acos() 會是較簡單的選擇。

輸入範圍,以及如何選擇 math.acos() 或 numpy.arccos()

若要計算實數反餘弦,每個輸入值都必須介於 -1 和 1 之間,且包含兩個端點。超出此範圍的值沒有實數反餘弦。輸入值超出範圍時,math.acos() 會引發 ValueError。在 NumPy 的一般錯誤設定下,numpy.arccos() 會對超出範圍的元素回傳 nan,並發出執行階段警告。只有在符合計算意義時,才檢查或限制計算所得的餘弦值;限制數值可能會掩蓋上游錯誤。如果數值來自正規化向量的內積,浮點數捨入可能使結果略微超出此範圍。只有確定差異來自捨入誤差時才限制數值,否則應檢查計算過程。對陣列計算時,請先確認哪些元素超出範圍,再使用結果。

單一純量適合使用 math.acos();陣列或向量化計算則適合使用 numpy.arccos()。NumPy 並非 Python 標準函式庫的一部分;在此選用它的主要理由是其陣列操作介面。效能取決於工作負載,不保證對所有輸入規模都更好。