Slider

スライディングスケールを使用してパラメーター値を調整する

ライブラリ:
Simulink / Dashboard

説明

Slider ブロックは、シミュレーション中に、接続されているブロックパラメーターの値を調整します。たとえば、Slider ブロックをモデルの Gain ブロックに接続し、その値をシミュレーション中に調整することができます。Slider ブロックのスケールの範囲は、データに合わせて変更することができます。Slider ブロックを他の Dashboard ブロックと共に使用して、モデルを制御する対話型のダッシュボードを作成します。

Dashboard ブロックの接続

Dashboard ブロックはモデル要素への接続に端子を使用しません。Dashboard ブロックを接続するには、接続モードを使用します。接続されていないブロックで接続モードに切り替えるには、接続するブロックをポイントし、[接続] ボタンをクリックします。接続されているブロックで接続モードに切り替えるには、ブロックを選択すると表示される省略記号 (…) をポイントし、展開されるアクションメニューで [接続] ボタンをクリックします。

制御ブロックをモデル内のパラメーターに接続するか、制御ブロックの接続を変更するには、接続モードに切り替えます。接続するパラメーターが含まれているブロックを選択します。表示されるリストから、接続するパラメーターを選択します。次に、Dashboard ブロックをポイントし、[接続完了] ボタンをクリックします。

モデルのブロック線図を更新するまで、制御ブロックは値が変数であるパラメーターに接続できません。シミュレーションが実行されていないときに、値が変数であるパラメーターに接続するか、接続されているパラメーターの値である変数の値を変更するには、Ctrl+D を押してモデルのブロック線図を更新します。

スカラー値をもつパラメーター、あるいは行列または構造体の要素に接続できます。詳細については、Connect Dashboard Blocks to Simulink Modelを参照してください。

Dashboard ブロックは Stateflow^® チャートにも接続できます。詳細については、Dashboard ブロックと Stateflow との接続 (Stateflow)を参照してください。

次のアニメーションは、Slider ブロックをモデルに接続する方法を示しています。

An unconnected Slider block connects to the Gain parameter of a Gain block.

パラメーターのログ記録

Dashboard ブロックに接続されている調整可能なパラメーターはシミュレーションデータインスペクターに記録されます。シミュレーションデータインスペクターでは、記録された信号データと共にパラメーター値を表示できます。UI を使用して、または関数Simulink.sdi.exportRunを使用して、シミュレーションデータインスペクターからパラメーターデータをエクスポートすることで、MATLAB^® ワークスペース内のログに記録されたパラメーターデータにアクセスできます。シミュレーションデータインスペクターの UI を使用したデータのエクスポートの詳細については、Export Data From Simulation Data Inspector to Workspace or Fileを参照してください。パラメーターデータは Simulink.SimulationData.Parameter オブジェクトに格納され、エクスポートされた Simulink.SimulationData.Dataset の要素としてアクセスできます。

例

すべて展開する

Slider ブロックを使用したゲイン値の変更

ライブスクリプトを開く

Slider ブロックを使用して、シミュレーション前またはシミュレーション中に、接続されているブロックパラメーターの値を変更できます。たとえば、モデル sliderGain では、Slider ブロックが Gain ブロックの [ゲイン] パラメーターに接続されています。

モデルのシミュレーションを実行します。シミュレーション中にゲイン値を変更するには、Slider ブロックを使用します。

Animation of the sliderGain model during simulation

拡張例

アンチロックブレーキシステムの相対すべりの調整

Dashboard ブロックを使用してアンチロックブレーキシステムのモデルの相対すべりを調整する。

モデルを開く

制限

Dashboard Scope ブロックおよび Display ブロックを除き、Dashboard ブロックは実数のスカラー信号にのみ接続できます。
コメントアウトされたブロックには、[ブロックパラメーター] ダイアログボックスの [接続] テーブルを使用して Dashboard ブロックを接続することはできません。コメント化されたブロックに接続モードを使用して Dashboard ブロックを接続した場合、ブロックのコメントを解除するまでは Dashboard ブロックに接続された値が表示されません。
Dashboard ブロックは参照モデル内のモデル要素には接続できません。
モデルの階層構造をシミュレーションすると、参照モデル内の Dashboard ブロックで更新は実行されません。
Dashboard ブロックは、ラピッドアクセラレータシミュレーションをサポートしていません。

シミュレーション中に Dashboard ブロックを変数またはパラメーターに接続すると、その変数またはパラメーターのデータはシミュレーションデータインスペクターに記録されません。シミュレーションデータインスペクターに変数とパラメーターのデータを記録するには、シミュレーションを実行する前に Dashboard ブロックを変数またはパラメーターに接続します。
[既定のパラメーター動作] を [インライン] に設定してエクスターナルモードでモデルをシミュレーションするときに、Dashboard ブロックがパラメーターと変数の値を変更するように見える場合があります。ただし、その変更はシミュレーションに伝播されません。たとえば、Gain ブロックには Dashboard ブロックを使用して [ゲイン] パラメーターに加えられた変更が表示されますが、シミュレーションで使用された [ゲイン] 値は変更されません。

パラメーター

すべて展開する

接続 — 接続するブロックパラメーター値
パラメーター値の接続オプション

このブロックは、パラメーターの値を制御するブロックである、制御ブロックです。このブロックを、制御対象の値を持つパラメーターに接続します。スカラー値をもつパラメーター、または行列の要素に接続できます。

Dashboard ブロックはモデル要素への接続に端子を使用しません。Dashboard ブロックを接続するには、接続モード、Simulink^® ツールストリップ、または [ブロックパラメーター] ダイアログボックスの [接続] テーブルを使用します。詳細については、Connect Dashboard Blocks to Simulink Modelを参照してください。

[接続] テーブルを使用して、スカラー値をもつパラメーターを接続するには、次のようにします。

ブロックを選択します。
プロパティインスペクターの [パラメーター] タブで、[接続] または [変更] をクリックします。
接続するパラメーター値が含まれているブロックを選択します。
表示されるテーブルで、パラメーターを選択します。
[適用] をクリックします。

値が変数として指定されているパラメーターに接続するか、接続されている変数の値を変更するには、まず、モデルのブロック線図を更新する必要があります。モデルのブロック線図を更新するには、Ctrl+D を押します。

Dashboard ブロックは Stateflow チャートにも接続できます。詳細については、Dashboard ブロックと Stateflow との接続 (Stateflow)を参照してください。

プログラムでの使用

プログラムで制御ブロックをパラメーターに接続できます。パラメーターを表す Simulink.HMI.ParamSourceInfo オブジェクトを定義します。次に、Binding パラメーターの値をオブジェクトに設定します。Binding パラメーターの値を設定するには、set_param 関数を使用します。

たとえば、vdp という名前のモデルに、myButton という名前の Push Button ブロックと、x1 という名前の Integrator ブロックが含まれているとします。Push Button ブロックを Integrator ブロックの Initial Condition パラメーターに接続するには、次のコードを使用します。

blockPath1 = "vdp/myButton";
blockPath2 = "vdp/x1";

myObj = Simulink.HMI.ParamSourceInfo;
myObj.BlockPath = Simulink.BlockPath(blockPath2);
myObj.ParamName = 'InitialCondition';

set_param(blockPath1,Binding=myObj)

パラメーター:	`Binding`
値:	`Simulink.HMI.ParamSourceInfo` object

例: set_param(gcb,Binding=myObj)

スケールタイプ — スケールのタイプ
`Linear` (既定値) | `Log`

ブロック上に表示されるスケールのタイプ。[線形] は線形スケール、[対数] は対数スケールを指定します。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、set_param 関数を使用します。

パラメーター:	`ScaleType`
値:	`'Linear'` (既定値) \| `"Linear"` \| `"Log"`

例: set_param(gcb,ScaleType="Log")

最小値 — 目盛りの最小値
`0` (既定値) | スカラー

スケールの目盛りの最小値を指定する有限で実数の double のスカラー値。最小値は [最大値] パラメーターの値よりも小さくなければなりません。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、set_param 関数を使用します。

Limits パラメーターの値を、[min,int,max] 形式のベクトルとして指定します。

min は目盛りの Minimum 値です。
int は目盛りの Tick Interval です。Tick Interval に auto 値を使用するには、ベクトルの Tick Interval の位置を空白のままにしておくか、-1 を指定します。
max は目盛りの Maximum 値です。

パラメーター:	`Limits`
値:	`[0 -1 100]` (既定値) \| `[min,int,max]`

例: set_param(gcb,Limits=[-50 -1 100])

最大値 — 目盛りの最大値
`100` (既定値) | スカラー

スケールの目盛りの最大値を指定する有限で実数の double のスカラー値。最大値は、[最小値] パラメーターの値よりも大きくなければなりません。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、set_param 関数を使用します。

Limits パラメーターの値を、[min,int,max] 形式のベクトルとして指定します。

min は目盛りの Minimum 値です。
int は目盛りの Tick Interval です。Tick Interval に auto 値を使用するには、ベクトルの Tick Interval の位置を空白のままにしておくか、-1 を指定します。
max は目盛りの Maximum 値です。

パラメーター:	`Limits`
値:	`[0 -1 100]` (既定値) \| `[min,int,max]`

例: set_param(gcb,Limits=[0 -1 50])

目盛りの間隔 — 大目盛り間の間隔
`auto` (既定値) | スカラー

スケールの大目盛りの間隔を指定する有限で実数、正の、0 または正の整数のスカラー値。auto に設定されている場合、ブロックは目盛りの間隔を [最大値] パラメーターおよび [最小値] パラメーターの値に基づいて自動的に調整します。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、set_param 関数を使用します。

Limits パラメーターの値を、[min,int,max] 形式のベクトルとして指定します。

min は目盛りの Minimum 値です。
int は目盛りの Tick Interval です。Tick Interval に auto 値を使用するには、ベクトルの Tick Interval の位置を空白のままにしておくか、-1 を指定します。
max は目盛りの Maximum 値です。

パラメーター:	`Limits`
値:	`[0 -1 100]` (既定値) \| `[min,int,max]`

例: set_param(gcb,Limits=[0 5 100])

ラベル — ブロックラベルの位置
`Top` (既定値) | `Bottom` | `Hide`

ブロックラベルの位置。ブロックがモデル内の要素に接続されている場合、ラベルは接続された要素の名前です。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、関数 set_param を使用します。

パラメーター:	`LabelPosition`
値:	`'Top'` (既定値) \| `"Top"` \| `"Bottom"` \| `"Hide"`

例: set_param(gcb,LabelPosition="Bottom")

ブロックの特性

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

拡張機能

すべて展開する

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

Dashboard ブロックはコード生成時に無視されます。

バージョン履歴

R2015b で導入

すべて展開する

R2026a: Dashboard ブロックを接続するための [ブロックパラメーター] ダイアログボックステーブルは削除予定

今後のリリースでは、[ブロックパラメーター] ダイアログボックスのテーブルを使用した Dashboard ライブラリや Customizable Blocks ライブラリのブロックの接続はサポートされなくなります。代わりに接続モードを使用してください。接続モードの詳細については、Connect Dashboard Blocks to Simulink Modelを参照してください。

R2023b: 新しいウィンドウでパネルを開く

R2023b 以降では、新しいウィンドウでダッシュボードパネルを開くことができます。そうするには、パネルを選択し、表示された省略記号の上にマウスをポイントします。展開されたアクションメニューで、[新規ウィンドウで開く] ボタンをクリックします。

モデルウィンドウとは別個に、パネルを含む新しいウィンドウを最小化および復元できます。パネルウィンドウで、シミュレーションの実行、一時停止、停止、およびステップ実行を行うことができます。パネルウィンドウで、パネルおよびパネルに含まれているブロックを編集できます。

パネルをモデルキャンバスに戻すには、パネルウィンドウツールストリップで [キャンバスで開く] をクリックします。

新しいウィンドウでパネルを開く操作の詳細については、Open Panels in New Windowを参照してください。

R2023a: [パネル] タブを Simulink ツールストリップに固定

モデルにダッシュボードパネルを追加すると、Simulink ツールストリップに [パネル] タブが表示され、パネルの管理や編集のためのオプションが表示されます。

以前は、パネルが選択されているときしか [パネル] タブが表示されませんでした。R2023a 以降では、パネルが選択されていないときも [パネル] タブが表示されたままになります。

また、[パネル] タブに次の新しいオプションが追加されています。

空のパネルを追加できます。
選択したパネルの名前を変更できます。
選択したパネルを非表示にできます。

R2022b: パネル内のカスタマイズ可能な Dashboard ブロックに対する元に戻す/やり直しのサポート

R2022b 以降では、パネル内にあるカスタマイズ可能な Dashboard ブロックに対する変更を元に戻したりやり直したりできます。

変更を元に戻すかやり直すには、次のようにします。

パネルまたはパネル内のブロックをクリックします。
変更を元に戻すには Ctrl+Z を押し、変更をやり直すには Ctrl+Y を押します。

メモ

キーボードショートカットは Windows^® に基づいています。Mac では、Ctrl ではなく command (⌘) を押します。

R2022b: ツールストリップにおけるパネルのサポート

R2022b 以降では、パネルやそれに含まれる Dashboard ブロックを Simulink ツールストリップを使用して管理および編集できます。

パネル内の Dashboard ブロックをクリックすると、ブロックのツールストリップタブが表示されます。たとえば、Circular Gauge ブロックをクリックすると、[ゲージ] タブがツールストリップに表示されます。

パネルをクリックすると、[パネル] タブがツールストリップに表示されます。タブには次のオプションがあります。

モデルのパネルの可視性を管理する。
非表示でないすべてのパネルを現在のビュー内に収める。
選択したパネルを折りたたむ。
パネルのサイズや内容をカスタマイズする。
選択したパネルにカスタムの背景イメージを設定する。
選択したパネルに新しいタブを追加する。

R2021a: Dashboard ブロックを使用した行列および構造体の要素の調整

R2021a 以降では、調整可能なブロックパラメーターの値を定義する行列または構造体のスカラー要素に Dashboard ライブラリのブロックを接続できます。Dashboard ブロックを調整可能なパラメーターに接続するときは、最初に 1 つ以上のブロックを選択します。次に、接続するパラメーターをダイアログボックスで選択します。非スカラー値をもつパラメーターを選択する場合は、調整する要素をダイアログボックスでテキストボックスを使用して指定します。

R2020b: Simulink ツールストリップにおける Dashboard ブロックのサポート

R2020b 以降では、モデルで Simulink ライブラリの Dashboard ライブラリのブロックや Aerospace Blockset™ Flight Control Analysis ライブラリの Flight Instruments ライブラリのブロックを選択したときに、Simulink ツールストリップの [ブロック] タブがブロック固有のタブに変わります。ツールストリップから、選択したブロックを接続または切断したり、接続を変更したりできます。選択したブロックに接続されたモデル要素にジャンプしたり、選択したブロックをパネルに追加したりできます。

R2019a: Dashboard ブロックのプログラムによる追加と構成

R2019a 以降では、add_block や set_param などの関数を使用して Dashboard ライブラリのブロックをモデルで作成および構成できます。

参考

Knob | Rotary Switch

Slider

説明

Dashboard ブロックの接続

パラメーターのログ記録

例

Slider ブロックを使用したゲイン値の変更

拡張例

アンチロック ブレーキ システムの相対すべりの調整

制限

パラメーター

接続 — 接続するブロック パラメーター値 パラメーター値の接続オプション

プログラムでの使用

スケール タイプ — スケールのタイプ Linear (既定値) | Log

プログラムでの使用

最小値 — 目盛りの最小値 0 (既定値) | スカラー

プログラムでの使用

最大値 — 目盛りの最大値 100 (既定値) | スカラー

プログラムでの使用

目盛りの間隔 — 大目盛り間の間隔 auto (既定値) | スカラー

プログラムでの使用

ラベル — ブロック ラベルの位置 Top (既定値) | Bottom | Hide

プログラムでの使用

ブロックの特性

拡張機能

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

バージョン履歴

R2026a: Dashboard ブロックを接続するための [ブロック パラメーター] ダイアログ ボックス テーブルは削除予定

R2023b: 新しいウィンドウでパネルを開く

R2023a: [パネル] タブを Simulink ツールストリップに固定

R2022b: パネル内のカスタマイズ可能な Dashboard ブロックに対する元に戻す/やり直しのサポート

R2022b: ツールストリップにおけるパネルのサポート

R2021a: Dashboard ブロックを使用した行列および構造体の要素の調整

R2020b: Simulink ツールストリップにおける Dashboard ブロックのサポート

R2019a: Dashboard ブロックのプログラムによる追加と構成

参考

トピック

アンチロックブレーキシステムの相対すべりの調整

接続 — 接続するブロックパラメーター値
パラメーター値の接続オプション

スケールタイプ — スケールのタイプ
`Linear` (既定値) | `Log`

最小値 — 目盛りの最小値
`0` (既定値) | スカラー

最大値 — 目盛りの最大値
`100` (既定値) | スカラー

目盛りの間隔 — 大目盛り間の間隔
`auto` (既定値) | スカラー

ラベル — ブロックラベルの位置
`Top` (既定値) | `Bottom` | `Hide`

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

R2026a: Dashboard ブロックを接続するための [ブロックパラメーター] ダイアログボックステーブルは削除予定