オペレーター FIRoperatorNxM

Operator Library: Filter

オペレーター FIRoperatorNxMは、パラメータ化可能な係数と入力カーネル要素の乗算の和を計算します。 係数はパラメータ Coefficients を使用して定義できます。

例を見てみましょう。垂直エッジを検出するための次のソベルフィルター係数 H を仮定します。

このフィルターは次の画像 I に適用されます。

位置 I(2,2) = 31 のピクセルについて、出力 O で次の結果が得られます。

必要な入力カーネルを生成するには、FIRkernelNxM、 LineNeighboursNx1、または PixelNeighbours1xM などのオペレーターを使用します。

Operator Restrictions

  • ImageWidth < 2*Parallelism are not allowed

  • 空の画像(つまりピクセルのない画像)は許可されません。

  • 空の行や異なる行の長さは許可されません。

I/O Property

Property 値
オペレータータイプ O
Input Link 私、カーネル入力
Output Link O, data output

サポートされているリンクフォーマット

Link Parameter Input Link I Output Link O
Bit Width [1, 63] 符号なし、[2, 63] 符号付き auto1
Arithmetic {unsigned, signed} auto2
Parallelism any as I
Kernel Columns any 1
Kernel Rows any 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D} as I
Color Format VAF_GRAY as I
Color Flavor FL_NONE as I
Max. Img Width any as I
Max. Img Height any as I

1

必要な出力 Bit Width は、入力 Bit Width、Arithmetic、および係数から自動的に決定されます。

出力 Bit Width は 64 bit を超えてはなりません。

2

出力 Arithmetic は、入力 Arithmetic と係数から自動的に決定されます。 入力が符号付きであるか、少なくとも1つの係数が符号付きである場合、出力は符号付きになります。

パラメーター

Coefficients
タイプ static/dynamic read/write parameter
Default identity
範囲

このパラメータは、フィルターカーネルの係数を定義します。 符号付きおよび符号なしの整数値が許可されます。

オペレーターの入力カーネルサイズが変更されると、係数も変更されます。 入力カーネルサイズの変更後に係数を確認してください。

係数値によって出力 Bit Width が 64 bit を超えることはできません。

CoefficientsType
タイプ static パラメータ
Default SIGNED
範囲 SIGNED, UNSIGNED

このパラメータは、係数の符号(signedness)を定義します。

これは動的係数に対してのみ評価されます。静的係数は常に符号付きです。

CoefficientsMaxBits
タイプ static パラメータ
Default 16
範囲 [2, 16]

このパラメータは、動的係数のサイズをビット単位で定義します。静的係数の場合は使用されません。

この値を小さくすることでリソースを節約できます。想定されるすべての動的係数に対して十分なサイズに設定する必要があります。このパラメータは静的です。実行時における変更はできません。

ImplementationType
タイプ static パラメータ
Default LUT
範囲 (AUTO, EmbeddedALU, LUT)

パラメーター ImplementationType は、オペレーターの実装戦略、つまり、 オペレーターの実装にどのロジック要素が使用されるかに影響します。

以下の値から選択できます:

AUTO: オペレーターがインスタンス化されると、接続されたリンクのパラメーター化に基づいて、最適な実装戦略が自動的に選択されます。

EmbeddedALU: オペレーターは、LUT ベースではない FPGA の組み込み算術論理要素を使用します。

LUT: オペレーターは FPGA の LUT ロジックを使用します。

[注] 通常は AUTO を使用

通常、このパラメータは AUTO に設定する必要があります。 特殊なケース、つまりデザイン内で特定の FPGA リソースが不足している場合は、EmbeddedALU および/または LUT の値を使用して、FPGA リソース管理を手動で調整できます。

使用例

operator FIRoperatorNxM の使用方法は、以下の例で示されています: