簡単なマスクの作成

ブロックをマスクするには、マスクエディターを使用して対話的に実行する方法とプログラムで実行する方法があります。この例では、[マスクエディター] を使用してブロックをマスクする方法を示します。プログラムでブロックをマスクする方法については、プログラムによるマスクの制御を参照してください。

マスクの例については、Simulink のマスクの例を参照してください。

手順 1: マスクエディターを開く

ブロックをマスクするモデルを開きます。たとえば、subsystem_exampleを開きます。
このモデルには、次の直線の方程式をモデル化する Subsystem ブロックが含まれています。 y = mx + b.
Subsystem ブロックを選択し、[サブシステム] タブの [マスク] グループで、[マスクの作成] をクリックします。

手順 2: マスクの定義

マスクエディターの 4 つのタブで、ブロックマスクを定義し、マスクのダイアログボックスをカスタマイズできます。

各ペインの詳細については、マスクエディターの概要を参照してください。

[パラメーターとダイアログ] タブ

このタブでは、パラメーター、表示、アクション項目などを制御するコントロールをマスクダイアログボックスに追加します。

ブロックマスクに [エディット] ボックスを追加するには次を行います。

左側のペインで、[パラメーター] の下にある [エディット] を 2 回クリックして、[ダイアログボックス] ペインに 2 つの新しい行を追加します。
この 2 つの [エディット] パラメーターの [プロンプト] 列に、Slope、Intercept と入力します。[プロンプト] 列に入力した値は、マスクダイアログボックスに表示されます。同様に、[名前] 列に m、b と入力します。[名前] 列に入力した値は、マスクパラメーターの名前になります。マスクパラメーターの名前は、有効な MATLAB^® 名でなければなりません。
右側のペインで、[プロパティエディター] の [プロパティ]、[ダイアログ]、[レイアウト] の各セクションに値を指定します。
[適用] をクリックします。
マスクエディターを終了せずにマスクダイアログボックスをプレビューするには、[プレビュー] をクリックします。

詳細については、[パラメーターとダイアログ] ペインを参照してください。

メモ

Simulink^® マスクパラメーターは同じマスクの別のパラメーターを参照できません。

[コード] ペイン

このペインでは、マスクパラメーターを制御する MATLAB コードを指定します。たとえば、マスクパラメーターの事前定義された値を指定できます。

例にある方程式 y = mx + b について考えます。'm' に対応する子ブロックの値を設定するには、[コード] ペインで関数 set_param を使用します。

メモ

詳細については、[コード] ペインを参照してください。

[アイコン] ペイン

このタブでは、ブロックマスクのアイコンを作成します。マスクエディターには 2 つのブロックアイコン作成モードが用意されています。

グラフィカル
マスク描画コマンド

グラフィカルアイコンエディター: ブロックのマスクアイコンをグラフィカル環境で作成および編集できます。グラフィカルアイコンエディターには、アイコンの作成を簡単にするさまざまな機能があります。グラフィカルアイコンエディターはマスクエディターから起動します。

対話型のグラフィカル環境には、ペン、曲率、テキスト、ハサミ、コネクタ、方程式 (LaTeX をサポート) などのグラフィカルツールが用意されており、豊富なグラフィカルアイコンを作成できます。グリッド、スマートガイド、およびルーラーにより、ピクセルパーフェクトなアイコンを作成できます。描画ツールとは別に、抵抗器、インダクター、回転ダンパーなど、いくつかの組み込みの形状が用意されています。詳細については、Create and Edit Masked Block Icon Using Graphical Icon Editorを参照してください。

マスク描画コマンド: 一連のマスク描画コマンドを使用して、マスクブロックアイコンを作成します。左側の [プロパティ] ペインで、アイコンのプロパティや表示設定を指定できます。詳細については、アイコンを描画するコマンドを参照してください。

動的または静的なブロックマスクアイコンを作成できます。詳細については、マスクアイコンの描画と slexMaskDisplayAndInitializationExample を参照してください。

[制約] ペイン

マスクパラメーターの制約ではマスクパラメーターに対する検証を作成することができ、独自の検証コードを記述する必要はありません。3 種類の制約、つまりパラメーター制約、クロスパラメーター制約、端子制約があります。

パラメーター制約: マスクには、ユーザー入力値を受け入れるパラメーターを含めることができます。マスクダイアログボックスを使用して、マスクパラメーターの入力値を指定できます。制約を使用して、マスクパラメーターの入力値を、必ず指定された範囲内に収めることができます。たとえば、Gain ブロックのマスクについて考えます。入力値が 1 ～ 10 の範囲内でなければならないという制約を設定できます。指定された範囲外の入力を提供すると、エラーが表示されます。左ペインの制約ブラウザーは、共有の制約を管理するのに役立ちます。

クロスパラメーター制約: クロスパラメーター制約は [エディット] または [コンボボックス] タイプの 2 つ以上のマスクパラメーター間に適用されます。Parameter1 が Parameter2 よりも大きくなければならないといったシナリオを指定する場合に、クロスパラメーター制約を使用できます。

端子制約: マスクされたブロックの入力端子と出力端子に対する制約を指定できます。モデルをコンパイルするときに、端子の属性が制約に対してチェックされます。

手順 3: マスクの操作

マスクをプレビューし、ブロックのマスクを解除したり、ブロックマスクを編集したりできます。
マスクされたブロックをダブルクリックします。
マスクダイアログボックスが表示されます。
マスクダイアログボックスの [Slope] と [Intercept] のボックスに値を入力します。出力を表示するには、モデルをシミュレートします。
[OK] をクリックします。
マスクの定義を編集するために、Subsystem ブロックを選択して、ツールストリップの [サブシステム] タブで [マスクの編集] をクリックします。詳細については、既存のマスクの管理を参照してください。
マスクブロックを選択し、[Subsystem ブロック] タブの [マスク] グループで [マスク内を表示] をクリックすると、次が表示されます。
- マスクサブシステム内のブロック
- マスクブロックの組み込みブロックダイアログボックス
- リンク付きのマスクブロックのベースマスクダイアログボックス