For Each

For Each Subsystem の制御ブロック

• 

×

説明

For Each ブロックは、For Each Subsystem ブロックの制御ブロックとして機能します。具体的には、For Each ブロックを使用することで、入力信号またはマスク パラメーターのいずれかの要素を For Each Subsystem 内のブロックで個別に処理できるようになります。状態をもつこのサブシステム内の各ブロックは、処理対象の各要素またはサブ配列ごとに独立した状態セットを維持します。サブシステム内のブロック セットが要素またはサブ配列を処理するとき、サブシステムは結果を連結して出力信号を形成します。

For Each Subsystem を使用して、入力やマスク パラメーターを変更した後に出力を反復計算します。これを行うには、For Each ブロックのダイアログ ボックスで入力信号またはマスク パラメーターの分割を設定します。

入力信号のサブシステムへの分割

各反復に分割する入力信号を For Each Subsystem で指定するには、For Each ブロックのダイアログ ボックスの [入力分割] タブを使用します。分割する信号を指定するときは、[分割次元] パラメーター、[分割幅] パラメーター、[分割オフセット] パラメーターを指定します。

サブシステムのマスク パラメーターの分割

For Each Subsystem ブロックのマスク パラメーターは分割できます。分割は、システムの構造は変えずにパラメーターの値を変えて反復処理する場合に便利です。この場合、パラメーターごとにモデルを変更して追加の入力信号を分割する方法では煩雑になります。代わりに、For Each Subsystem にマスク パラメーターを追加します。詳細については、簡単なマスクの作成を参照してください。分割するマスク パラメーターを選択するには、For Each ブロックのダイアログ ボックスの [パラメーターの分割] タブを使用します。詳細については、以下の分割パラメーターの選択を参照してください。

出力の連結

結果を連結する次元を定義するには、[出力連結] タブで [連結の次元] を指定します。

サブ配列ごとにブロックによって生成された結果は、連結次元に沿って積み上げられます。既定では、次元 1 (y 軸) が使用され、結果が垂直に積み上げられることを意味します。ただし、連結の次元を 2 に指定すると、結果は水平方向 (x 軸) に連結されます。したがって、行ベクトルが処理されると、連結された結果は、最初のケースは行列になり、2 番目のケースは行ベクトルになります。

分割パラメーターの選択

分割する入力信号またはサブシステムのマスク パラメーターを選択するときは、それらを各反復用に要素またはサブ配列に分解する方法を指定しなければなりません。これを行うには、[分割次元] パラメーターと [分割幅]、[分割オフセット] パラメーターで整数値を設定します。

例として、次の形式の入力信号行列 A について考えてみます。

ラベル d₁ と d₂ は、それぞれ次元 1 と次元 2 を定義します。分割次元と分割幅の両方に対して既定の設定 1、分割オフセットに 0 が保持されると、Simulink^® は分割幅に等しい幅つまり 1 要素分の幅で分割次元 1 に対して直角にスライスします。

行列 A は、次の 3 つの行ベクトルに分解されます。

代わりに分割次元 2 を指定すると、Simulink は次元 2 に対して直角にスライスして、次の 3 つの列ベクトルを形成します。

[分割次元] を 2 に設定する以外に、[分割幅] を 2 および [分割オフセット] を -1 に設定すると、Simulink は 2 つのオーバーラップする 3 行 2 列の分割を処理に使用します。

既定では、入力信号またはマスク パラメーターのすべての分割が処理されます。分割のサブセットを処理するには、処理する分割数を [反復回数] として入力します。上記の行列の例では、[分割オフセット] を 0 (既定の設定) に、[反復回数] を 2 に設定すると、入力行列 A の最初の 2 行または 2 列のみが処理されます。

メモ

Simulink で 1 次元と見なされるのは信号だけです。マスク パラメーターは、方向に応じて行ベクトルか列ベクトルのどちらかになります。行ベクトルを分割するには、分割次元を 2 (列方向) に指定します。列ベクトルを分割するには、分割次元を 1 (行方向) に指定します。

例

For Each ブロックによる入力信号の分割

次のモデルは、For Each ブロックによる入力信号の分割を示すものです。

スクリプトを開く

For Each ブロックでの連結の次元の指定

この例では、For Each ブロックで連結の次元を指定する方法を示します。

スクリプトを開く

For Each Subsystem による 2 次元信号のタイル処理

この例では、For Each Subsystem を使用する方法を説明します。この例では、行列で演算を行います。

モデルを開く

For Each Subsystem によるスカラー アルゴリズムのベクトル化

この例では、For Each Subsystem を使用する方法を説明します。この例では、簡単にするために、ベクトルで演算を行います。

モデルを開く

For Each Subsystem を使用した同等のダイナミクスをもつオブジェクトのモデル化

この例では、同等のダイナミクスをもつ複数のオブジェクトを For Each Subsystem を使用してモデル化する方法を示します。オブジェクトの数は、入力信号の長さでパラメーター化されます。

モデルを開く

端子

出力

Partition index — 現在の分割のインデックス

スカラー

現在の分割のインデックス (ゼロから始まる)。スカラーとして返されます。

依存関係

この端子を有効にするには、[分割インデックスの出力端子を表示] を選択します。

データ型: int32 | double

パラメーター

[入力分割] タブ

分割する各入力信号を選択し、対応する [分割次元] パラメーター、[分割幅] パラメーター、および [分割オフセット] パラメーターを指定します。詳細は、Inport ブロックのリファレンス ページを参照してください。

端子 — 入力端子のリスト

既定値なし (既定値) | 入力端子名

この パラメーター は読み取り専用です。

For Each Subsystem ブロックに接続された入力端子のリスト。

分割 — 分割する入力端子信号を選択

オフ (既定値) | オン

サブ配列または要素に分割する For Each Subsystem ブロックに接続された入力端子信号を選択します。[端子] 列にリストされている端子ごとに、対応するチェック ボックスをオンにしてその信号を分割します。

プログラムでの使用

ブロック パラメーター: InputPartition

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

分割次元 — 次元の指定

1 (既定値) | 2 | 正の整数

選択した入力信号配列をスライスする次元を指定します。結果として得られるスライスは、指定する次元と直交します。スライスによって配列がサブ配列または要素に適切に分割されます。

1

入力配列を列に沿ってスライスします。

2

入力配列を行に沿ってスライスします。

n

入力配列を次元 n に沿ってスライスします。

依存関係

このパラメーターを有効にするには、関連する入力端子の [分割] を選択します。

プログラムでの使用

ブロック パラメーター: InputPartitionDimension

型: 文字ベクトル

値: '1' | '2' | '<positive integer>'

既定の設定: '1'

分割幅 — 幅の指定

1 (既定値) | 正の整数

選択した入力信号の各分割スライスの幅を指定します。

依存関係

このパラメーターを有効にするには、関連する入力端子の [分割] を選択します。

プログラムでの使用

ブロック パラメーター: InputPartitionWidth

型: 文字ベクトル

値: '1' | '<integer>'

既定の設定: '1'

分割オフセット — 分割オフセットの指定

0 (既定値) | 整数

選択した入力信号の各分割スライスのオフセットを指定します。

0

分割スライス間のオフセットはありません。つまり、分割スライス間にギャップはなく、オーバーラップもしていません。

整数

正の整数を使用してスライス間のギャップを指定するか、負の整数を使用してオーバーラップを示すことで、分割オフセットを指定します。[分割幅] と [分割オフセット] の合計は正の整数でなければなりません。

たとえば、[分割幅] が 3 で、[分割オフセット] が -2 であると、3 要素のスライスがそれぞれ隣接するスライスと 2 要素分オーバーラップすることを示します。また、[分割幅] が 2 で、[分割オフセット] が 1 であると、1 要素の幅のギャップが隣接する 2 要素の幅のスライスのそれぞれのペアの間にあることを示します。

依存関係

このパラメーターを有効にするには、関連する入力端子の [分割] を選択します。

プログラムでの使用

ブロック パラメーター: InputPartitionOffset

型: 文字ベクトル

値: '0' | '<integer>'

既定の設定: '0'

[パラメーターの分割] タブ

分割する各マスク パラメーターを選択し、対応する [分割次元] パラメーターと [分割幅] パラメーターを指定します。

パラメーター — マスク パラメーターのリスト

パラメーター名

この パラメーター は読み取り専用です。

For Each Subsystem ブロックのマスク パラメーターのリスト。このリストには、For Each Subsystem ブロックのマスクに編集可能なパラメーターを追加している場合にのみマスク パラメーターが表示されます。Author Block Masksを参照してください。

分割 — 分割するマスク パラメーターを選択

オフ (既定値) | オン

サブ配列または要素に分割する For Each Subsystem ブロックのマスク パラメーターを選択します。[パラメーター] 列にリストされている端子ごとに、対応するチェック ボックスをオンにしてそのマスク パラメーターを分割します。

プログラムでの使用

ブロック パラメーター: SubsysMaskParameterPartition

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

分割次元 — 次元の指定

1 (既定値) | 2 | 正の整数

選択したマスク パラメーター配列をスライスする次元を指定します。結果として得られるスライスは、指定する次元と直交します。スライスによって配列がサブ配列または要素に適切に分割されます。

1

マスク パラメーター配列を列に沿ってスライスします。

2

マスク パラメーター配列を行に沿ってスライスします。

n

マスク パラメーター配列を次元 n に沿ってスライスします。

依存関係

このパラメーターを有効にするには、関連するマスク パラメーターの [分割] を選択します。

プログラムでの使用

ブロック パラメーター: SubsysMaskParameterPartitionDimension

型: 文字ベクトル

値: '1' | '<integer>'

既定の設定: '1'

分割幅 — 分割幅の指定

1 (既定値) | 正の整数

選択したマスク パラメーター配列の各分割スライスの幅を指定します。

依存関係

このパラメーターを有効にするには、関連するマスク パラメーターの [分割] を選択します。

プログラムでの使用

ブロック パラメーター: SubsysMaskParameterPartitionWidth

型: 文字ベクトル

値: '1' | '<positive integer>'

既定の設定: '1'

[出力連結] タブ

各出力端子に対して、For Each Subsystem ブロックの結果を積み上げる (連結する) 次元を指定します。詳細は、Outport ブロックのリファレンス ページを参照してください。

端子 — 出力端子のリスト

なし (既定値) | 出力端子名

この パラメーター は読み取り専用です。

For Each Subsystem ブロックに接続された出力端子のリスト。

連結の次元 — 次元の指定

1 (既定値) | 2 | positive integer

各出力端子に対して、For Each Subsystem ブロックの結果を積み上げる次元を指定します。

1

結果を d₁ 方向、つまり垂直に積み上げます。ブロックが列ベクトルを生成すると、連結処理によって 1 つの列ベクトルが生成されます。ブロックが行ベクトルを生成すると、連結処理によって 1 つの行列が生成されます。

2

結果を d₂ 方向、つまり水平に積み上げます。ブロックが行ベクトルを生成すると、連結処理によって 1 つの行ベクトルが生成されます。ブロックが行ベクトルを生成すると、連結処理によって 1 つの行列が生成されます。

n

結果を d_n 方向に積み上げます。

プログラムでの使用

ブロック パラメーター: OutputConcatenationDimension

型: 文字ベクトル

値: '1' | '<integer>'

既定の設定: '1'

その他のパラメーター

分割インデックスの出力端子を表示 (0 ベースのインデックス) — 出力端子の表示の制御

オフ (既定値) | オン

分割インデックスの出力端子の表示を制御します。

オフ

出力端子を非表示にします。

オン

ブロックの出力端子を表示します。

プログラムでの使用

ブロック パラメーター: ShowIterationIndex

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

分割インデックスの出力データ型 — 分割インデックスのデータ型の指定

'int32' (既定値) | 'double'

出力端子の分割インデックスのデータ型を指定します。

int32

符号付き 32 ビット整数を選択します。

double

double の実数を選択します。

依存関係

このパラメーターを有効にするには、[分割インデックスの出力端子を表示] を選択します。

プログラムでの使用

ブロック パラメーター: IterationIndexDataType

型: 文字ベクトル

値: 'int32' | 'double'

既定の設定: 'int32'

反復回数 — 処理する分割数を指定

-1 (既定値) | 整数

データのサブセットを処理するには、処理する入力信号またはマスク パラメーター配列の分割スライスの数を指定するか、-1 を指定してすべてのスライスを処理します。この数字は、使用可能なスライスの合計数を超えてはなりません。

-1

すべてのスライスを処理する

整数

処理するスライス数

たとえば、[反復回数] が 3 である場合、最初の 3 スライスのみが処理されることを示します。

プログラムでの使用

ブロック パラメーター: SpecifiedNumIters

型: 文字ベクトル

値: '-1' | '<integer>'

既定の設定: '-1'

拡張機能

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

HDL Coder™ には、HDL の実装および合成されたロジックに影響する追加のコンフィギュレーション オプションがあります。

HDL アーキテクチャ

このブロックには 1 つの既定の HDL アーキテクチャがあります。

バージョン履歴

R2010a で導入

参考

For Each Subsystem | Subsystem

トピック

• For Each Subsystem を使用したアルゴリズムの繰り返し
• For Each Subsystem における信号のログ記録