Main Content

setUserData

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

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

    構文

    simOut = setUserData(simOut,userData)

    説明

    例

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

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

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    Simulink.SimulationOutput オブジェクトには、シミュレーションに関する情報を取得する Simulink.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");

    モデルをシミュレートします。

    simOut = sim(simIn);

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

    simOut = setUserData(simOut,simIn);

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

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

    シミュレーション メタデータを検査します。

    simMetadata = getSimulationMetadata(simOut)
    simMetadata = 
  SimulationMetadata with properties:

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

    入力引数

    すべて折りたたむ

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

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

    出力引数

    すべて折りたたむ

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

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

    バージョン履歴

    R2015a で導入

    参考

    オブジェクト

    関数