Signal Editor

相互交換可能なシナリオを表示、作成、編集、および切り替える

• ライブラリ:

• Simulink / Sources

• 

×

説明

Signal Editor ブロックは、相互交換可能なシナリオを表示、作成、および編集します。このブロックを使用して、モデルでシナリオを切り替えることもできます。

Signal Editor ブロックは、1 つ以上のスカラー Simulink.SimulationData.Dataset オブジェクトを含む MAT ファイルをサポートします。

関数 signalBuilderToSignalEditor を使用して Signal Builder ブロック構成を Signal Editor ブロックに移植できます。詳細については、Replace Signal Builder Block with Signal Editor Blockを参照してください。

Signal Editor ブロックに含まれるシナリオと信号の合計数をプログラムで取得するには、get_param の NumberOfScenarios プロパティと NumberOfSignals プロパティを使用します。これらのプロパティには値が文字ベクトルとして含まれます。これらの値を double に変換するには、関数 str2double を使用します。

Signal Editor ブロックによる出力信号線のラベル付けをプログラムによって有効にするには、set_param PreserveSignalName を 'on' (既定値) に設定します。次に例を示します。

set_param(gcb,'PreserveSignalName','on')

高速リスタート

Signal Editor ブロックは高速リスタートをサポートします。高速リスタートを有効にしても、引き続き以下を実行できます。

• アクティブなシナリオを変更する。

• アクティブな信号を変更する。

  アクティブな信号は変更できますが、ブロックの信号プロパティは編集できません。

• 信号エディターのユーザー インターフェイスを起動してデータを編集する。

制限

Signal Editor ブロックでは以下はサポートされません。

• 関数呼び出し

• 接地信号

Signal Editor ブロックは動的な string をサポートします。最大長が指定された string はサポートしません。さらに、Signal Editor ブロック内の string は次を出力できません。

• 非スカラーの MATLAB string。

• 欠損値を含む string データ。

• 非 ASCII 文字を含む string データ。

端子

出力引数

Signal1 — シナリオの信号

多次元

1 つ以上の信号。次を指定できます。

• MATLAB^® timeseries オブジェクト

• MATLAB timeseries オブジェクトの構造体

• 2 次元行列

端子ラベルは、データセット MAT ファイル内の関連する変数に依存します。

データ型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | string | Boolean | fixed point | enumerated | bus

パラメーター

ファイル名 — データセット ファイル

untitled.mat (既定値) | 文字ベクトル

1 つ以上のスカラー Simulink.SimulationData.Dataset オブジェクトを含むデータセット ファイル。文字ベクトルとして指定します。別のロケールにあるロケールのファイル名を使用しないでください。複数のプラットフォームでブロックを使用するときは、MAT ファイル名のみを指定し、MAT ファイルを MATLAB パス上に配置することを検討してください。

依存関係

• untitled.mat が現在のフォルダーに存在しない場合、以下のパラメーターは無効です。

  • アクティブなシナリオ

  • 信号

  • バス信号を出力

  • Unit

  • サンプル時間

  • データを内挿する

  • ゼロクロッシング検出を有効にする

  • 最後のデータ後の出力フォーム

• MAT ファイルを作成するには、 をクリックします。このボタンで信号エディターのユーザー インターフェイスが開始され、シナリオの MAT ファイルを作成および編集できます。

プログラムでの使用

ブロック パラメーター: Filename

型: 文字ベクトル

値: 文字ベクトル

既定の設定: 'untitled.mat'

アクティブなシナリオ — アクティブなシナリオ

Scenario (既定値) | 文字ベクトル

アクティブなシナリオ。文字ベクトルとして指定します。指定した MAT ファイルが存在していなければなりません。必要に応じてアクティブなシナリオを切り替えることができます。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: ActiveScenario

型: 文字ベクトル | 数値

値: 文字ベクトル | インデックス値

既定の設定: 'Scenario'

シナリオを作成および編集するには、信号エディターのユーザー インターフェイスを起動します — 信号エディターを起動

ボタンのクリック

信号エディターのユーザー インターフェイスを起動するには、 をクリックします。

アクティブな信号 — 設定する信号

Signal 1 (既定値) | 文字ベクトル

設定する信号。信号名として指定します。この信号はアクティブな信号と見なされます。MAT ファイルは、信号を設定する前に存在していなければなりません。

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

ヒント

関数 set_param を使用して、アクティブな信号プロパティの名前と値の引数 ('ActiveSignal') を Signal Editor ブロックの別の値と名前のペア引数と組み合わせて設定しないでください。

プログラムでの使用

ブロック パラメーター: ActiveSignal

型: 文字ベクトル | 数値

値: 文字ベクトル | インデックス ベクトル

既定の設定: 'Signal 1'

バス信号を出力 — 信号をバスとして設定

オフ (既定値) | オン

信号をバスとして次のように設定します。

オン

信号をバスとして設定します。

オフ

信号をバスとして設定しません。

指定した MAT ファイルが存在していなければなりません。

ヒント

このチェック ボックスは、アクティブな信号が、既存のバス オブジェクトと同じフィールドをもつ MATLAB 構造体である場合のみオンにし、それ以外の場合は対応する新しいバス オブジェクトを作成してください。MATLAB 構造体でないアクティブな信号に対してこのチェック ボックスをオンにすると、シミュレーションはエラーを返します。

依存関係

• [バス信号を出力] チェック ボックスをオンにすると、[バス オブジェクトの選択] パラメーターが有効になります。

• このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: IsBus

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

バス オブジェクトの選択 — バス オブジェクト

Bus: BusObject (既定値) | バス オブジェクト名

バス オブジェクトの名前を選択するか、入力します。データ型アシスタントを使用してバス オブジェクト編集する、またはバス オブジェクトを作成するには、[>>] をクリックします。アクティブな信号は、このバス オブジェクトと同じフィールドをもつ MATLAB 構造体でなければなりません。指定した MAT ファイルが存在していなければなりません。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: OutputBusObjectStr

型: 文字ベクトル

値: バス オブジェクト名

既定の設定: 'Bus: BusObject'

モード — バス オブジェクト モード

Bus Object (既定値) | バス オブジェクト データ型

バス オブジェクト名を選択します。バス オブジェクトがない場合は、[編集] をクリックして型エディターを起動し、バス オブジェクトを作成します。詳細については、Simulink.Bus オブジェクトの作成と指定を参照してください。

単位 — 物理単位

継承 (既定値) | サポートされる物理単位

信号の物理単位、許可された単位として指定します。単位を指定するには、テキスト ボックスに入力します。入力中、パラメーターには一致する可能性のある単位が表示されます。詳細については、Simulink モデルでの単位の指定を参照してください。サポートされる単位のリストについては、「Allowed Units」を参照してください。

単位系を制約するには、パラメーターの右側にあるリンクをクリックします。

• Unit System Configuration ブロックがコンポーネントに存在する場合は、そのダイアログ ボックスが表示されます。そのダイアログ ボックスを使用して、コンポーネントに対して許可される単位系と許可されない単位系を指定します。

• Unit System Configuration ブロックがコンポーネントに存在しない場合は、モデルの [コンフィギュレーション パラメーター] ダイアログ ボックスが表示されます。そのダイアログ ボックスを使用して、モデルに対して許可される単位系と許可されない単位系を指定します。

指定した MAT ファイルが存在していなければなりません。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: Unit

型: 文字ベクトル

値: 'inherit' | サポートされる物理単位

既定の設定: 'inherit'

サンプル時間 — サンプルの時間間隔。

0 (既定値) | -1 | サンプル時間 (秒単位)

サンプルの時間間隔。秒単位で指定します。指定した MAT ファイルが存在していなければなりません。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: SampleTime

型: 文字ベクトル

値: -1 | サンプル時間 (秒単位)

既定の設定: '0'

データを内挿する — データを線形内挿する

オフ (既定値) | オン

対応するワークスペース データが存在しない時間ヒットで、データを線形内挿します。指定した MAT ファイルが存在していなければなりません。

Signal Editor ブロックは、以下のように線形内挿します。

オン

対応するワークスペース データが存在しない時間ヒットで線形内挿を行うには、このオプションを選択します。

オフ

現在の出力は、データが存在する最も近い時間での出力に等しくなります。

Signal Editor ブロックは、ワークスペースの 2 つの対応するサンプルを使用して内挿を行います。

• double データの場合、2 つの対応するサンプルを使用して値を線形内挿します

• Boolean データの場合、2 つの時間値間の最初の半分の時間に false を使用し、残りの半分に true を使用します

• double または Boolean 以外の組み込みデータ型の場合は次のようになります。

  • データを double にアップキャストする

  • 線形内挿を実行する (double データの説明を参照)

  • 内挿値を元のデータ型にダウンキャストする

列挙型 (enum) データでは線形内挿は使用できません。

ブロックは、最後の既知のデータ点の値を、その点の後の時間ヒットの値として使用します。

データが入手可能な最後の時間ヒット後のブロック出力を決定するには、以下のパラメーターの設定を組み合わせます。

• データを内挿する

• 最後のデータ後の出力フォーム

詳細については、[最後のデータ後の出力フォーム] パラメーターを参照してください。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: Interpolate

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

ゼロクロッシング検出を有効にする — ゼロクロッシングを検出する

オフ (既定値) | オン

[ゼロクロッシング検出を有効にする] パラメーターを選択すると、入力配列に同じ時間ヒットのエントリが複数含まれている場合に、Simulink^® はその時間のゼロクロッシングを検出します。たとえば、入力配列に次のようなデータがあるとします。

time:     0 1 2 2 3
signal:   2 3 4 5 6

時間 2 に入力信号の不連続によるゼロクロッシングがあります。詳細については、ゼロクロッシング検出を参照してください。

バス信号の場合、Simulink はすべてのリーフ バス要素にわたるゼロクロッシングを検出します。

指定した MAT ファイルが存在していなければなりません。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: ZeroCross

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

最後のデータ後の出力フォーム — データが使用可能な最後の時間ヒット後のブロック出力

Setting to zero (既定値) | Extrapolation | Holding final value

ワークスペース データが入手可能な最後の時間ヒット後のブロック出力を決定するには、以下のパラメーターの設定を組み合わせます。

• データを内挿する

• 最後のデータ後の出力フォーム

次の表で、この 2 つのオプションの値に基づくブロック出力を示します。

[最後のデータ後の出力フォーム] の設定	内挿データの設定	最終データの後のブロック出力
外挿	オン	最終データ値から外挿
	オフ	エラー
0 に設定	オン	0
	オフ	0
最終値を保持	オン	ワークスペースからの最終値
	オフ	ワークスペースからの最終値

たとえば、ブロックは最後の 2 つの既知のデータ点を使用して、次を実行した場合に最後の既知のデータ点の後に発生するデータ点を外挿します。

• [データを内挿する] を選択。

• [最後のデータ後の出力フォーム] を [外挿] に設定。

指定した MAT ファイルが存在していなければなりません。

依存関係

このパラメーターを有効にするには、指定した MAT ファイルが存在することを確認します。

プログラムでの使用

ブロック パラメーター: OutputAfterFinalValue

型: 文字ベクトル

値: 'Setting to zero' | 'Extrapolation' | 'Holding final value'

既定の設定: 'Setting to zero'

モデルの例

Parsim を使った並列シミュレーション: テストケース スイープ

この例では、SimulationInput オブジェクトと parsim コマンドの使用によって、Signal Editor ブロック内のさまざまなテスト ケースに対応する複数の Simulink® シミュレーションを実行する方法を示します。parsim コマンドは、Parallel Computing Toolbox™ が利用できる場合はこれを使用してシミュレーションを並列実行します。使用できない場合、シミュレーションは逐次実行されます。

モデルを開く

Parsim を使った並列シミュレーション: ラピッド アクセラレータ モードでのパラメーター スイープ

この例では、Parallel Computing Toolbox™ を使用して、モンテカルロ法のシミュレーションを複数並列して実行する方法を示します。並列実行はホスト マシンの複数のコアを活用して多くのシミュレーションの実行を高速化します。これらのシミュレーションは、MATLAB Parallel Server™ を使用し、コンピューター クラスターで並列に実行することもできます。この例は Parallel Computing Toolbox™ または MATLAB Parallel Server™ が利用できない場合でも機能しますが、シミュレーションは逐次実行されます。

モデルを開く

ブロックの特性

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

拡張機能

C/C++ コード生成

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

量産コードには推奨されません。

PLC コード生成
Simulink® PLC Coder™ を使用して構造化テキスト コードを生成します。

固定小数点の変換
Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

バージョン履歴

R2017b で導入

参考

Signal Builder | signalEditor | signalBuilderToSignalEditor | str2double

トピック

• Simulink.Bus オブジェクトの作成と指定
• 相互交換可能なシナリオでのデータの読み込み
• 信号データの作成と編集
• Migrate from Signal Builder Block to Signal Editor Block