Display

シミュレーション中の信号値の表示

• 

ライブラリ:
Simulink / Dashboard

説明

Display ブロックはモデル内で信号に接続し、シミュレーション中にその値を表示します。直観的な値が表示されるように Display ブロックの外観と形式を設定できます。シミュレーション中に Display ブロックのパラメーターを編集できます。Display ブロックは、複素信号、ベクトル信号、および 2 次元行列の信号を表示できます。Display ブロックをその他の Dashboard ブロックと共に使用し、コントロールおよびインジケーターからなる、モデルの対話型のダッシュボードを作成します。

Dashboard ブロックの接続

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

Display ブロックをモデル内の信号に接続したり Display ブロックの接続を変更したりするには、接続モードに切り替えます。接続する信号線を選択します。表示されるリストから、接続する信号を選択します。次に、Dashboard ブロックをポイントし、[接続完了] ボタン をクリックします。接続されたブロックの値を Dashboard ブロックに表示するには、シミュレーションを実行します。

Dashboard ブロックの接続の詳細については、Connect Dashboard Blocks to Simulink Modelを参照してください。

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

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

例

信号値の表示

Display ブロックを使用して、シミュレーション中に信号の値を表示できます。たとえば、displayRamp モデルをシミュレートして rampSig 信号の値を表示します。

シミュレーション中に、Display ブロックは Ramp ブロックから出力される値を表示します。これは 0 から始まり、10 まで徐々に増加します。

表示形式のカスタマイズ

Display ブロックの形式をカスタマイズして、数値出力と共にテキストを含めることができます。たとえば、モデル CustomDisplayText では、Display ブロックが Sine Wave 信号に接続されています。Display ブロックはカスタム文字列形式を使用するように構成されています。

シミュレーション中、Display ブロックは Sine Wave 信号の値に加えてテキストを表示します。

拡張例

自動車の室温調節システムの対話型シミュレーション

コントロールとインジケーターを備えたダッシュボードを使用して自動車の室温調節システムのシミュレーションを操作する。

• モデルを開く

家の熱モデルの対話型シミュレーション

Dashboard ブロックを使用して家の熱モデルを構成し、対話型シミュレーションを行う。

• ライブ スクリプトを開く

制限

• コメントアウトされたブロックには、[接続] テーブルを使用して Dashboard ブロックを接続できません。コメント化されたブロックに接続モードを使用して Dashboard ブロックを接続した場合、ブロックのコメントを解除するまでは Dashboard ブロックに接続された値が表示されません。

• ツールストリップは、パネル内にある Dashboard ブロックをサポートしていません。

• Dashboard ブロックは参照モデル内の信号には接続できません。

• モデルの階層構造をシミュレーションすると、参照モデル内の Dashboard ブロックで更新は実行されません。

• Dashboard ブロックは、ラピッド アクセラレータ シミュレーションをサポートしていません。

• シミュレーション中に Stateflow のチャート データやステート アクティビティに Dashboard ブロックを接続することはできません。

• プログラムで Stateflow のチャート データやステート アクティビティに Dashboard ブロックを接続することはできません。

• アクセラレータ モード シミュレーションのためのブロックの削減または最適化により、一部の信号にはシミュレーションで使用できるデータが含まれないことがあります。Dashboard ブロックを使用してこのような信号を表示するには、信号をログ記録用にマークします。

パラメーター

接続

接続 — 接続して表示する信号

信号の接続オプション

このブロックは、信号の値を表示するブロックである、Display ブロックです。表示する信号にブロックを接続します。

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

[接続] テーブルを使用して信号に接続する手順は以下のとおりです。

1. ブロックを選択します。

2. プロパティ インスペクターの [パラメーター] タブで、[接続] または [変更] をクリックします。

3. 接続先となる信号の信号線を選択します。

4. 表示されたテーブルで、信号を選択します。

5. [適用] をクリックします。

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

プログラムでの使用

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

たとえば、vdp という名前のモデルに、myGauge という名前の Circular Gauge ブロックと x1 という名前の信号が含まれているとします。ブロックを信号に接続するには、次のコードを使用します。

blockPath = "vdp/myGauge";
signalPath = "vdp/x1";

myObj = Simulink.HMI.SignalSpecification;
myObj.BlockPath = Simulink.BlockPath(signalPath);

set_param(blockPath,Binding=myObj)

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

例: set_param(gcb,Binding=myObj)

メイン

形式 — 信号の値を表示する形式

short (既定値) | long | shortE | longE | ...

信号の値を表示する形式を指定します。

選択した形式	ブロックの表示
short	小数点以下 4 桁のスケーリングされた固定小数点形式。
long	double 値の場合は小数点以下 15 桁、single 値の場合は小数点以下 7 桁のスケーリングされた固定小数点形式。
shortE	4 桁の科学表記形式。
longE	double 値の場合は小数点以下 15 桁、single 値の場合は小数点以下 7 桁の科学表記形式。
shortG	データは、固定小数点または科学表記の間でよりコンパクトな形式を取り、合計の桁数は 5 桁。
longG	データは、double 値の場合は合計 15 桁、single 値の場合は合計 7 桁の、固定小数点または科学表記の間でよりコンパクトな形式を取る。
shortEng	小数点以下 4 桁の工学表記 (指数が 3 の倍数)。
longEng	有効桁数 15 桁の工学表記 (指数が 3 の倍数)。
+-	正/負形式。正、負、およびゼロの値がそれぞれ +、-、および空白文字で表示される。
bank	小数点以下 2 桁の通貨形式。
hex	16 進数表現。
rat	比率。
Custom	カスタム文字列形式。データは、[書式文字列] パラメーターを使用して指定するカスタム文字列で表示されます。
Integer	最も近い 0 または正の整数へ丸められたデータ。

Display ブロックを信号出力に String Constant ブロックで接続する場合、信号の値を表示する形式は [形式] パラメーターの値に関係なく string になります。同様に、Display ブロックを信号出力に Enumerated Constant ブロックで接続する場合、信号の値を表示する形式は [形式] パラメーターの値に関係なく enum になります。

プログラムでの使用

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

パラメーター:	Format
値:	'short' (既定値) | "short" | "long" | "shortE" | "longE" | "shortG" | "longG" | "shortEng" | "longEng" | "bank" | "+" | "hex" | "rat" | "Custom" | "Integer"

例: set_param(gcb,Format="longG")

書式文字列 — データを書式設定するカスタム文字列

'%d' (既定値) | 文字列

表示される信号データを書式設定するカスタム文字列。文字列として指定します。書式文字列はテキストと、% 記号で始まり変換文字で終わる書式演算子で構成されます。string の信号データを表示する場所で書式演算子を使用します。サポートされる書式演算子の詳細については、関数 compose の formatSpec 入力を参照してください。

例: The value of pi is %.2f は文中の接続された信号の値を表示します。

例: $%.2f は接続された信号の値を、ドル記号付きの小数点以下 2 桁で表示します。

依存関係

このパラメーターを有効にするには、[形式] パラメーターを Custom に設定します。

プログラムでの使用

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

パラメーター:	FormatString
値:	'%d' (既定値) | custom string or character array to format displayed value

例: set_param(gcb,FormatString="The value of pi is %.2f")

配置 — ブロック内のテキスト配置

Center (既定値) | Left | Right

Display ブロック内のテキスト配置。

プログラムでの使用

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

パラメーター:	Alignment
値:	'Center' (既定値) | "Left" | "Center" | "Right"

例: set_param(gcb,Alignment="Left")

ラベル — ブロック ラベルの位置

Hide (既定値) | Bottom | Top

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

プログラムでの使用

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

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

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

レイアウト — 非スカラー データの要素を並べ替える方法

Preserve dimensions (既定値) | Fill available space

非スカラー データの要素を並べ替える方法。次のいずれかのオプションとして指定します。

• Preserve dimensions — 信号の次元に一致するように要素を並べて表示する。

• Fill available space — 使用できるスペース内にできるだけ多くの要素を表示する。

プログラムでの使用

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

パラメーター:	Layout
値:	'Preserve dimensions' (既定値) | "Preserve dimensions" | "Fill available space"

例: set_param(gcb,Layout="Fill available space")

形式

非スカラーの信号のグリッドを表示 — グリッドを表示する場所

オン (既定値) | オフ

ブロックが非スカラー データを表示する場合に、ブロックでグリッドを表示する場所。[グリッド色] パラメーターを使用してグリッドの色を指定します。

プログラムでの使用

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

パラメーター:	ShowGrid
値:	'on' (既定値) | "on" | "off"

例: set_param(gcb,ShowGrid="off")

不透明度 — ブロックの背景の不透明度

1 (既定値) | スカラー

ブロックの背景の不透明度。0 ～ 1 のスカラー値として指定します。指定した値が 1 の場合、背景は完全に不透明になります。

プログラムでの使用

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

パラメーター:	Opacity
値:	'1' (既定値) | scalar with values between 0 and 1 formatted as string or character vector

例: set_param(gcb,Opacity="0.5")

前景色 — ブロックの前景色

[r g b] ベクトル

テキストを含むブロックの前景色。標準色のパレットから色を選択するか、カスタムの色を指定できます。

プログラムでの使用

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

パラメーター:	ForegroundColor
値:	[r g b] vector with values between 0 and 1 formatted as a string or character vector

例: set_param(gcb,ForegroundColor="[1 0 1]")

背景色 — 背景色

[r g b] ベクトル

背景色。標準色のパレットから色を選択するか、カスタムの色を指定できます。

プログラムでの使用

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

パラメーター:	BackgroundColor
値:	[r g b] vector with values between 0 and 1 formatted as a string or character vector

例: set_param(gcb,BackgroundColor="[1 0 1]")

グリッド色 — ブロックのグリッド色

[r g b] ベクトル

ブロックのグリッド色。ブロックが非スカラー データを表示する場合、グリッドが表示されます。標準色のパレットから色を選択するか、カスタムの色を指定できます。

プログラムでの使用

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

パラメーター:	GridColor
値:	[r g b] vector with values between 0 and 1

例: set_param(gcb,GridColor=[1 0 0])

ブロックの特性

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

拡張機能

C/C++ コード生成

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

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

バージョン履歴

R2017b で導入

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

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

参考

Dashboard Scope | Gauge | Lamp | MultiStateImage

トピック

• Dashboard のブロックを使用したモデルの調整と可視化
• シミュレーション データの可視化方法の決定