Buffer

入力シーケンスの小さいフレームサイズまたは大きいフレームサイズへのバッファリング

ライブラリ:
DSP System Toolbox / Signal Management / Buffers

説明

Buffer ブロックは常にフレームベースの処理を実行します。ブロックは入力の各列にデータを再分散して異なるフレームサイズで出力を生成します。信号をより大きいフレームサイズにバッファリングすると、入力よりも "遅い" フレームレートの出力が得られます。たとえば、次の図のようなスカラー入力を検討します。

信号をより小さいフレームサイズにバッファリングすると、入力よりも "速い" フレームレートの出力が得られます。たとえば、次の図のようなスカラー出力を検討します。

ブロックによってオーバーラップのないバッファーの出力 "フレームサイズ" と "フレームレート" が調整されるため、信号のサンプル周期は次のように入力と出力の両方で同じになっています。T_so = T_si

このブロックは、ブロックの入力レートと出力レートが同じ場合は、Triggered Subsystem をサポートします。

例

ウェルチ法を使用したストリーミングパワースペクトル推定

平均修正ピリオドグラムのウェルチ法を使用してパワースペクトルを推定します。

スクリプトを開く

Buffering Input with Overlap

Buffer a two-channel input using an Output buffer size of three and four and a Buffer overlap of one.

スクリプトを開く

Compute Mean Using Sliding Window

Model a sliding window using the Buffer block. The Mean block use this window to compute the mean.

モデルを開く

端子

入力

すべて展開する

Port_1 — 入力信号
スカラー | ベクトル | 行列

単一チャネル信号をバッファリングするには、スカラーまたは列ベクトルを入力します。マルチチャネル信号をバッファリングするには、行ベクトルまたは行列を入力します。単一チャネル信号をバッファリングするには、サイズが M_i 行 1 列のスカラーまたは列ベクトルを入力します。ここで、M_i は入力フレームサイズです。

出力

すべて展開する

Port_1 — 出力信号
ベクトル | 行列

バッファリングした入力信号。ベクトルまたは行列として返されます。

入力が単一チャネル信号の場合、次のようになります。

1 行 1 列 (スカラー) — 出力は、M_o 行 1 列のベクトル。
M_i 行 1 列 (列ベクトル) — 出力は、M_o 行 1 列のベクトル。

ここで、

M_i — 入力フレームサイズ
M_o — [出力バッファーサイズ] パラメーターの値

入力フレーム周期は M_i · T_si です。ここで T_si は入力サンプル周期です。出力フレーム周期は $(M_{o} - L) T_{s i}$ です。ここで L は [バッファーオーバーラップ] パラメーターの値、T_si は入力サンプル周期です。[バッファーオーバーラップ] パラメーターを M_o – 1 に設定すると、出力フレーム周期が入力サンプル周期と等しくなります。

入力がマルチチャネル信号の場合、次のようになります。

1 行 N 列 — 出力は、M_o 行 N 列の行列。
M_i 行 N 列 — 出力は、M_o 行 N 列の行列。

ここで、

N — 信号のチャネル数
M_i — 入力フレーム周期
M_o は [出力バッファーサイズ] パラメーターの値で、入力フレームサイズ M_i より大きいまたは小さい場合があります。ブロックは N 個の入力チャネルをそれぞれ個別にバッファリングします。

入力フレーム周期は M_i · T_si となります。出力フレーム周期は $(M_{o} - L) T_{s i}$ で、[バッファーオーバーラップ] が $M_{o} - 1$ の場合にシーケンスサンプル周期と等しくなります。したがって、出力サンプル周期 T_so は次のように、入力サンプル周期 T_si と関連付けられます。

$T_{s o} = \frac{(M_{o} - L) T_{s i}}{M_{i}}$

出力は入力と同じデータ型および実数/複素数をもちます。

パラメーター

すべて展開する

出力バッファーサイズ (チャネルあたり) — バッファーサイズ
`64` (既定値) | 正の整数

各チャネルから出力フレームにバッファリングする連続サンプル数 M_o を指定します。

データ型: double | int8 | int16 | int32 | uint8 | uint16 | uint32

バッファーオーバーラップ — バッファーオーバーラップ
`0` (既定値) | 整数

サンプル数 L を指定します。連続する出力フレームのそれぞれでオーバーラップまたはアンダーラップする量を指定します。

バッファーでデータをオーバーラップするには、L の値を $0 \leq L < M_{o}$ の範囲で指定します。ここで、M_o は [出力バッファーサイズ] パラメーターの値です。ブロックは現在の出力から L 個のサンプル (列) を取得し、次の出力でそれを繰り返します。オーバーラップする場合、ブロックは $M_{o} - L$ の "新しい" 入力サンプルを取得してから、バッファリングされたデータを出力に伝播します。

$L < 0$ の場合、信号をアンダーラップでバッファリングしています。ブロックはバッファーが満杯になると L 個の入力サンプルを破棄し、周期 $(M_{o} - L) T_{s i}$ でバッファーを出力します。それにより、オーバーラップがゼロの場合よりも長くなります。

出力フレーム周期は $(M_{o} - L) T_{s i}$ で、入力シーケンスサンプル周期 T_si と等しくなります。ここで [バッファーオーバーラップ] は $M_{o} - 1$ です。

データ型: double | int8 | int16 | int32 | uint8 | uint16 | uint32

初期条件 — 初期出力
`0` (既定値) | スカラー | ベクトル | 行列

非ゼロレイテンシの場合のブロックの初期出力値を指定します。スカラー、ベクトルまたは行列のいずれかとして指定します。

ゼロタスクレイテンシに記載されたケースを除くすべてのシングルタスク演算 (Simulink Coder)では、Buffer ブロックのバッファーは [初期条件] パラメーターで指定される値に初期化されます。ブロックはこのバッファーから読み取って最初の D 個の出力サンプルを生成します。ここで、

$D = {\begin{matrix} M_{o} + L & (L \geq 0) \\ M_{o} & (L < 0) \end{matrix}$

[初期条件] パラメーターの次元は [バッファーオーバーラップ] L と入力が単一チャネルであるかマルチチャネルであるかによって異なります。

$L \neq 0$ の場合、[初期条件] パラメーターはスカラーでなければなりません。
$L = 0$ の場合、[初期条件] パラメーターはスカラーまたは次のいずれかの制約のあるベクトルにすることができます。
- 単一チャネル入力の場合、[初期条件] パラメーターは長さが M_o のベクトル (M_i が 1 の場合) または長さが M_i のベクトル (M_o が 1 の場合) にすることができます。
- マルチチャネル入力の場合、[初期条件] パラメーターは長さが M_o * N のベクトル (M_i が 1 の場合) または長さが M_i * N のベクトル (M_o が 1 の場合) にすることができます。

すべてのマルチタスク演算 (Simulink Coder)では、関数 rebuffer_delay を使用して、Buffer ブロックが指定の組み合わせのバッファーサイズとバッファーオーバーラップに対して生成する遅延の正確な値 (サンプル数) を計算します。

任意のフレームサイズ間での全般的なバッファリングでは、[初期条件] パラメーターはスカラーでなければなりません。その後、この値は初期出力のすべての要素で繰り返されます。ただし、入力が 1 行 N 列の行ベクトルで、ブロックの出力が M_o 行 N 列の行列である特別なケースの場合、[初期条件] は次のいずれかになります。

M_o 行 N 列の行列
初期出力のすべての列で繰り返される、長さが M_o のベクトル
初期出力のすべての要素で繰り返されるスカラー

出力が 1 行 N 列の行ベクトル、つまり M_i 行 N 列の行列をバッファー解除した結果として得られる、特別なケースの場合、[初期条件] は次のいずれかになります。

最初の M_i サンプル時間中に各チャネルに対して順番に出力される M_i サンプルを含むベクトル
初期出力のすべての要素で繰り返されるスカラー

レイテンシと Simulink^® タスクモードの詳細については、Excess Algorithmic Delay (Tasking Latency)と時間ベースのスケジューリングとコード生成 (Simulink Coder)を参照してください。

ブロックの特性

データ型	`Boolean` \| `double` \| `fixed point` \| `integer` \| `single`
直達	`いいえ`
多次元信号	`いいえ`
可変サイズの信号	`いいえ`
ゼロクロッシング検出	`いいえ`

詳細

すべて展開する

ゼロタスクレイテンシ

"ゼロタスクレイテンシ" とは、t = 0 で受信した最初の入力サンプルが最初の出力サンプルとして表示されることを意味します。Simulink シングルタスクモード (Simulink Coder)では、Buffer ブロックは次のような特別な場合にゼロタスクレイテンシになります。

スカラー入力と出力 ( $M_{o} = M_{i} = 1$ ) にゼロまたは負の [バッファーオーバーラップ] ( $L \leq 0$ ) がある
入力フレームサイズが出力フレームサイズの整数倍である

$M_{i} = k M_{o}$
ここで k は [バッファーオーバーラップ] ( $L = 0$ ) がゼロの整数です。このような主な例として以下が挙げられます。
- スカラー出力 ( $M_{o} = 1$ ) をもち、[バッファーオーバーラップ] がゼロ ( $L = 0$ ) の任意の入力フレームサイズ M_i
- [バッファーオーバーラップ] がゼロ ( $M_{o} = M_{i}$ ) で、等しい入力フレームサイズと出力フレームサイズ ( $L = 0$ )

オーバーランとアンダーラン

次の条件では、Enabled Subsystem で Buffer ブロックを使用できません。

マルチレートのマルチタスク環境内
[バッファーオーバーラップ] パラメーターが負の値に設定されている場合

Buffer ブロックは一時的にデータを格納する内部貯蔵庫をもっています。Buffer ブロックが Enabled Subsystem で使用されると、この貯蔵庫がオーバーランまたはアンダーラン状態になる可能性があります。ブロックはこの状況の発生に対するセーフガードを実装します。

オーバーランは、バッファーの容量以上のデータがバッファーに入力されると発生します。たとえば、サイズ 3 のフレームへのスカラー入力のバッファリングが、1 秒ごとに入力を受け入れて 3 秒ごとに出力を行うバッファーを使用する場合を考えます。このバッファーを、t = 3 秒、t = 6 秒のように 3 秒ごとにディセーブルになる Enabled Subsystem 内に配置すると、バッファーは内部貯蔵庫を空にすることなくデータを蓄積します。この条件では、結果としてオーバーランが発生します。

アンダーランは、バッファーに十分な出力データがない場合に発生します。たとえば、サイズ 3 のフレームへのスカラー入力のバッファリングが、1 秒ごとに入力を受け入れて 3 秒ごとに出力を行うバッファーを使用する場合を再度考えてみます。このバッファーを t = 10 秒、t = 11 秒、t = 13 秒、t = 14 秒、t = 16 秒および t = 17 秒でディセーブルになる Enabled Subsystem 内に配置すると、内部貯蔵庫は枯渇して t = 18 秒で出力するデータがなくなります。この条件では、結果としてアンダーランが発生します。

オーバーランやアンダーランの発生を防ぐため、Buffer ブロックは内部貯蔵庫のデータ量を記録します。Buffer ブロックがデータを読み取ると、貯蔵庫のデータ量は増加します。Buffer ブロックがデータを出力すると、貯蔵庫のデータ量は減少します。オーバーランを回避するため、貯蔵庫のデータ量が実際のバッファーサイズを上回るたびに貯蔵庫内の最も古いサンプルが破棄されます。アンダーランを回避するため、出力時に貯蔵庫にデータがない場合は直近のサンプルが繰り返されます。

拡張機能

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

Buffer ブロックは Simulink Real-Time™ のコード生成をサポートします。このターゲット用に生成されるコードは同時実行されます。このコードを生成するには、モデルのシステムターゲットファイルを [speedgoat.tlc] または Simulink Real-Time でサポートされているその他のターゲットファイルに設定します。また、Buffer ブロックは特定の条件を満たす必要があります。

システムターゲットファイルを設定するには、次のようにします。

Simulink モデルウィンドウで、[モデル化] タブの [モデル設定] をクリックします。
[モデル設定]、[コード生成] ペインで、[システムターゲットファイル] を [speedgoat.tlc] または Simulink Real-Time でサポートされているその他のターゲットファイルに設定します。

さらに、Buffer ブロックは、以下の条件を満たさなければなりません。

出力と入力のバッファーサイズの比は純粋な整数、つまり 1/N または N/1 である必要があります。3/12、1/7、7/1、2/4 などの比は、すべて有効な比です。Buffer ブロックでは、[出力バッファーサイズ (チャネルあたり)] パラメーターを使用して、適切な出力バッファーサイズを指定できます。
フレーム間でオーバーラップがあってはなりません。Buffer ブロックでは、[バッファーオーバーラップ] パラメーターを 0 に設定します。

Buffer

説明