API · NumPy

Python Numpy.where() 函式

numpy.where()函式檢查輸入陣列中的元素,並根據指定的條件生成輸出。

本頁內容

numpy.where() 有兩種形式,會產生不同結果。以 numpy.where(condition) 呼叫時,會傳回條件為真的位置索引陣列。以 numpy.where(condition, x, y) 呼叫時,則會逐項從 x 或 y 選取值。需要找出符合條件的位置時使用第一種形式;需要依條件建立陣列時使用第二種形式。

numpy.where() 會傳回索引或選取值

需要取得位置時,例如要檢查索引或在其他操作中使用索引,請選擇只提供條件的形式。需要依測試結果決定輸出值時,請選擇三個引數的形式。條件會決定每個結果元素取自哪一個分支:條件為真時取自 x;為假時取自 y。

numpy.where() 的語法與參數

呼叫形式為 numpy.where(condition) 和 numpy.where(condition, x, y)。condition 引數是類似陣列的值,其真值會決定結果。在三引數形式中,條件為真的位置取自 x,條件為假的位置取自 y。x 和 y 必須一起提供,不能只提供其中一個。若要取得索引,則兩者都不提供。

詳細資訊請參閱 NumPy 1.18 的 numpy.where() 文件。本文著重介紹這兩種呼叫形式及下方範例,不涵蓋所有陣列形狀的組合。

使用 numpy.where(condition) 取得符合條件的索引

對一維條件而言,結果是只含一個元素的 tuple,其中包含一個整數陣列。這些整數代表輸入中的位置,而不是那些位置上的值。若要索引原始陣列,可以直接使用 tuple 結果;若只需要索引陣列,則使用 tuple 的第一個元素。

執行此範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

import numpy as np

values = np.array([4, 9, 12, 7, 15])
matching_positions = np.where(values > 10)
print(matching_positions)

使用 Python 從 0 開始的索引方式,這個條件在位置 2 和 4 為真。因此,傳回的索引陣列指出哪些位置的值符合條件;陣列本身不包含 12 和 15 這兩個值。

使用 numpy.where(condition, x, y) 選取值

三引數形式傳回的是選取後的值,而不是位置。在每個位置上,條件為真時會取用 x 中對應的值,條件為假時則會取用 y 中的值。例如,這種形式適合替換未通過門檻的值,同時保留通過門檻的值。

執行此範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

import numpy as np

scores = np.array([42, 81, 67, 95])
labels = np.where(scores >= 70, "pass", "review")
print(labels)

此處會將每個分數與 70 比較。結果中,分數大於或等於門檻時會出現 "pass",其餘則會出現 "review"。這兩個替代值都已提供,符合此呼叫形式的要求。程式碼範例中的 pass 和 review 標籤維持英文,以保留原始程式碼內容。

在多維陣列中使用 numpy.where()

相同的選取規則也會逐位置套用於二維條件。每個輸出位置都會從 x 或 y 的對應位置選取值。因此,三引數形式可用來轉換矩陣,同時保留原有的列與欄排列。

執行此範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

import numpy as np

values = np.array([[10, 25, 30], [18, 50, 5]])
replacement = np.full(values.shape, -1)
selected = np.where(values > 20, values, replacement)
print(selected)

條件會逐一檢查每個元素。大於 20 的值會保留在結果中,其他位置則取用 replacement 中對應的 -1。輸出會維持與輸入相同的二維排列。

使用 numpy.where() 合併條件

若要合併逐項比較,請將每個比較式放在括號內,再用 & 連接,表示「兩個條件都成立」;或用 | 連接,表示「至少一個條件成立」。這些運算子適用於陣列條件。Python 用於純量的 and 和 or 運算子,不能取代逐項合併陣列比較結果的做法。

執行此範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

import numpy as np

values = np.array([1, 2, 3, 4, 5])
in_range = (values > 1) & (values < 5)
selected = np.where(in_range, values, 0)
print(selected)

合併後的條件在 2、3 和 4 這些值上為真,因此會保留這些值;範圍外的位置則會得到 0。若要測試「符合其中一項」的條件,可在括號括住的比較式之間使用 |,例如 (values < 2) | (values > 4)。每個比較式都會產生一個真值陣列,接著 numpy.where() 會逐位置套用選取的分支。