find

k = find(X) は、配列 X 内にある個々の非ゼロ要素の線形インデックスを含むベクトルを返します。

X がベクトルの場合、find は X と同じ方向のベクトルを返します。
X が多次元配列の場合、find は結果の線形インデックスからなる列ベクトルを返します。
X に非ゼロ要素がないか空の場合、find は空の配列を返します。

k = find(X,n) は、X 内の非ゼロ要素に対応するインデックスを最初から数えて n 個返します。

k = find(X,n,direction) は、direction が 'last' の場合、X 内の非ゼロ要素に対応するインデックスを最後から数えて n 個検出します。direction の既定値は 'first' であり、非ゼロ要素に対応するインデックスを最初から数えて n 個検出します。

[row,col] = find(___) は前述の構文に示した任意の入力引数を使用して、配列 X 内にある個々の非ゼロ要素の行と列の添字を返します。

[row,col,v] = find(___) はさらに、X の非ゼロ要素を含むベクトル v を返します。

例

行列内のゼロと非ゼロの要素

3 行 3 列の行列内の非ゼロの要素を検出します。

X = [1 0 2; 0 1 1; 0 0 4]

X = 3×3

     1     0     2
     0     1     1
     0     0     4

k = find(X)

X に対して論理演算子 not を使用して、ゼロの位置を特定します。

k2 = find(~X)

条件を満たす要素

4 行 4 列の魔方陣行列に含まれる 10 未満の要素を、最初から 5 個検出します。

X = magic(4)

X = 4×4

    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

k = find(X<10,5)

対応する X の要素を表示します。

X(k)

特定の値に等しい要素

特定の整数値を検出するには、== 演算子を使用します。例として、奇数の整数からなる 1 行 10 列のベクトル内で 13 に等しい要素を検索します。

x = 1:2:20

x = 1×10

     1     3     5     7     9    11    13    15    17    19

k = find(x==13)

k = 7

非整数値を検出するには、データに基づく許容誤差値を使用します。そうしない場合、浮動小数点の丸め誤差が原因で結果が空の行列になる場合があります。

y = 0:0.1:1

y = 1×11

         0    0.1000    0.2000    0.3000    0.4000    0.5000    0.6000    0.7000    0.8000    0.9000    1.0000

k = find(y==0.3)

k =

  1x0 empty double row vector

k = find(abs(y-0.3) < 0.001)

k = 4

最後の複数の非ゼロ要素

奇数インデックスの要素がすべてゼロに等しい 6 行 6 列の魔方陣行列を作成します。

X = magic(6);
X(1:2:end) = 0

X = 6×6

     0     0     0     0     0     0
     3    32     7    21    23    25
     0     0     0     0     0     0
     8    28    33    17    10    15
     0     0     0     0     0     0
     4    36    29    13    18    11

非ゼロ要素を "最後から数えて" 4 個検出します。

k = find(X,4,'last')

複数の条件を満たす要素

4 行 4 列の行列内で、0 より大きく 10 より小さい要素を最初から数えて 3 個検出します。要素の行と列の添字を返すために 2 つの出力を指定します。

X = [18 3 1 11; 8 10 11 3; 9 14 6 1; 4 3 15 21]

X = 4×4

    18     3     1    11
     8    10    11     3
     9    14     6     1
     4     3    15    21

[row,col] = find(X>0 & X<10,3)

最初のインスタンスは X(2,1) で、値は 8 です。

非ゼロ要素の添字と値

3 行 3 列の行列内の非ゼロの要素を検出します。行の添字、列の添字、要素の値を返す 3 つの出力を指定します。

X = [3 2 0; -5 0 7; 0 0 1]

X = 3×3

     3     2     0
    -5     0     7
     0     0     1

[row,col,v] = find(X)

多次元配列の添字

4 x 2 x 3 の配列の非ゼロ要素を検出します。非ゼロ要素の行と列の添字を返す 2 つの出力 row と col を指定します。入力が多次元配列 (N > 2) である場合、find は col を X の後続の N-1 次元の線形インデックスとして返します。

X = zeros(4,2,3);
X([1 12 19 21]) = 1

[row,col] = find(X)

入力引数

`X` — 入力配列
スカラー | ベクトル | 行列 | 多次元配列

入力配列。スカラー、ベクトル、行列または多次元配列として指定します。X が空の配列であるか、非ゼロ要素を含まない場合、k は空の配列になります。

`n` — 検出する非ゼロの数
正の整数スカラー

検出する非ゼロの数。正の整数スカラーとして指定します。既定では、find(X,n) は X 内の非ゼロ要素を最初から数えて n 個検出します。

`direction` — 探索方向
`'first'` (既定値) | `'last'`

探索方向。文字列 'first' または 'last' で指定します。X 内の非ゼロ要素を "最後から数えて" n 個検出するには find(X,n,'last') を使用します。

出力引数

`k` — 非ゼロ要素のインデックス
ベクトル

非ゼロ要素のインデックス。ベクトルとして返されます。X が行ベクトルの場合、k も行ベクトルになります。それ以外の場合、k は列ベクトルになります。X が空の配列であるか非ゼロ要素を含まない場合、k は空の配列になります。

X(k) を使用すると X 内の非ゼロ値を返すことができます。

`row` — 行の添字
ベクトル

行の添字。ベクトルとして返されます。row と col を共に用いることで、X 内の非ゼロ要素に対応する添字 X(row,col) を指定します。

`col` — 列の添字
ベクトル

列の添字。ベクトルとして返されます。row と col を共に用いることで、X 内の非ゼロ要素に対応する添字 X(row,col) を指定します。

X が N > 2 の多次元配列である場合、col は X の後続の N-1 次元の線形インデックスです。これは、関係 X(row(i),col(i)) == v(i) を保持します。

`v` — `X` の非ゼロの要素
ベクトル

X の非ゼロの要素。ベクトルとして返されます。

詳細