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) 获取匹配索引
对于一维条件,结果是一个只含一个元素的元组,其中包含一个整数数组。这些整数表示输入中的位置,而不是这些位置上的数值。使用结果元组索引原数组时可以直接传入该元组;如果只需要索引数组,则取元组的第一个元素。
运行此示例:
本节中的代码以及显示的标签或输出仍为英文。
import numpy as np
values = np.array([4, 9, 12, 7, 15])
matching_positions = np.where(values > 10)
print(matching_positions)
按 Python 从零开始的索引方式,这个条件在位置 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"。这种调用形式要求同时提供这两个备选值。
在多维数组中使用 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() 会在每个位置应用相应的选取规则。