Half Gauge

半円形スケールでの入力値の表示

ライブラリ:
Simulink / Dashboard

説明

Half Gauge ブロックはシミュレーション中に接続された信号を半円形スケールで表示します。Half Gauge ブロックをその他の Dashboard ブロックと共に使用し、モデル用にコントロールおよびインジケーターの対話型のダッシュボードを作成できます。Half Gauge ブロックは、シミュレーション全体で接続された信号の瞬間的な値を示します。データに合うように Half Gauge ブロックの範囲を変更できます。Half Gauge ブロックの外観をカスタマイズして、信号に関する詳細情報を提供することもできます。たとえば、仕様範囲内と仕様範囲外を色分けすることができます。

メモ

ゲージの針は、接続された信号値がスケールの範囲外になった場合、スケールの最小値より下または最大値より上の指定値を指すことでそれを示します。指定値は信号値とは関係ありません。

Dashboard ブロックの接続

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

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

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

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

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

An unconnected Half Gauge block connects to the signal that a Sine Wave block sends to a Display block.

例

すべて展開する

Half Gauge ブロックを使用した信号値の表示

ライブスクリプトを開く

Half Gauge ブロックを使用すると、シミュレーション中に接続されている信号を半円スケールで表示できます。たとえば、モデル halfGaugeSine では、Half Gauge ブロックが sinSig という名前の正弦波信号に接続されています。

モデルのシミュレーションを実行します。シミュレーション中、Half Gauge ブロックは sinSig 信号の値を表示します。

Animation of the halfGaugeSine model during simulation

拡張例

フォールトトレラント燃料制御システムのモデル化

この例では、Stateflow® と Simulink® の機能を組み合わせてハイブリッドシステムをモデル化する方法を示します。このタイプのモデル化は、離散イベントに基づいて多数の可能な動作モードをもつシステムに対して特に便利です。従来の信号の流れが Simulink で処理されるのに対して、制御設定の変更は Stateflow で実装されます。この例で説明するモデルでは、ガソリンエンジンの燃料制御システムを表します。このシステムは、個々のセンサーの故障を検出し、制御システムが連続稼働用に動的に再設定されるという点で堅牢です。

モデルを開く

制限

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

シミュレーション中に Stateflow のチャートデータやステートアクティビティに Dashboard ブロックを接続することはできません。
プログラムで Stateflow のチャートデータやステートアクティビティに Dashboard ブロックを接続することはできません。
アクセラレータモードシミュレーションのためのブロックの削減または最適化により、一部の信号にはシミュレーションで使用できるデータが含まれないことがあります。Dashboard ブロックを使用してこのような信号を表示するには、信号をログ記録用にマークします。

パラメーター

すべて展開する

信号

接続 — 接続して表示する信号
信号の接続オプション

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

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

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

ブロックを選択します。
プロパティインスペクターの [パラメーター] タブで、[接続] または [変更] をクリックします。
接続先となる信号の信号線を選択します。
表示されたテーブルで、信号を選択します。
[適用] をクリックします。

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)

メイン

最小値 — 目盛りの最小値
`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])

スケールカラー — ゲージのスケールの色表示
スケールの範囲の色

スケールの値の範囲の色指定。[+] ボタンを押してスケールの色を追加します。追加された色ごとに、その色を表示する範囲の最小値と最大値を指定します。

プログラムでの使用

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

ScaleColors パラメーターの値を構造体の配列として指定します。定義する色の範囲ごとに 1 つの構造体を指定します。各構造体には次のフィールドがあります。

Min — スケールの色の範囲の最小値。
Max — スケールの色の範囲の最大値。
Color — 1 行 3 列の 0 ～ 1 の値の [r g b] ベクトル。

たとえば、次のコードは 2 つの値の範囲の色を指定します。コードにより、0 から 50 には青のスケールの色が追加され、50 から 100 には緑のスケールの色が追加されます。

range1.Min = 0;
range1.Max = 50;
range1.Color = [0 0 1];
range2.Min = 50;
range2.Max = 100;
range2.Color = [0 1 0];
scaleRanges = [range1 range2];

set_param(gcb,ScaleColors=scaleRanges)

パラメーター:	`ScaleColors`
値:	`N`-by-`1` struct array, where `N` is the number of color ranges and each struct has the fields `Min`, `Max`, and `Color`

例: set_param(gcb,ScaleColors=scaleRanges)

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

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

プログラムでの使用

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

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

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

スケールの方向 — ゲージスケールの方向
`Clockwise` (既定値) | `Counterclockwise`

ゲージスケールの方向。

プログラムでの使用

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

パラメーター:	`ScaleDirection`
値:	`'Clockwise'` (既定値) \| `"Clockwise"` \| `"Counterclockwise"`

例: set_param(gcb,ScaleDirection="Counterclockwise")

形式

不透明度 — ブロックの背景の不透明度
`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 を使用します。

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

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

ブロックの特性

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

拡張機能

すべて展開する

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

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

バージョン履歴

R2015a で導入

すべて展開する

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

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

参考

Gauge | Linear Gauge | Quarter Gauge | Circular Gauge

Half Gauge

説明

Dashboard ブロックの接続

例

Half Gauge ブロックを使用した信号値の表示

拡張例

フォールトトレラント燃料制御システムのモデル化

制限

パラメーター

信号

接続 — 接続して表示する信号 信号の接続オプション

プログラムでの使用

メイン

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

プログラムでの使用

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

プログラムでの使用

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

プログラムでの使用

スケール カラー — ゲージのスケールの色表示 スケールの範囲の色

プログラムでの使用

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

プログラムでの使用

スケールの方向 — ゲージ スケールの方向 Clockwise (既定値) | Counterclockwise

プログラムでの使用

形式

不透明度 — ブロックの背景の不透明度 1 (既定値) | スカラー

プログラムでの使用

前景色 — ブロックの前景色 [r g b] ベクトル

プログラムでの使用

背景色 — 背景色 [r g b] ベクトル

プログラムでの使用

フォントの色 — ブロックのフォントの色 [r g b] ベクトル

プログラムでの使用

ブロックの特性

拡張機能

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

バージョン履歴

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

参考

トピック

接続 — 接続して表示する信号
信号の接続オプション

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

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

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

スケールカラー — ゲージのスケールの色表示
スケールの範囲の色

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

スケールの方向 — ゲージスケールの方向
`Clockwise` (既定値) | `Counterclockwise`

不透明度 — ブロックの背景の不透明度
`1` (既定値) | スカラー

前景色 — ブロックの前景色
`[r g b]` ベクトル

背景色 — 背景色
`[r g b]` ベクトル

フォントの色 — ブロックのフォントの色
`[r g b]` ベクトル

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

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