Simulink.saveVars
(非推奨) MATLAB コード形式でワークスペース変数とその値を保存
Simulink.saveVars
は推奨されません。代わりに matlab.io.saveVariablesToScript
を使用してください。
構文
説明
Simulink.saveVars(
は、MATLAB® コードの生成が可能な現在のワークスペース内のすべての変数を filename
)filename.m
という MATLAB ファイルに保存します。ある変数の MATLAB コードの生成が不可能な場合、この変数は filename.mat
というコンパニオン MAT ファイルに保存され、警告が生成されます。どちらのファイルの場合も、既存のファイルは上書きされます。ファイル名は、現在のワークスペース内のどの変数の名前とも同じにすることができず、オプションで接尾辞 .m
を付けることができます。Simulink.saveVars
を使用しても、ワークスペースの内容には影響がまったくありません。
MATLAB ファイルを実行すると、このファイルに保存されている変数が現在のワークスペースに復元されます。コンパニオン MAT ファイルが存在する場合は、MATLAB ファイル内のコードによって MAT ファイルが読み込まれ、その変数も復元されます。MATLAB ファイルと MAT ファイルの両方が存在するときは、MAT ファイルが利用可能な場合を除き、MATLAB ファイルを読み込まないでください。読み込むと、エラーが発生します。MAT ファイルを直接読み込まないでください。直接読み込むと、データが完全に復元されません。ファイルの読み込みによって既存の変数が上書きされない場合、警告は表示されません。
Simulink.saveVars
によって作成された MATLAB ファイルは編集できます。保存された変数の MATLAB コード セクション間またはセクション内に、コメントを挿入することが可能です。ただし、後で Simulink.saveVars
を使用してファイルを更新したり、ファイルに追加したりした場合は、MATLAB コード セクション間のコメントしか維持されません。したがって、後で変更することを予定していないファイルでしか、内部コメントを使用すべきではありません。
MATLAB ファイル内の、最初の 5 つのコメント行を構成するヘッダー セクションは編集しないでください。Simulink® は、手動で編集された MATLAB ファイルが構文的に正しいかどうかをチェックしません。ファイル内のいずれの MATLAB コードも編集しないでください。MAT ファイルは編集不可能であり、編集しようと試みるべきではありません。
Simulink.saveVars(
は、filename
, var1,...,varN
)var1,...,varN
で指定された変数のみを保存します。ワイルドカード文字 *
を使って、パターンの一致する変数をすべて保存できます。*
は、英数字以外の文字を含む、1 つ以上の文字と一致します。
Simulink.saveVars(
は、filename
,___, UpdateOption
)UpdateOption
の指定に基づいて変数を保存します。
Simulink.saveVars(
は、指定されたコンフィギュレーション オプションに従って変数を保存します。filename
,___, Configuration
)
例
入力引数
出力引数
制限
関数 Simulink.saveVars
には、次のような制限事項があります。
共有される参照を維持しない。
オブジェクトの動的プロパティを無視する。
以下の項目を MAT ファイルに保存するが、これらの項目は MATLAB ファイルに表示される可能性がある
カスタムのターゲット コンポーネントをもつ
Simulink.ConfigSet
オブジェクト
(Simulink.ConfigSet
メソッドsaveAs
を代わりに使用します)
オブジェクトとSimulink.Timeseries
オブジェクト。Simulink.ModelDataLogs
多くの変数を保存する場合、生成される MATLAB ファイルには多くの行数のコードが含まれるため、実行に時間がかかる可能性があります。実行時間が長くなるのを避けるため、次の代替方法を検討してください。
Simulink.saveVars
を使用する代わりにデータ ディクショナリに変数を永続的に保存する。データ ディクショナリでは変数を管理するためのツールがさらに提供されます。Simulink モデルの変数とオブジェクトの保存場所の決定を参照してください。関数
save
を使用して MAT ファイルに変数を保存する。
ヒント
容易に理解できる形式で変数を保存する必要がない場合は、関数
save
を参照してください。バス オブジェクトだけを保存する必要がある場合は、関数
Simulink.Bus.save
を使用してください。コンフィギュレーション セットだけを保存する必要がある場合は、メソッド
Simulink.ConfigSet
.saveAs
を使用してください。
バージョン履歴
R2010a で導入