setUserString

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

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

    構文

    simOut = setUserString(simOut,str)

    説明

    simOut = setUserString(simOut,str) は、Simulink.SimulationOutput オブジェクト simOut に保存されているメタデータにテキスト str を追加します。

    この関数を使用すると、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 オブジェクトとして指定します。

    メタデータに追加するテキスト。string または文字ベクトルとして指定します。

    データ型: char | string

    出力引数

    すべて折りたたむ

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

    simMetadata = simOut.SimulationMetadata;
userString = simMetadata.UserString;

    バージョン履歴

    R2015a で導入

    参考

    オブジェクト

    関数