API · NumPy

Python Numpy.where()関数

numpy where()関数は、入力配列の要素をチェックし、指定された条件に従って出力を生成します。

このページの内容

numpy.where() には、結果の異なる2つの形式があります。numpy.where(condition) として呼び出すと、条件が真となる位置を示すインデックス配列を返します。numpy.where(condition, x, y) として呼び出すと、要素ごとに x または y から値を選びます。該当する位置を見つけるには前者を、条件に基づいて配列を作るには後者を使います。

numpy.where() はインデックスを返すか、値を選択する

位置を調べたり、別の処理で使ったりするためのインデックスが必要な場合は、条件だけを渡す形式を選びます。判定結果に応じた値を持つ配列が必要な場合は、3引数の形式を選びます。各結果要素にどちらの値を使うかは条件で決まり、条件が真なら x、偽なら y から選択されます。

numpy.where() の構文と引数

呼び出し形式は numpy.where(condition) と numpy.where(condition, x, y) です。condition には、真偽値によって結果を決める配列のような値を指定します。3引数の形式では、条件が真の位置に x の値を使い、偽の位置に y の値を使います。x と y は必ず一緒に渡します。片方だけを指定することはできません。インデックスが必要な場合は、両方とも省略します。

詳しくは、NumPy 1.18 の numpy.where() ドキュメントを参照してください。この記事では2つの呼び出し形式と以下の例を扱い、あらゆる配列形状の組み合わせまでは説明しません。

numpy.where(condition) で一致するインデックスを取得する

1次元の条件を渡した場合、結果は整数配列を1つ含むタプルです。この整数は入力配列内の位置を表し、その位置にある値そのものではありません。元の配列をインデックス指定する場合はタプルの結果をそのまま使い、インデックス配列だけが必要な場合はタプルの最初の要素を使います。

次の例を実行します。

このセクションのコードと表示されるラベルや出力は英語のままです。

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) で値を選択する

3引数の形式は、位置ではなく選択した値を返します。各位置で条件が真なら、対応する 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() を使う

同じ選択規則は、2次元の条件にも位置ごとに適用されます。出力の各位置では、x または y の対応する位置から値が選ばれます。このため、3引数の形式は、行と列の配置を保ったまま行列を変換するのに役立ちます。

次の例を実行します。

このセクションのコードと表示されるラベルや出力は英語のままです。

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 が入ります。出力は入力と同じ2次元の配置を保ちます。

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() は各位置で選択した分岐を適用します。