Horizontal Gauge

外観をカスタマイズ可能な水平ゲージでのシミュレーション中の信号値の表示

ライブラリ:
Simulink / Dashboard / Customizable Blocks

Horizontal Gauge ブロックの代替構成:
Vertical Gauge

説明

シミュレーション中、Horizontal Gauge ブロックは、実際のシステムのゲージのようにカスタマイズ可能な線形ゲージ上に接続された信号の値を表示します。データに合わせて Horizontal Gauge ブロックの範囲と目盛り値を変更できます。Horizontal Gauge ブロックをその他の Dashboard ブロックと共に使用し、コントロールおよびインジケーターからなる、モデルの対話型のダッシュボードを作成します。

Horizontal Gauge ブロックのカスタマイズ

Horizontal Gauge ブロックをモデルに追加すると、既定の設計でブロックが事前構成されます。ブロックを既定の設計で使用することも、ブロックの外観をカスタマイズすることもできます。

ブロックの外観をカスタマイズするには、設計モードを使用します。ブロックを選択してから、次の 3 つのいずれかの方法で設計モードを開始できます。

Simulink^® ツールストリップのブロック固有のタブにある [設計] で [編集] をクリックする。
プロパティインスペクターの [設計] タブで、[編集] をクリックする。
ブロックをポイントすると表示される省略記号で [カスタムブロックの編集] ボタンをクリックする。

設計モードでは、ブロックの上にあるツールバーを使用して円形ゲージをカスタマイズできます。追加のカスタマイズオプションにアクセスするか、設計設定の正確な値を入力するには、プロパティインスペクターの [設計] タブを使用します。

Horizontal Gauge block in design mode with the toolbar and the Design tab in the Property Inspector visible.

設計モードの操作

アクション	ツールバーで使用可能か	[設計] タブで使用可能か
針のイメージをアップロードする。	はい	はい
背景イメージをアップロードする。	はい	はい
塗りつぶしの背景色を設定する。	いいえ	はい
前景イメージをアップロードする。	いいえ	はい
値バーの増加が始まる原点の位置を指定する。	いいえ	はい
スケールの目盛り、スケールのラベル、または値バーの色と不透明度を変更する。	はい	はい
スケールの方向 (左から右または右から左) を指定する。	いいえ	はい
スケールと針のサイズを変更する。	いいえ	はい
スケールと針の位置を変更する。	いいえ	はい

ツールバーを使用してスケールの目盛り、スケールのラベル、または値バーの色と不透明度を変更するには、ツールバーの左から 2 番目のセクションで、色を変更するコンポーネントを選択します。色を変更するには、カラーホイールをクリックします。不透明度を変更するには、スライダーを移動します。

ツールバーおよび [設計] タブを使用してブロック設計をカスタマイズするだけでなく、キャンバス内でコンポーネントのサイズ変更や位置変更を対話的に行うこともできます。

設計の編集が完了し、設計モードを終了するには、キャンバスの右上にある [X] をクリックします。

Dashboard ブロックの接続

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

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

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

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

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

An unconnected Horizontal Gauge block connects to the signal that a Sine Wave block sends to an Outport block.

例

カスタムゲージの設計

Circular Gauge ブロック、Horizontal Gauge ブロック、Vertical Gauge ブロックを使用したゲージの設計。

モデルを開く

制限

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

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

パラメーター

すべて展開する

プロパティインスペクターと [ブロックパラメーター] ダイアログボックスを使用してブロックパラメーターの値を指定します。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])

スケールの方向 — スケール値が増加する方向
`'Left to right'` (既定値) | `'Right to left'`

スケール値が増加する方向を設定します。

プログラムでの使用

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

パラメーター:	`ScaleDirection`
値:	`'Left to right'` (既定値) \| `"Left to right"` \| `"Right to Left"`

例: set_param(gcb,ScaleDirection="Right to Left")

ラベル — 接続された要素の名前を表示するラベルの位置
`Hide` (既定値) | `Bottom` | `Top`

Dashboard ブロックが接続された要素の名前をブロックの上または下に配置されるラベルに表示できます。ラベルを非表示にすることもできます。ラベルを表示する場合は、ラベルの位置を指定します。ラベルを表示しない場合は、Hide を選択します。

メモ

Dashboard ブロックが要素に接続されていない場合、ラベルは空白になります。

プログラムでの使用

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

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

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

縦横比をロック — ブロックの縦横比を維持するオプション
`on` (既定値) | `off`

Simulink キャンバスでブロックのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

縦横比がロックされている場合、新しい背景イメージを追加すると、背景イメージの縦横比に適合するようにブロックの縦横比が変更されます。縦横比がロックされていない場合、新しい背景イメージを追加してもブロックの縦横比は変更されませんが、代わりにブロックのサイズに適合するように背景イメージの縦横比が変更されます。

縦横比がロックされている場合、ブロックのサイズ変更中に Shift キーを押している間は縦横比のロックが一時的に解除されます。Shift キーを放すと縦横比がロックされます。縦横比がロックされていない場合、ブロックのサイズ変更中に Shift キーを押している間は縦横比が一時的にロックされます。Shift キーを放すと縦横比のロックが解除されます。

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

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

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、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)

プロパティインスペクターの [設計] タブ

Dashboard ブロックをカスタマイズするには、プロパティインスペクターを開き、[設計] タブで [編集] をクリックします。

直線ゲージ

縦横比をロック — ブロックの縦横比を維持するオプション
`on` (既定値) | `off`

Simulink キャンバスでブロックのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

縦横比がロックされている場合、新しい背景イメージを追加すると、背景イメージの縦横比に適合するようにブロックの縦横比が変更されます。縦横比がロックされていない場合、新しい背景イメージを追加してもブロックの比率は変更されませんが、代わりにブロックのサイズに適合するように背景イメージが引き伸ばされたりスケーリングされたりします。

縦横比がロックされている場合、ブロックのサイズ変更中に Shift キーを押している間は縦横比のロックが解除されます。Shift キーを放すと縦横比がロックされます。縦横比がロックされていない場合、ブロックのサイズ変更中に Shift キーを押している間は縦横比がロックされます。Shift キーを放すと縦横比のロックが解除されます。

スケール

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

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、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` (既定値) | スカラー

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、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` (既定値) | スカラー

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、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])

原点 — 針が動いて値バーの増加が始まるスケールの値
`auto` (既定値) | スカラー

針が動いて値バーの増加が始まるスケールの値を指定します。auto に設定すると、Origin はスケールの最小値になります。

スケールの方向 — スケール値が増加する方向
`'Left to right'` (既定値) | `'Right to left'`

スケール値が増加する方向を設定します。

プログラムでの使用

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

パラメーター:	`ScaleDirection`
値:	`'Left to right'` (既定値) \| `"Left to right"` \| `"Right to Left"`

例: set_param(gcb,ScaleDirection="Right to Left")

X オフセット — ブロックの左端からスケールの境界ボックスの左端までの水平方向のオフセット
スカラー

ブロックの左端からスケールの境界ボックスの左端までの水平方向のオフセットをブロックの幅の比率として指定します。オフセットが 0 のときのスケールの位置を基準に、負の値のオフセットではスケールが左に移動し、正の値のオフセットではスケールが右に移動します。

Y オフセット — ブロックの上端からスケールの境界ボックスの上端までの垂直方向のオフセット
スカラー

ブロックの上端からスケールの境界ボックスの上端までの垂直方向のオフセットをブロックの高さの比率として指定します。オフセットが 0 のときのスケールの位置を基準に、負の値のオフセットではスケールが上に移動し、正の値のオフセットではスケールが下に移動します。

幅 — スケールの幅
スカラー

スケールの境界ボックスの幅をブロックの幅の比率として指定します。

高さ — スケールの高さ
スカラー

スケールの境界ボックスの高さをブロックの高さの比率として指定します。

縦横比をロック — スケールの縦横比を維持するオプション
`on` (既定値) | `off`

プロパティインスペクターを使用してスケールのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

メモリの色 — スケールの目盛り、範囲ライン、ブロック名の色
`[r g b]` ベクトル

スケールの目盛り、範囲ライン、ブロック名の色を設定します。色を標準色のパレットから選択するか、カスタムの色を指定します。

ヒント

[メモリの色] は、Simulink ツールストリップの [書式設定] タブで [前景色] を選択して設定することもできます。

ブロックのテキストの色を指定するには、[ラベルの色] パラメーターを使用します。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、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]` ベクトル

スケールのラベルのフォントの色を標準色のパレットから選択するか、カスタムの色を指定します。

例: [1 1 0.5]

ヒント

スケールの色を指定するには、[メモリの色] パラメーターを使用します。

ラベルオフセット — スケールの目盛りの自由端からスケールのラベルまでの垂直方向の距離
`0.3` (既定値) | スカラー

スケールのラベルからスケールの対応する目盛りの自由端までの垂直方向の距離をスケールの境界ボックスの高さの比率として指定します。

針

幅 — 針のイメージの幅
スカラー

針のイメージの幅をブロックの幅の比率として指定します。

高さ — 針のイメージの高さ
スカラー

針のイメージの高さをブロックの高さの比率として指定します。

縦横比をロック — イメージの縦横比を維持するオプション
`on` (既定値) | `off`

プロパティインスペクターを使用してイメージのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

X オフセット — スケールの原点から針のイメージの中心までの水平方向のオフセット
スカラー

スケールの原点から針のイメージの中心までの水平方向のオフセットを針のイメージの幅の比率として指定します。オフセットが 0 のときの針のイメージの位置を基準に、負の値のオフセットではイメージが左に移動し、正の値のオフセットではイメージが右に移動します。

Y オフセット — スケールの範囲ラインから針のイメージの上端までの垂直方向のオフセット
スカラー

スケールの範囲ラインから針のイメージの上端までの垂直方向のオフセットを針のイメージの高さの比率として指定します。オフセットが 0 のときの針のイメージの位置を基準に、負の値のオフセットではイメージが上に移動し、正の値のオフセットではイメージが下に移動します。

値バー

スケールからのオフセット — 範囲ラインから値バーの上端までの距離
`0` (既定値) | スカラー

値バーの上端から範囲ラインまでの距離をスケールの境界ボックスの高さの比率として指定します。オフセットが 0 のときの値バーの位置を基準に、負の値のオフセットでは値バーが上に移動し、正の値のオフセットでは値バーが下に移動します。

サイズ — 値バーの太さ
スカラー

値バーの太さをスケールの境界ボックスの高さの比率として指定します。

背景イメージ

背景色の使用 — 塗りつぶしのブロックの背景色を指定するオプション
`off` (既定値) | `on`

ブロックの背景について、背景イメージを提供するか塗りつぶしの色を選択できます。塗りつぶしの背景色を選択するには、このパラメーターを選択します。背景イメージを提供するには、このパラメーターをクリアします。

メモ

Simulink ツールストリップの [書式設定] タブを使用して背景色を変更すると、背景イメージが削除され、[背景色の使用] パラメーターが有効になります。

色 — 背景色
`[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]")

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

ブロックの背景の不透明度を 0 ～ 1 のスカラー値として指定します。

角の半径 — ブロックの背景色をもつ領域の角の半径
スカラー

ブロックの背景色でカバーされる領域の角の半径をブロックの幅と高さの 2 つの寸法のうちの小さい方の半分の比率として指定します。

前景イメージ

X オフセット — ブロックの左端から前景イメージの左端までの水平方向のオフセット
スカラー

ブロックの左端からイメージの左端までの水平方向のオフセットをブロックの幅の比率として指定します。オフセットが 0 のときのイメージの位置を基準に、負の値のオフセットではイメージが左に移動し、正の値のオフセットではイメージが右に移動します。

Y オフセット — ブロックの上端から前景イメージの上端までの垂直方向のオフセット
スカラー

ブロックの上端からイメージの上端までの垂直方向のオフセットをブロックの高さの比率として指定します。オフセットが 0 のときのイメージの位置を基準に、負の値のオフセットではイメージが上に移動し、正の値ではイメージが下に移動します。

幅 — 前景イメージの幅
スカラー

前景イメージの幅をブロックの幅の比率として指定します。

高さ — 前景イメージの高さ
スカラー

前景イメージの高さをブロックの高さの比率として指定します。

縦横比をロック — 前景イメージの縦横比を維持するオプション
`on` (既定値) | `off`

プロパティインスペクターを使用してイメージのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

ブロックの特性

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

代替構成

すべて展開する

Vertical Gauge — 垂直方向の直線ゲージ

Vertical Gauge ブロックは、外観をカスタマイズ可能な垂直ゲージでシミュレーション中の信号値を表示します。

水平方向のゲージを垂直方向のゲージに変換するには、Horizontal Gauge ブロックを選択し、Ctrl+R を押します (macOS では、代わりに command+R を押します)。

メモ

Horizontal Gauge ブロックにイメージの横軸について対称ではない前景イメージまたは背景イメージがある場合、ブロックを回転した後に、そのイメージを、縦軸について鏡像化したイメージのコピーに置き換える必要が生じることがあります。

ライブラリ:
Simulink / Dashboard / Customizable Blocks

拡張機能

すべて展開する

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

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

バージョン履歴

R2020a で導入

すべて展開する

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

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

R2026a: クイック挿入メニューを使用したダッシュボードパネルへのブロックの追加

クイック挿入メニューを使用して、ダッシュボードパネルにブロックを追加できるようになりました。詳細については、Getting Started with Dashboard Panelsを参照してください。

R2026a: ダッシュボードパネルのタブのプログラムによる切り替え

ダッシュボードパネルには、複数のタブを含めることができます。simulink.dashboard.switchPanelTab 関数を使用して、パネルに表示されるタブをプログラムから切り替えられるようになりました。たとえば、この機能を使用して、ボタンをクリックするとタブが切り替わるダッシュボードを作成できます。これには、ボタンをクリックすると実行されるコールバック関数内に simulink.dashbaord.switchPanelTab 関数を記述します。

R2026a: ブロックが Dashboard ブロックであるかどうかのプログラムによる確認

Dashboard ブロックは次のライブラリのブロックです。

Dashboard ライブラリ (Customizable Blocks サブライブラリを含む)
Aerospace Blockset™ ライブラリ

simulink.dashboard.isDashboardBlock 関数を使用して、ブロックが Dashboard ブロックであるかどうかをプログラムで確認できるようになりました。

R2024b: Dashboard ブロックの縦横比のロックをキーボードで解除

Dashboard ライブラリのブロックの縦横比がロックされている場合、Shift キーを押すことで縦横比のロックを一時的に解除できます。Shift キーを放すと縦横比がロックされます。

縦横比がロックされていない場合は、Shift キーを押すと縦横比が一時的にロックされます。Shift キーを放すと縦横比のロックが解除されます。

R2024a: Web アプリまたはスタンドアロンデスクトップアプリとしてのダッシュボードパネルの展開

Simulink Compiler™ ライセンスをお持ちの場合、パネルが接続されているモデルにパッケージ化されたダッシュボードパネルをスタンドアロンのデスクトップアプリまたは Web アプリとして展開できるようになりました。アプリを使用すると、Simulink とは独立してコントロールを操作したり、パネル上の表示を監視したりできます。

パネルの展開方法については、Deploy Dashboard Panel as Appを参照してください。

R2024a: ダッシュボードパネルのドック

R2024a 以降では、ダッシュボードパネルを Simulink エディターウィンドウにドックできます。ドックされたパネルを使用すると、キャンバスでモデルのブロック線図を覆うことなく、シミュレーション中に信号を監視し、パラメーターを制御できます。

詳細については、Dock Panelsを参照してください。

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 ブロックをクリックすると、[ゲージ] タブがツールストリップに表示されます。

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

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

R2022b: Raspberry Pi ボードのカスタマイズ可能な Dashboard ブロックに対する拡張サポート

R2022b 以降では、Raspberry Pi^® ボードへの [Customizable Blocks] ライブラリの次のブロックの展開が Simulink Support Package for Raspberry Pi Hardware でサポートされます。

Horizontal Gauge
Horizontal Slider
Lamp
Push Button
Rocker Switch
Rotary Switch
Slider Switch
Toggle Switch
Vertical Gauge
Vertical Slider

Simulink モデルでブロックの視覚的な側面をカスタマイズし、Raspberry Pi 端末から起動する Web ブラウザーで WYSIWYG (What You See Is What You Get) の可視化が可能です。

R2022b: Android デバイスのカスタマイズ可能な Dashboard ブロックに対する拡張サポート

R2022b 以降では、Android^® デバイスへの [Customizable Blocks] ライブラリの次のブロックの展開が Simulink Support Package for Android Devices でサポートされます。

Horizontal Gauge
Horizontal Slider
Lamp
Push Button
Rocker Switch
Rotary Switch
Slider Switch
Toggle Switch
Vertical Gauge
Vertical Slider

Simulink モデルでブロックの視覚的な側面をカスタマイズし、Android デバイスおよび Web ブラウザーで WYSIWYG (What You See Is What You Get) の可視化が可能です。

R2022a: スケールの方向の変更

R2022a 以降では、[Customizable Blocks] ライブラリの次のブロックについて、スケールの方向を変更できます。

Circular Gauge
Horizontal Gauge
Horizontal Slider
Knob
Vertical Gauge
Vertical Slider

R2022a: 値バーと針の原点の指定

スケールの原点は、針が動いて値バーの増加が始まるスケールの値です。R2022a 以降では、[Customizable Blocks] ライブラリの次のブロックについて、スケールの原点を指定できます。

Circular Gauge
Horizontal Gauge
Horizontal Slider
Knob
Vertical Gauge
Vertical Slider

R2022a: 前景イメージのサイズと位置の変更

Customizable Blocks ライブラリのブロックには、ブロックの設計の一部として前景イメージを追加するオプションがあります。R2022a 以降では、ブロックの設計内で前景イメージの回転やサイズと位置の変更が可能です。

R2021a: カスタマイズ可能なゲージの Dashboard ブロックを Customizable Blocks ライブラリに移動

以前のリリースでは、Circular Gauge ブロック、Horizontal Gauge ブロック、Vertical Gauge ブロックは Dashboard ライブラリに含まれていました。R2021a 以降では、これらのブロックが Dashboard ライブラリ内の Customizable Blocks サブライブラリに含まれています。

R2021a: ゲージの Dashboard ブロックにおける前景、背景、フォントの色のサポート

R2021a 以降では、次のブロックの前景、背景、およびフォントの色を変更できます。

Gauge
Half Gauge
Linear Gauge
Quarter Gauge
Circular Gauge
Horizontal Gauge
Vertical Gauge

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

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

R2020b: Horizontal Gauge ブロック、Vertical Gauge ブロック、Circular Gauge ブロックへの前景イメージの追加

R2020b 以降では、モデル内の Horizontal Gauge ブロック、Vertical Gauge ブロック、Circular Gauge ブロックに前景イメージを追加できます。

参考

ブロック

Circular Gauge | Quarter Gauge | Half Gauge | Vertical Gauge | Gauge | Linear Gauge

ツール

シミュレーションペーシングオプション

Horizontal Gauge

説明

Horizontal Gauge ブロックのカスタマイズ

Dashboard ブロックの接続

例

カスタム ゲージの設計

制限

パラメーター

プロパティ インスペクターの [パラメーター] タブ

信号

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

プログラムでの使用

メイン

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

プログラムでの使用

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

プログラムでの使用

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

プログラムでの使用

スケールの方向 — スケール値が増加する方向 'Left to right' (既定値) | 'Right to left'

プログラムでの使用

ラベル — 接続された要素の名前を表示するラベルの位置 Hide (既定値) | Bottom | Top

プログラムでの使用

縦横比をロック — ブロックの縦横比を維持するオプション on (既定値) | off

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

プログラムでの使用

プロパティ インスペクターの [設計] タブ

直線ゲージ

縦横比をロック — ブロックの縦横比を維持するオプション on (既定値) | off

スケール

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

プログラムでの使用

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

プログラムでの使用

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

プログラムでの使用

原点 — 針が動いて値バーの増加が始まるスケールの値 auto (既定値) | スカラー

スケールの方向 — スケール値が増加する方向 'Left to right' (既定値) | 'Right to left'

プログラムでの使用

X オフセット — ブロックの左端からスケールの境界ボックスの左端までの水平方向のオフセット スカラー

Y オフセット — ブロックの上端からスケールの境界ボックスの上端までの垂直方向のオフセット スカラー

幅 — スケールの幅 スカラー

高さ — スケールの高さ スカラー

縦横比をロック — スケールの縦横比を維持するオプション on (既定値) | off

メモリの色 — スケールの目盛り、範囲ライン、ブロック名の色 [r g b] ベクトル

プログラムでの使用

ラベルの色 — スケールのラベルのフォントの色 [r g b] ベクトル

ラベル オフセット — スケールの目盛りの自由端からスケールのラベルまでの垂直方向の距離 0.3 (既定値) | スカラー

針

幅 — 針のイメージの幅 スカラー

高さ — 針のイメージの高さ スカラー

縦横比をロック — イメージの縦横比を維持するオプション on (既定値) | off

X オフセット — スケールの原点から針のイメージの中心までの水平方向のオフセット スカラー

Y オフセット — スケールの範囲ラインから針のイメージの上端までの垂直方向のオフセット スカラー

値バー

スケールからのオフセット — 範囲ラインから値バーの上端までの距離 0 (既定値) | スカラー

サイズ — 値バーの太さ スカラー

背景イメージ

背景色の使用 — 塗りつぶしのブロックの背景色を指定するオプション off (既定値) | on

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

プログラムでの使用

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

角の半径 — ブロックの背景色をもつ領域の角の半径 スカラー

前景イメージ

X オフセット — ブロックの左端から前景イメージの左端までの水平方向のオフセット スカラー

Y オフセット — ブロックの上端から前景イメージの上端までの垂直方向のオフセット スカラー

幅 — 前景イメージの幅 スカラー

高さ — 前景イメージの高さ スカラー

縦横比をロック — 前景イメージの縦横比を維持するオプション on (既定値) | off

ブロックの特性

代替構成

Vertical Gauge — 垂直方向の直線ゲージ

拡張機能

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

バージョン履歴

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

R2026a: クイック挿入メニューを使用したダッシュボード パネルへのブロックの追加

R2026a: ダッシュボード パネルのタブのプログラムによる切り替え

R2026a: ブロックが Dashboard ブロックであるかどうかのプログラムによる確認

R2024b: Dashboard ブロックの縦横比のロックをキーボードで解除

カスタムゲージの設計

プロパティインスペクターの [パラメーター] タブ

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

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

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

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

スケールの方向 — スケール値が増加する方向
`'Left to right'` (既定値) | `'Right to left'`

ラベル — 接続された要素の名前を表示するラベルの位置
`Hide` (既定値) | `Bottom` | `Top`

縦横比をロック — ブロックの縦横比を維持するオプション
`on` (既定値) | `off`

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

プロパティインスペクターの [設計] タブ

縦横比をロック — ブロックの縦横比を維持するオプション
`on` (既定値) | `off`

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

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

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

原点 — 針が動いて値バーの増加が始まるスケールの値
`auto` (既定値) | スカラー

スケールの方向 — スケール値が増加する方向
`'Left to right'` (既定値) | `'Right to left'`

X オフセット — ブロックの左端からスケールの境界ボックスの左端までの水平方向のオフセット
スカラー

Y オフセット — ブロックの上端からスケールの境界ボックスの上端までの垂直方向のオフセット
スカラー

幅 — スケールの幅
スカラー

高さ — スケールの高さ
スカラー

縦横比をロック — スケールの縦横比を維持するオプション
`on` (既定値) | `off`

メモリの色 — スケールの目盛り、範囲ライン、ブロック名の色
`[r g b]` ベクトル

ラベルの色 — スケールのラベルのフォントの色
`[r g b]` ベクトル

ラベルオフセット — スケールの目盛りの自由端からスケールのラベルまでの垂直方向の距離
`0.3` (既定値) | スカラー

幅 — 針のイメージの幅
スカラー

高さ — 針のイメージの高さ
スカラー

縦横比をロック — イメージの縦横比を維持するオプション
`on` (既定値) | `off`

X オフセット — スケールの原点から針のイメージの中心までの水平方向のオフセット
スカラー

Y オフセット — スケールの範囲ラインから針のイメージの上端までの垂直方向のオフセット
スカラー

スケールからのオフセット — 範囲ラインから値バーの上端までの距離
`0` (既定値) | スカラー

サイズ — 値バーの太さ
スカラー

背景色の使用 — 塗りつぶしのブロックの背景色を指定するオプション
`off` (既定値) | `on`

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

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

角の半径 — ブロックの背景色をもつ領域の角の半径
スカラー

X オフセット — ブロックの左端から前景イメージの左端までの水平方向のオフセット
スカラー

Y オフセット — ブロックの上端から前景イメージの上端までの垂直方向のオフセット
スカラー

幅 — 前景イメージの幅
スカラー

高さ — 前景イメージの高さ
スカラー

縦横比をロック — 前景イメージの縦横比を維持するオプション
`on` (既定値) | `off`

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

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

R2026a: クイック挿入メニューを使用したダッシュボードパネルへのブロックの追加

R2026a: ダッシュボードパネルのタブのプログラムによる切り替え

R2024a: Web アプリまたはスタンドアロンデスクトップアプリとしてのダッシュボードパネルの展開

R2024a: ダッシュボードパネルのドック