find

Simulink.SimulationOutput オブジェクト内のシミュレーション結果のクエリ

構文

res = find(simOut,varName)

説明

res = find(simOut,varName) は varName で指定されたシミュレーションデータを Simulink.SimulationOutput オブジェクト simOut から返します。オブジェクト内に varName という名前のプロパティが存在しない場合、戻り値は空になります。

関数 get を使用するか、ドットを使用してプロパティとしてデータにアクセスすることによって Simulink.SimulationOutput オブジェクト内のデータにアクセスすることもできます。

例

すべて折りたたむ

単一のシミュレーション出力としてログ記録されたデータへのアクセス

ライブスクリプトを開く

シミュレーション結果が単一の出力オブジェクトとして返される場合は、Simulink.SimulationOutput オブジェクトを使用して、すべてのログデータおよびシミュレーションメタデータにアクセスできます。

この例のモデルでは [単一のシミュレーション出力] パラメーターが有効になっており、いくつかの異なるログ記録方法を使用してデータをログに記録します。

Sine Wave ブロックの出力は、信号のログを使用してログに記録されます。
Gain ブロックの出力は、To Workspace ブロックを使用してログに記録されます。
Gain ブロック、Chirp Signal ブロック、Square Wave Generator ブロックの出力は、Record ブロックを使用してログに記録されます。
Square Wave Generator ブロックの出力は、出力ログを使用してログに記録されます。

モデルは時間データを記録するようにも設定されます。

モデルを開きます。

mdl = "LoggingBlocks";
open_system(mdl)

Simulink.SimulationInput オブジェクトを作成してシミュレーションをモデル用に構成します。関数 setModelParameter を使用して StopTime パラメーターを 20 に設定します。

simIn = Simulink.SimulationInput(mdl);
simIn = setModelParameter(simIn,'StopTime','20');

モデルをシミュレートします。関数 sim の出力 out は、シミュレーションからログに記録されるすべてのデータが含まれる Simulink.SimulationOutput オブジェクトです。ブロックごと、ログのタイプごとのデータは、ブロックまたはモデルで指定されているログ変数の名前と一致するプロパティとして保存されます。

out = sim(simIn);

ログデータには、ドット、関数 get、または関数 find を使用してアクセスできます。それぞれの方法は、ログ変数名に基づいて動作するため、任意の方法を使用して任意の種類のログデータにアクセスすることができます。

ドットを使用して、To Workspace ブロックを使用してログ記録された Big Sine 信号にアクセスします。

simout = out.simout

  timeseries

  Common Properties:
            Name: 'Big Sine'
            Time: [51x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [51x1 double]
        DataInfo: tsdata.datametadata

関数 get を使用して、信号ログを使用してログ記録された Sine 信号にアクセスします。

logsout = get(out,"logsout")

logsout = 
Simulink.SimulationData.Dataset 'logsout' with 1 element

                         Name  BlockPath               
                         ____  _______________________ 
    1  [1x1 Signal]      Sine  LoggingBlocks/Sine Wave

  - Use braces { } to access, modify, or add elements using index.

関数 find を使用して、出力ログを使用してログ記録された Square Wave 信号にアクセスします。

yout = find(out,"yout")

yout = 
Simulink.SimulationData.Dataset 'yout' with 1 element

                         Name         BlockPath             
                         ___________  _____________________ 
    1  [1x1 Signal]      Square Wave  LoggingBlocks/Outport

  - Use braces { } to access, modify, or add elements using index.

シミュレーションメタデータには、ドットまたは関数 getSimulationMetadata を使用してアクセスできます。

simMetadata = getSimulationMetadata(out)

simMetadata = 
  SimulationMetadata with properties:

        ModelInfo: [1x1 struct]
       TimingInfo: [1x1 struct]
    ExecutionInfo: [1x1 struct]
       UserString: ''
         UserData: []

シミュレーションメタデータは Simulink.SimulationMetadata オブジェクトとして返されます。SimulationMetadata オブジェクトは、シミュレーションに関する情報を構造体値をもつプロパティにグループ化し、シミュレーションに関連する string および追加データを指定できるプロパティをもちます。

SimulationMetadata オブジェクト上の ExecutionInfo プロパティにアクセスします。実行情報には、シミュレーションが停止時間 20 まで警告やエラーなしで実行されたことが示されます。

simMetadata.ExecutionInfo

ans = struct with fields:
               StopEvent: 'ReachedStopTime'
         StopEventSource: []
    StopEventDescription: 'Reached stop time of 20'
         ErrorDiagnostic: []
      WarningDiagnostics: [0x1 struct]

入力引数

すべて折りたたむ

`simOut` — シミュレーション結果
`Simulink.SimulationOutput` オブジェクト

シミュレーション結果。Simulink.SimulationOutput オブジェクトとして指定します。

`varName` — 返されるシミュレーションデータ
string | 文字ベクトル

返されるシミュレーションデータ。string または文字ベクトルとして指定します。

関数 find を使用して、ログ変数の名前を指定することにより、シミュレーションからログ記録されたデータ (信号ログデータ、ログ出力、状態など) にアクセスします。たとえば、既定の信号ログ変数名 logsout を使用するときは、"logsout" と指定して信号ログデータにアクセスします。

例: "logsout"

データ型: char | string