Simulink.sdi.addTrigger

シミュレーションデータインスペクターで表示の更新を制御するトリガーを信号に追加する

構文

Simulink.sdi.addTrigger(sig)

Simulink.sdi.addTrigger(sig,Name,Value)

説明

Simulink.sdi.addTrigger(sig) はノーマルモードおよび自動レベルを使用した立ち上がりエッジトリガーを、Simulink.sdi.Signal オブジェクト sig に追加します。トリガーは、信号のストリーミング用の新しいデータを表示するためにシミュレーションデータインスペクターのプロットが更新されるタイミングを決定します。

Simulink.sdi.addTrigger(sig,Name,Value) は、1 つ以上の名前と値のペアの引数によって指定されたトリガー設定をもつ指定された信号にトリガーを追加します。たとえば、'Mode','Normal' はトリガーのノーマルモード動作を構成します。シミュレーションデータインスペクターのトリガーは、Scope ブロックのトリガーと同じように動作します。トリガータイプと設定の詳細については、Scope Triggersを参照してください。

例

すべて折りたたむ

シミュレーションデータインスペクターでのプログラムによるトリガーの構成

ライブスクリプトを開く

シミュレーションデータインスペクターの信号にトリガーを追加し、新しいデータを表示するためにプロットを更新するタイミングを決定する基準を指定します。トリガーにより過渡信号の動作を取得し、周期信号の表示を安定させて測定を行うことができます。

Triggers モデルのシミュレーションを実行します。モデル内のデータはシミュレーションデータインスペクターに記録されます。

open_system('Triggers');
out = sim('Triggers');

次に、トリガーを Pulse 信号に追加します。トリガーを 0.5 のしきい値をもつ立ち下がりエッジトリガーとして構成します。

trigRun = Simulink.sdi.getCurrentSimulationRun('Triggers');
pulseSig = getSignalsByName(trigRun,'Pulse');
Simulink.sdi.addTrigger(pulseSig,'Type','Edge','Level',0.5);

Simulink.sdi.view を使用してシミュレーションデータインスペクターを開き、Pulse 信号の横にあるトリガーアイコンをクリックして構成を確認することにより、このトリガーが追加され、正しく構成されていることを確認できます。関数 Simulink.sdi.getTrigger を使用して、トリガーイベントおよびトリガー構成の生成に使用される信号を確認することもできます。

[sig,trigOpts] = Simulink.sdi.getTrigger;

sig.Name

ans = 
'Pulse'

trigOpts

trigOpts = struct with fields:
                       Mode: 'Auto'
                       Type: 'Edge'
                   Position: 0.5000
                      Delay: 0
    SourceChannelComplexity: 'Scalar'
                   Polarity: 'Positive'
                  AutoLevel: 1
                      Level: 0.5000
                 UpperLevel: 0
                 LowerLevel: 0
                 Hysteresis: 0
                    MinTime: 0
                    MaxTime: Inf
                    Timeout: 0
                    Holdoff: 0

シミュレーションデータインスペクターが新しいデータでプロットを更新するタイミングを制御するためにトリガーを使用しない場合は、関数 Simulink.sdi.removeTrigger を使用してトリガーを削除できます。

Simulink.sdi.removeTrigger

シミュレーションデータインスペクターの UI または関数 Simulink.sdi.getTrigger を使用して、トリガーが削除されたことを確認できます。関数 Simulink.sdi.getTrigger は、シミュレーションデータインスペクターで構成されているトリガーがない場合に、Simulink.sdi.Signal オブジェクトの空の配列を返します。

sig = Simulink.sdi.getTrigger;
size(sig)

ans = 1×2

     0     0

入力引数

すべて折りたたむ

`sig` — トリガーイベントの検出に使用される信号
`Simulink.sdi.Signal` オブジェクト

トリガーイベントの検出に使用される信号。Simulink.sdi.Signal オブジェクトとして指定します。

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: 'Type','PulseWidth','Polarity','Falling' は立ち下がりエッジの自動レベルのトリガーを自動モードで構成します。

`Mode` — トリガーイベントに応答して表示が更新されるタイミング
`Auto` (既定値) | `Normal` | `Once`

トリガーイベントに応答して表示が更新されるタイミング。'Mode' と次のいずれかのオプションで構成されるコンマ区切りのペアとして指定します。

Auto — 各トリガーイベントに応答してプロットは更新され、表示される時間範囲にわたりトリガーイベントが発生しない場合、プロットは更新されます。
Normal — 各トリガーイベントに応答してプロットは更新されます。
Once — 最初のトリガーイベントに応答してプロットは更新されます。シミュレーションデータインスペクターを使用してトリガーを手動でリセットできます。

例: 'Mode','Normal' はノーマルモードを使用するようにトリガーを構成します。

`Position` — トリガーイベントがプロットに表示される場所
`50` (既定値) | 数値のパーセンテージ

トリガーイベントがプロットに表示される場所。'Position' と数値のパーセンテージで構成されるコンマ区切りのペアとして指定します。既定の設定では、トリガーイベントは、0.5 の位置、または時間範囲内の 50% の位置で、プロットの中央に表示されます。

例: 'Position',.3 はトリガーイベントを時間範囲内の 30% の位置に配置します。

`Type` — 信号に追加するトリガーのタイプ
`Edge` (既定値) | `PulseWidth` | `Transition` | `Runt` | `Window` | `Timeout`

信号に追加するトリガーのタイプ。'Type' と次のいずれかのオプションで構成されるコンマ区切りのペアとして指定します。

Edge — 信号がしきい値を横切るときにトリガーします。
PulseWidth — 指定した時間内に信号が下方しきい値と上方しきい値間を 2 回横切るときにトリガーします。
Transition — 指定した時間内に信号が上方しきい値と下方しきい値を横切るときにトリガーします。
Runt — 指定した時間内に信号が下方しきい値または上方しきい値を 2 回横切るときにトリガーします。
Window — 上方しきい値と下方しきい値で定義される範囲の内部または外部に信号が指定した期間とどまったときにトリガーします。
Timeout — 信号が指定した時間より長い間しきい値より高いまたは低い状態を維持したときにトリガーします。

トリガーの各タイプに対するオプションの詳細については、Scope Triggersを参照してください。

例: 'Type','PulseWidth' はパルス幅トリガーを構成します。

`Polarity` — トリガーイベントを発生させる信号値の方向の変更
トリガータイプの有効な極性

トリガーイベントを発生させる信号値の方向の変更。'Polarity' とトリガータイプに対する有効な極性で構成されるコンマ区切りのペアとして指定します。

トリガータイプ	極性オプション
`Edge`	`Rising` — 信号が値を増加しながらしきい値を横切るときにトリガーします。 `Falling` — 信号が値を減少しながらしきい値を横切るときにトリガーします。 `Either` — 信号が値を増加または減少しながらしきい値を横切るときにトリガーします。
`PulseWidth`	`Positive` — 信号が下方しきい値を 2 回目に横切ったときに立ち上がりパルスでトリガーします。 `Negative` — 信号が上方しきい値を 2 回目に横切ったときに立ち下がりパルスでトリガーします。 `Either` — 立ち上がりパルスと立ち下がりパルスの両方でトリガーします。
`Transition`	`RiseTime` — 指定した時間内に信号が増加して下方しきい値から上方しきい値を横切ったときにトリガーします。 `FallTime` — 指定した時間内に信号が減少して上方しきい値から下方しきい値を横切ったときにトリガーします。 `Either` — 指定した時間内に信号が増加または減少して下方しきい値と上方しきい値を横切ったときにトリガーします。
`Runt`	`Positive` — 信号が上方しきい値を横切ることなく、下方しきい値を 2 回目に横切ったときに立ち上がりパルスでトリガーします。 `Negative` — 信号が下方しきい値を横切ることなく、上方しきい値を 2 回目に横切ったときに立ち下がりパルスでトリガーします。 `Either` — 指定した値のしきい値内にとどまった立ち上がりパルスまたは立ち下がりパルスでトリガーします。
`Window`	`Inside` — 信号が `MinTime` と `MaxTime` 間にわたり、指定した値の範囲内にとどまったときにトリガーします。トリガーイベントは信号が指定された値の範囲を出るときに発生します。 `Outside` — 信号が `MinTime` と `MaxTime` 間にわたり、指定された値の範囲外にあるときにトリガーします。トリガーイベントは信号が指定された値の範囲に再び入ると発生します。 `Either` — 信号が `MinTime` と `MaxTime` 間にわたり、指定された値の範囲内または範囲外にあるときにトリガーします。
`Timeout`	`Rising` — 信号が指定された時間より長い間しきい値より高い状態を維持したときにトリガーします。 `Falling` — 信号が指定された時間より長い間しきい値より低い状態を維持したときにトリガーします。 `Either` — 信号が指定された時間より長い間しきい値より高いまたは低い状態を維持したときにトリガーします。

例: 'Type','Edge','Polarity','Rising' は立ち上がりエッジトリガーを構成します。

`AutoLevel` — 自動的にトリガーレベルを決定するかどうか
`true` または `1` (既定値) | `false` または `0`

自動的にトリガーレベルを決定するかどうか。'AutoLevel' および true または false で構成されるコンマ区切りのペアとして指定します。

トリガーのしきい値を指定する場合は、'AutoLevel' を false として指定します。

例: 'AutoLevel',false はユーザー指定レベルを使用するようにトリガーを構成します。

`Level` — トリガーイベントのしきい値
数値スカラー

トリガーイベントのしきい値。'Level' と数値スカラーで構成されるコンマ区切りのペアとして指定します。

'Level' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'Edge' または 'Timeout' として指定する場合のみです。

例: 'Type','Timeout','Level','0.5' は 0.5 のしきい値をもつタイムアウトトリガーを構成します。

`Hysteresis` — トリガーイベントを発生させるためにしきい値の前後で必要な信号値の変化
数値スカラー

トリガーイベントを発生させるためにしきい値の前後で必要な信号値の変化。'Hysteresis' と数値スカラーで構成されるコンマ区切りのペアとして指定します。トリガーに対してヒステリシスを指定すると、トリガーイベントに対するノイズ除去が発生します。

'Hysteresis' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'Edge' または 'Timeout' として指定する場合のみです。

例: 'Type','Timeout','Hysteresis','0.05' はトリガーイベントを発生させるためにしきい値の前後で信号値が 0.05 を超えて変化する必要があるタイムアウトトリガーを構成します。

`UpperLevel` — トリガーイベントの上限しきい値
数値スカラー

トリガーイベントの上限しきい値。'UpperLevel' と数値スカラーで構成されるコンマ区切りのペアとして指定します。

'UpperLevel' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'PulseWidth'、'Transition'、'Runt'、または 'Window' として指定する場合のみです。

例: 'Type','PulseWidth','UpperLevel','0.9' は 0.9 の上限しきい値をもつパルス幅トリガーを構成します。

`LowerLevel` — トリガーイベントの下限しきい値
数値スカラー

トリガーイベントの下限しきい値。'LowerLevel' と数値スカラーで構成されるコンマ区切りのペアとして指定します。

'LowerLevel' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'PulseWidth'、'Transition'、'Runt'、または 'Window' として指定する場合のみです。

例: 'Type','PulseWidth','LowerLevel','0.1' は 0.1 の下限しきい値をもつパルス幅トリガーを構成します。

`MinTime` — トリガーイベントの時間の下限
数値スカラー

トリガーイベントの時間の下限。'MinTime' と数値スカラーで構成されるコンマ区切りのペアとして指定します。'MinTime' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'PulseWidth'、'Transition'、'Runt'、または 'Window' として指定する場合のみです。時間の下限の重要性はトリガーのタイプによって異なります。

'PulseWidth' — トリガーイベントの最小パルス幅。
'Transition' — トリガーイベントの最小立ち上がり時間または最小立ち下がり時間。
'Runt' — トリガーイベントの最小パルス幅。
'Window' — トリガーイベントの値の範囲内または範囲外で費やされた最小時間。

例: 'Type','PulseWidth','MinTime','0.1' は 100ms の最小パルス幅をもつパルス幅トリガーを構成します。

`MaxTime` — トリガーイベントの時間の上限
数値スカラー

トリガーイベントの時間の上限。'MaxTime' と数値スカラーで構成されるコンマ区切りのペアとして指定します。'MaxTime' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'PulseWidth'、'Transition'、'Runt'、または 'Window' として指定する場合のみです。時間の上限の重要性はトリガーのタイプによって異なります。

'PulseWidth' — トリガーイベントの最大パルス幅。
'Transition' — トリガーイベントの最大立ち上がり時間または立ち下がり時間。
'Runt' — トリガーイベントの最大パルス幅。
'Window' — トリガーイベントの値の範囲内または範囲外で費やされた最大時間。

例: 'Type','PulseWidth','MaxTime','0.5' は 500ms の最大パルス幅をもつパルス幅トリガーを構成します。

`Timeout` — タイムアウトトリガーの時間のしきい値
数値スカラー

タイムアウトトリガーの時間のしきい値。'Timeout' と数値スカラーで構成されるコンマ区切りのペアとして指定します。

'Timeout' の名前と値のペアを指定できるのは、'Type' の名前と値のペアを 'Timeout' として指定する場合のみです。

例: 'Type','Timeout','Timeout','0.5' は信号が 500ms より長い間しきい値より高いまたは低い状態を維持したときにイベントを発生させるタイムアウトトリガーを構成します。

`Delay` — トリガー位置からのトリガーイベントオフセット
数値スカラー

トリガー位置からのトリガーイベントオフセット。'Delay' と数値スカラーで構成されるコンマ区切りのペアとして指定します。

例: 'Type','Edge','Delay','0.1' はトリガーイベントの後にトリガー位置マーカーが 100ms に表示されるエッジトリガーを構成します。

`Holdoff` — トリガーイベント間の最小時間
数値スカラー

トリガーイベント間の最小時間。'Holdoff' と数値スカラーで構成されるコンマ区切りのペアとして指定します。トリガーイベントの後、少なくともホールドオフ時間の間、表示は再び更新されません。

例: 'Type','Edge','Holdoff','1' は 1s のホールドオフをもつエッジトリガーを構成します。トリガーイベントの後、少なくとも 1s の間、表示は更新されません。

代替機能

トリガーを信号に追加して、シミュレーションデータインスペクター UI を使用してトリガーオプションを構成できます。詳細については、トリガーを使用したデータストリーミングの表示の制御を参照してください。

バージョン履歴

R2020b で導入

参考

オブジェクト

Simulink.sdi.Signal | Simulink.sdi.Run

関数

getSignalsByName | getSignalByIndex | Simulink.sdi.getSignal | Simulink.sdi.getTrigger | Simulink.sdi.removeTrigger

Simulink.sdi.addTrigger

構文

説明

例

シミュレーション データ インスペクターでのプログラムによるトリガーの構成

入力引数

sig — トリガーイベントの検出に使用される信号 Simulink.sdi.Signal オブジェクト

名前と値の引数

Mode — トリガー イベントに応答して表示が更新されるタイミング Auto (既定値) | Normal | Once

Position — トリガー イベントがプロットに表示される場所 50 (既定値) | 数値のパーセンテージ

Type — 信号に追加するトリガーのタイプ Edge (既定値) | PulseWidth | Transition | Runt | Window | Timeout

Polarity — トリガー イベントを発生させる信号値の方向の変更 トリガー タイプの有効な極性

AutoLevel — 自動的にトリガー レベルを決定するかどうか true または 1 (既定値) | false または 0

Level — トリガー イベントのしきい値 数値スカラー

Hysteresis — トリガー イベントを発生させるためにしきい値の前後で必要な信号値の変化 数値スカラー

UpperLevel — トリガー イベントの上限しきい値 数値スカラー

LowerLevel — トリガー イベントの下限しきい値 数値スカラー

MinTime — トリガー イベントの時間の下限 数値スカラー

MaxTime — トリガー イベントの時間の上限 数値スカラー

Timeout — タイムアウト トリガーの時間のしきい値 数値スカラー

Delay — トリガー位置からのトリガー イベント オフセット 数値スカラー

Holdoff — トリガー イベント間の最小時間 数値スカラー

代替機能

バージョン履歴

参考

オブジェクト

関数

トピック

シミュレーションデータインスペクターでのプログラムによるトリガーの構成

`sig` — トリガーイベントの検出に使用される信号
`Simulink.sdi.Signal` オブジェクト

`Mode` — トリガーイベントに応答して表示が更新されるタイミング
`Auto` (既定値) | `Normal` | `Once`

`Position` — トリガーイベントがプロットに表示される場所
`50` (既定値) | 数値のパーセンテージ

`Type` — 信号に追加するトリガーのタイプ
`Edge` (既定値) | `PulseWidth` | `Transition` | `Runt` | `Window` | `Timeout`

`Polarity` — トリガーイベントを発生させる信号値の方向の変更
トリガータイプの有効な極性

`AutoLevel` — 自動的にトリガーレベルを決定するかどうか
`true` または `1` (既定値) | `false` または `0`

`Level` — トリガーイベントのしきい値
数値スカラー

`Hysteresis` — トリガーイベントを発生させるためにしきい値の前後で必要な信号値の変化
数値スカラー

`UpperLevel` — トリガーイベントの上限しきい値
数値スカラー

`LowerLevel` — トリガーイベントの下限しきい値
数値スカラー

`MinTime` — トリガーイベントの時間の下限
数値スカラー

`MaxTime` — トリガーイベントの時間の上限
数値スカラー

`Timeout` — タイムアウトトリガーの時間のしきい値
数値スカラー

`Delay` — トリガー位置からのトリガーイベントオフセット
数値スカラー

`Holdoff` — トリガーイベント間の最小時間
数値スカラー