最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

filter2

2 次元のデジタル フィルター

構文

Y = filter2(H,X)

Y = filter2(H,X,shape)

説明

Y = filter2(H,X) は、行列 H の係数に従って、有限インパルス応答フィルターをデータ行列 X に適用します。

Y = filter2(H,X,shape) は、shape に従って、フィルター処理されたデータのサブセクションを返します。たとえば、Y = filter2(H,X,'valid') は、ゼロが加えられたエッジを含めずに計算された、フィルター処理されたデータのみを返します。

例

2 次元台座

関数 filter2 を使用して、イメージやその他の 2 次元データをデジタル フィルター処理できます。この関数は関数 conv2 と密接に関連しています。

内部の高さが 1 と等しい 2 次元台座を作成してプロットします。

A = zeros(10);
A(3:7,3:7) = ones(5);
mesh(A)

フィルター係数の行列 H に従って A 内のデータをフィルター処理し、処理済みデータの非スパース行列を返します。

H = [1 2 1; 0 0 0; -1 -2 -1];
Y = filter2(H,A,'full');
mesh(Y)

H を 180 度回転して、その結果を A と畳み込みます。出力は、H の係数を使用して A 内のデータをフィルター処理した結果と等価です。

C = conv2(A,rot90(H,2));
mesh(C)

入力引数

H — 有理伝達関数の係数

行列

有理伝達関数の係数。行列として指定します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
複素数のサポート: あり

X — 入力データ

行列

入力データ。行列として指定します。X と H の一方または両方が single 型である場合、出力も single 型になります。それ以外の場合、filter2 は double 型を返します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
複素数のサポート: あり

shape — フィルター処理されたデータのサブセクション

'same' (既定値) | 'full' | 'valid'

フィルター処理されたデータのサブセクション。次の値のいずれかとして指定します。

• 'same' — フィルター処理されたデータの中央部分を X と同じサイズで返します。

• 'full' — 非スパース 2 次元のフィルター処理されたデータを返します。

• 'valid' — フィルター処理されたデータのうち、ゼロが加えられたエッジを含めずに計算された部分のみを返します。

アルゴリズム

関数 filter2 は、入力 X と、係数行列 H を 180 度回転した行列との 2 次元の畳み込みを実行して、データをフィルター処理します。具体的には、filter2(H,X,shape) は conv2(X,rot90(H,2),shape) と等価です。

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

使用上の注意事項および制限事項:

• 入力 H と X は single または double の配列でなければなりません。実数型と複素数型の両方がサポートされます。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

参考

conv2 | filter | rot90

R2006a より前に導入