マスクにおけるブロックパラメーターのプロモート

スクリプトを開く

ブロックおよびサブシステムは関連付けられた複数のパラメーターをもつことができます。ブロックのマスクは、これらのパラメーターの 1 つ以上を公開し、その他のパラメーターが表示されないようにします。ブロックの基となる任意のパラメーターをブロックマスクまたはサブシステムマスクにプロモートできます。任意のサブシステムについて、すべての入れ子になったブロック、ブロックパラメーター、内部パラメーターが単一のビューに表示されます。任意のノードをクリックして、入れ子になったブロック内のプロモート可能な任意のパラメーターにアクセスできます。パラメーターをブロックダイアログボックスからマスクにプロモートすることで、次のことが可能です。

必要なパラメーターをブロックダイアログボックスからマスクダイアログボックスに移動させることによってマスクダイアログボックスをカスタマイズする。

モデルの別のインスタンスでライブラリブロックを再利用する。ライブラリブロックのインスタンスごとに、それぞれのブロックのパラメーターをプロモートすることによって、個別のマスクダイアログボックスを作成できます。

インターフェイスを簡略化し、ブロックのユーザーが表示や設定を行うことができるパラメーターを指定する。

パラメーターのプロモートには次のオプションを使用できます。

1 対 1 でプロモート: このオプションは、マスクエディターでブロックパラメーターとマスクパラメーターを 1 対 1 で対応させる場合に使用します。各ブロックパラメーターに対して 1 つのマスクパラメーターが作成されます。たとえば、"ゲイン" や "乗算" などのパラメーターがある "Gain" ブロックのブロックダイアログボックスについて考えてみます。"ゲイン" パラメーターのみを公開するには、"Gain" ブロックをマスクし、"ゲイン" パラメーターをマスクダイアログボックスにプロモートします。

多対 1 でプロモート: このオプションは、ブロックパラメーターとマスクパラメーターの多対 1 の対応関係を作成する場合に使用します。1 つのマスクパラメーターを複数のプロモートされたパラメーターと関連付けることができます。たとえば、サブシステム内の複数の "ゲイン" パラメーターをマスクの 1 つのパラメーターにプロモートできます。

メモ:

パラメーターのデータ型が popup または DataType の場合、プロモートするパラメーターはオプションも同じでなければなりません。

プロモートされたすべてのパラメーターで Evaluate 属性が同じでなければなりません。

プロモートされたパラメーターの属性を変更することもできます。たとえば、プロモートされたパラメーターを読み取り専用にしたり非表示にしたりできます。属性の詳細については、プロパティエディターを参照してください。

モデルの確認

モデルには 2 つのサブシステムブロックが含まれています。Selective Promotion of Parameters はパラメーターを 1 対 1 でプロモートし、Promote Many to One はパラメーターを多対 1 でプロモートします。

 open_system('slexMaskParameterPromotionExample.slx');

1 対 1 でプロモート

基となる各ブロックパラメーターについて、マスクパラメーターとの 1 対 1 の対応関係を作成できます。

サブシステム Selective Promotion of Parameters を含むモデルについて考えます。このサブシステムには 3 つの "Gain" ブロックが含まれています。そのうちの 1 つの "Gain" ブロックの値は固定です。ユーザーインターフェイスを簡略化するために、可変の "Gain" ブロックのパラメーターはマスクにプロモートされています。

パラメーターをプロモートするには、次の手順に従います。

1. [マスクエディター]、[パラメーターとダイアログ]、[パラメーター]、[1 対 1 でプロモート] に移動します。

2. 可変の "ゲイン" パラメーター Gain と Gain1 を選択し、[プロモート] をクリックします。

メモ: プロモートされたパラメーターのプロンプトは変更できます。

3. マスクを保存し、モデルをシミュレートします。Gain1 ブロックの値がマスクパラメーター gain1_promoted から取得されることに注目してください。

4. モデルをシミュレートします。Gain3 ブロックの値は固定で、initialization で設定されていることに注目してください。可変の "ゲイン" パラメーターはマスクダイアログボックスに表示されます。

多対 1 でプロモート

複数のブロックパラメーターを 1 つのマスクパラメーターにプロモートするには、マスクエディターで [多対 1 でプロモート] オプションを使用します。たとえば、このモデルの Promote Many to One というサブシステムには 3 つの "Gain" ブロック ("Gain1"、"Gain2"、"Gain3") が含まれています。変数 K はこれらの "Gain" ブロックの "ゲイン" パラメーターを表します。これらの各 "Gain" ブロックの "ゲイン" パラメーターのみをブロックマスクに単一のパラメーターとしてプロモートできます。これを行うと、編集用のマスクでパラメーター K が使用可能になり、その値が "Gain1" ブロック、"Gain2" ブロック、および "Gain3" ブロックに適用されます。