シミュレーションを高速化するための Simulink キャッシュファイルの共有

Simulink^® キャッシュファイルには、シミュレーションとコード生成を高速化するビルドアーティファクトが含まれています。これらのビルドアーティファクトを生成して Simulink キャッシュファイルに自動的にパッケージ化するには、次のいずれかのアクションを行います。

アクセラレータモードで参照されるモデルを含むモデルの階層構造のブロック線図を更新する
アクセラレータモードで参照されるモデルを含むモデルの階層構造のシミュレーションを行う
アクセラレータモードまたはラピッドアクセラレータモードで最上位モデルのシミュレーションを行う
モデルまたはモデルの階層構造のコードを生成する

これらのアクションを 2 回目に行うとき、Simulink は、[リビルド] コンフィギュレーションパラメーターが [変更が検出された場合] (既定) または [既知の依存関係で変更が検出された場合] に設定されている限り、古くなったファイルのみをビルドします。ビルドするファイルが少ないほど、アクションは高速で完了します。

メモ

[リビルド] コンフィギュレーションパラメーターを [行わない] に設定すると、すべての参照モデルのリビルドを回避できますが、この設定を使用することによって、無効なシミュレーション結果が生じることがあります。

チームのメンバーおよび継続的インテグレーション (CI) システムは、使用するモデルの Simulink キャッシュファイルを生成できます。これらのモデルを初めてビルドするときにかかる時間を削減するには、対応する Simulink キャッシュファイルを [シミュレーションキャッシュフォルダー] 基本設定で指定されたローカルフォルダーにコピーできます。Simulink は、ディスクにある内容と異なる Simulink キャッシュファイルの内容をすべて抽出します。Simulink がディスクにあるビルドアーティファクトを生成または更新する場合、対応する Simulink キャッシュファイルがローカルに更新されます。

Simulink キャッシュファイルは .slxc 拡張子で識別できます。ファイル名は対応するモデルの名前と一致します。

Simulink キャッシュファイルの内容の検証

Simulink キャッシュファイルには、次のものを含む複数のタイプのビルドアーティファクトが含まれている場合があります。

アクセラレータターゲット
ラピッドアクセラレータターゲット
モデル参照のシミュレーションターゲット
変数の使用情報
C および C++ コード生成ターゲット (Simulink Coder™、Embedded Coder^®)
PLC コード生成ターゲット (Simulink PLC Coder™) (R2025a 以降)
モデル表現 (Simulink Design Verifier™)
Web ビュー (Simulink Report Generator™)

Simulink キャッシュファイルは、複数のプラットフォームと Simulink のリリース向けのビルドアーティファクトを累積します。

特定の Simulink キャッシュファイルに含まれている内容を確認するには、ファイルをダブルクリックしてレポートを開きます。

Simulink cache report

または、Simulink キャッシュファイルの内容を MATLAB^® table に取得するには、関数 slxcinfo を使用します。たとえば、CounterAlgorithm という名前のモデルに対する Simulink キャッシュファイルがあるとします。

slxcinfo("CounterAlgorithm.slxc")

ans =

  3×5 table

          Model           Release     Platform                     Target                               Compiler           
    __________________    ________    ________    ________________________________________    _____________________________

    "CounterAlgorithm"    "R2025a"    "all"       "Variable usage information"                ""                           
    "CounterAlgorithm"    "R2025a"    "win64"     "Model reference simulation target"         "MinGW64 Compiler (C) v8.1.0"
    "CounterAlgorithm"    "R2025a"    "win64"     "grt | Model reference | Model specific"    "MinGW64 Compiler (C) v8.1.0"

使用するプラットフォーム、コンパイラ、およびリリースをサポートするビルドアーティファクトを再利用できます。一部のビルドアーティファクトではコンパイラは必要ありません。Windows^® マシン、MinGW^® コンパイラ、および R2025a の Simulink リリースを使用するとします。CounterAlgorithm の Simulink キャッシュファイルから、[R2025a : win64] の下のシミュレーションターゲットおよびコード生成ターゲットと、[R2025a : all platforms] の下の変数の使用情報を再利用できます。Linux^® マシンと R2025a を使用するチームのメンバーは、[R2025a : all platforms] の下の変数の使用情報のみを再利用できます。

Simulink キャッシュファイルは、作成されたリリースおよび以降のリリース用のビルドアーティファクトを累積します。Simulink キャッシュファイルを R2025a で作成するとします。その Simulink キャッシュファイルは R2024b では使用できません。

Simulink キャッシュファイルの使用

ほとんどのチームが Simulink キャッシュファイルを使用することでメリットを享受できますが、次の特徴をもつ開発環境が Simulink キャッシュファイルの使用に最も適しています。

多くの参照モデルを含むモデルの階層構造。
アクセラレータモードまたはラピッドアクセラレータモードでシミュレーションを実行する最上位モデル。これにより Simulink が、最上位モデルとすべての参照モデルのシミュレーションターゲットを生成する。
開発チーム全体に用意された、標準化されたプラットフォーム、コンパイラ、Simulink リリース。
開発チーム全体に用意された、[インクルードディレクトリ] コンフィギュレーションパラメーターで指定する相対パスまたは一貫性のある絶対パス。
設計ファイルを管理する Git™ のようなソース管理システム。MATLAB での Gitを参照してください。
メモ
Simulink キャッシュファイルは派生ファイルであるため、ソース管理下で管理すべきではありません。Simulink キャッシュファイルをソース管理システムに保存して共有しても、これらのファイルの異なるバージョンを比較またはマージすることはできません。
並列ワーカーのプールを使用してモデルの階層構造の最新バージョンを定期的にビルドする、Jenkins^® のような CI システム。
メモ
カスタムコードを使用するシミュレーションおよびコード生成ターゲットに対して不要なリビルドを回避するには、チームのメンバーのサンドボックスで同じ名前のボリュームまたはシンボリックリンクに CI システムディレクトリをマッピングします。たとえば、CI システムとチームのメンバーに B:\path\customcode などのマッピングされたディレクトリでカスタムコードを保存してもらいます。

この開発環境で、ソース管理システム内のファイルを操作してアーカイブをビルドします。

Workflow with source control system, CI system, and build archive. The CI system pulls design changes from the source control system and archives Simulink cache files in the build archive.

シミュレーションターゲットを更新するために費やす時間の量を削減するには、以下の手順に従います。

すべての設計ファイルの最新バージョンをソース管理システムから引き出します。
すべての Simulink キャッシュファイルの最新バージョンをビルドアーカイブからコピーして、[シミュレーションキャッシュフォルダー] に配置します。
最上位のモデルを開いて、そのモデルのシミュレーションを実行します。
Simulink は、必要なビルドアーティファクトを Simulink キャッシュファイルから抽出します。シミュレーションは、CI システムによって完了した最新のビルド以降モデルに変更が加えられていない限り、一切のモデルをリビルドすることなく完了します。
メモ
更新、シミュレーション、モデルの階層構造向けのコード生成を行うことなく、Simulink キャッシュファイルからシミュレーションターゲットとコード生成ターゲットをアンパックするには、関数 slxcunpack を使用します。
モデルを変更して、もう一度モデルの階層構造のシミュレーションを実行します。
Simulink は必要なモデルをリビルドして、対応する Simulink キャッシュファイルのローカルコピーを更新します。
更新されたモデルをソース管理システムにコミットします。派生ファイルである Simulink キャッシュファイルはコミットしません。

プロジェクトの Simulink キャッシュファイルのチェック

プロジェクトを最上位モデルから作成する場合、プロジェクトにはモデルおよびその参照モデルに対応する Simulink キャッシュファイルが含まれます。

モデルの階層構造内の Simulink キャッシュファイルの依存関係を表示するには、MATLAB ツールストリップの [プロジェクト] タブの [ツール] ギャラリーで、[依存関係アナライザー] をクリックします。

Dependency Analyzer results for sldemo_mdlref_depgraph, including Simulink cache files

詳細については、プロジェクトによる影響分析の実行を参照してください。

参考

slxcinfo | slxcunpack