setUserData

Simulink.SimulationOutput オブジェクト内のメタデータに対するデータの追加

ページ内をすべて折りたたむ

    構文

    simOut = setUserData(simOut,userData)

    説明

    simOut = setUserData(simOut,userData) は、Simulink.SimulationOutput オブジェクト simOut に保存されているシミュレーション メタデータにデータ userData を追加します。

    この関数を使用して、Simulink.SimulationOutput オブジェクトを作成したシミュレーションに関する詳細を追加します。たとえば、シミュレーションで使用したモデル コンフィギュレーション パラメーターの値をいくつか追加することができます。

    例

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    Simulink.SimulationOutput オブジェクトの SimulationMetadata プロパティには、Simulink.SimulationMetadata オブジェクトとして格納されたシミュレーション メタデータが含まれます。シミュレーションに関する追加情報は、SimulationMetadata オブジェクトの UserData プロパティおよび UserString プロパティで指定できます。たとえば、シミュレーションの構成に使用した Simulink.SimulationInput オブジェクトを UserData プロパティで保存したり、シミュレーションの目的、構成、結果の説明として UserString を指定したりできます。

    モデル ex_sldemo_bounce を開きます。このモデルは、跳ねるボールの動きを初期速度に基づいてシミュレートします。

    mdl = "ex_sldemo_bounce";
open_system(mdl)

    Simulink.SimulationInput オブジェクトを作成してモデルのシミュレーションを構成します。関数 setBlockParameter を使用して、初期速度を 20 と指定します。

    simin = Simulink.SimulationInput(mdl);
simin = setBlockParameter(simin,"ex_sldemo_bounce/Initial Velocity",...
    "Value","20");

    モデルのシミュレーションを実行します。

    out = sim(simin);

    関数 setUserData を使用して、シミュレーション メタデータに Simulink.SimulationInput オブジェクトを追加します。

    out = setUserData(out,simin);

    関数 setUserString を使用して、シミュレーションの説明を追加します。

    out = setUserString(out,"Initial Velocity = 20");

    シミュレーション メタデータを確認します。UserString プロパティと UserData プロパティに、setUserString 関数と setUserData 関数を使用して指定された値が含まれています。

    simmetadata = out.SimulationMetadata
    simmetadata = 
  SimulationMetadata with properties:

        ModelInfo: [1×1 struct]
       TimingInfo: [1×1 struct]
    ExecutionInfo: [1×1 struct]
       UserString: "Initial Velocity = 20"
         UserData: [1×1 Simulink.SimulationInput]

    入力引数

    すべて折りたたむ

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

    シミュレーション メタデータに追加するデータ。MATLAB 変数または MATLAB 式として指定します。

    出力引数

    すべて折りたたむ

    ユーザー データを含むシミュレーション結果。Simulink.SimulationOutput オブジェクトとして返されます。SimulationOutput オブジェクトは、シミュレーション メタデータを Simulink.SimulationMetadata オブジェクトとして保存します。指定するデータは、Simulink.SimulationMetadata オブジェクトの UserData プロパティに追加されます。

    simMetadata = simOut.SimulationMetadata;
userData = simMetadata.UserData;

    バージョン履歴

    R2015a で導入

    参考

    オブジェクト

    関数