HOWTO · NumPy

在 NumPy 中計算絕對值

NumPy 中有 3 種方法可用於計算絕對值,分別是 abs() 函式、numpy.absolute() 函式和 numpy.abs() 函式。

本頁內容

計算絕對值是資料分析和科學計算中的一項基本操作。在 Python 中,NumPy 函式庫提供了在陣列和數值資料上高效執行這一操作的方法。無論你處理的是簡單的數字清單,還是複雜的多維陣列,理解如何計算絕對值都能提升你的資料處理能力。

在本文中,我們將探討在 NumPy 中計算絕對值的三種主要方法:abs() 函式、numpy.absolute() 和 numpy.abs()。三者關係密切——對 NumPy 陣列而言,它們執行的都是同一個逐元素操作——因此本指南著重說明它們真正的區別:各自接受什麼樣的輸入,以及 NumPy 函式提供了哪些額外的控制。

使用內建函式 abs()

abs() 函式是 Python 的內建函式,回傳一個數的絕對值。它雖然不是 NumPy 專屬的,但可以用於 NumPy 陣列:當你對陣列套用 abs() 時,Python 會呼叫陣列的 __abs__() 方法,也就是 NumPy 自身的絕對值操作,你會得到一個由原始元素絕對值組成的新陣列。

下面是結合 NumPy 使用 abs() 函式的方法:

import numpy as np

array = np.array([-1, -2, 3, -4])
absolute_values = abs(array)

print(absolute_values)

輸出:

[1 2 3 4]

由於 abs() 只是把呼叫轉發給陣列的 __abs__() 方法,它對陣列執行的計算與 numpy.absolute() 完全相同——對 NumPy 資料使用內建函式沒有任何效能損失。它真正的局限在別處:abs() 需要一個定義了 __abs__() 的物件。它可用於 Python 數字、複數和 NumPy 陣列,但對普通的 Python 清單呼叫 abs() 會引發 TypeError,而下文的 NumPy 函式可以直接接受清單。

使用 numpy.absolute()

numpy.absolute() 是 NumPy 自身的絕對值函式,以 ufunc 形式實作。它對任意形狀和大小的陣列逐元素計算絕對值,並且與內建函式不同,它還接受清單等類陣列輸入,會先將其轉換為陣列。作為 ufunc,它還接受常規的 ufunc 參數,例如用 out= 把結果寫入已有的陣列。

下面是使用 numpy.absolute() 的範例:

import numpy as np

array = np.array([[-1, -2, 3], [-4, 5, -6]])
absolute_values = np.absolute(array)

print(absolute_values)

輸出:

[[1 2 3]
 [4 5 6]]

numpy.absolute() 還支援複數,回傳每個元素的模:

import numpy as np

complex_array = np.array([3 + 4j, -5 + 12j])
magnitudes = np.absolute(complex_array)

print(magnitudes)

輸出:

[ 5. 13.]

這使它成為科學計算中穩妥的預設選擇,因為那裡的資料可能是多維的,也可能是複數。

使用 numpy.abs()

numpy.abs() 根本不是一個單獨的實作:它與 numpy.absolute() 是同一個函式物件——在 NumPy 中,np.abs is np.absolute 的求值結果為 True。較短的名字純粹是作為方便的別名存在的。

下面是 numpy.abs() 的用法:

import numpy as np

array = np.array([[1, -2], [-3, 4]])
absolute_values = np.abs(array)

print(absolute_values)

輸出:

[[1 2]
 [3 4]]

由於兩個名字指的是同一個函式,在 numpy.abs() 與 numpy.absolute() 之間選擇只是程式碼風格或可讀性的問題;無論選哪一個,結果和效能都完全相同。

結論

在 NumPy 中計算絕對值很簡單,因為三種方法對陣列執行的都是同一個逐元素操作。當你的值已經是 NumPy 陣列或普通數字、並且想要寫通用的 Python 程式碼時,使用內建的 abs();當你需要傳入清單等類陣列資料,或使用 out= 等 ufunc 選項時,使用 numpy.absolute() 或其別名 numpy.abs()。無論選擇哪種寫法,你得到的數字都是一樣的。

常見問題

  1. abs() 和 numpy.absolute() 有什麼區別?
    區別在介面,不在計算。對 NumPy 陣列而言,abs() 呼叫的是陣列的 __abs__() 方法,與 numpy.absolute() 執行的是同一個操作。numpy.absolute() 還額外接受清單等類陣列輸入和 out= 等 ufunc 參數;而 abs() 對普通清單會引發 TypeError,因為清單沒有定義 __abs__()。

  2. numpy.abs() 可以用於複數嗎?
    可以。三種方法都回傳複數的模;例如,3 + 4j 和 -5 + 12j 的絕對值是 5.0 和 13.0,如上文 numpy.absolute() 的範例所示。

  3. 這些方法之間有效能差異嗎?
    沒有有意義的差異。numpy.abs() 和 numpy.absolute() 是同一個函式物件,而對陣列使用 abs() 也會分派到同一個 NumPy 操作,因此三者做的逐元素工作相同;只有呼叫開銷略有差別,且可以忽略不計。

  4. 多維陣列應該使用哪種方法?
    任何一種都可以——三者都能處理任意形狀的陣列,如上文的二維範例所示。如果輸入可能是清單或其他類陣列,建議優先使用 numpy.absolute() 或 numpy.abs(),因為內建的 abs() 只接受定義了 __abs__() 的物件。

  5. 使用這些函式時輸出有區別嗎?
    沒有。對於相同的輸入,三種方法回傳的值相同。