アクセラレータモードのプログラムによる操作

プログラムで操作する理由

高速化されたモデルを作成し、シミュレーションモードを選択し、シミュレーションをプログラムによって実行できます。この柔軟性によって、バッチモードでアクセラレータモードの MEX ファイルを作成できるため、シミュレーションを実行する前に C コードと実行ファイルを作成できます。後でアクセラレータモードを対話形式で使用する場合は、高速化されたシミュレーションの最初に、MEX ファイルを生成またはコンパイルする必要はありません。

JIT アクセラレータ実行エンジンの作成

accelbuild コマンドを使用して、モデルのシミュレーションを実際に行わずに JIT アクセラレータ実行エンジンを作成できます。たとえば、myModel のアクセラレータモードのシミュレーションを作成するには、次のようにします。

accelbuild myModel

シミュレーションのコントロール

set_param コマンドを使用すると、プログラムによってシミュレーションモードを制御できます。

set_param('modelname','SimulationMode','mode')

シミュレーションモードは、normal、accelerator、rapid、または external のいずれかです。

たとえば、アクセラレータモードを使用してモデルをシミュレートするには、次を使用します。

set_param('myModel','SimulationMode','accelerator')

ただし、関数 sim を使用してシミュレーションモードを指定する方法をお勧めします。

simOut = sim('myModel','SimulationMode','accelerator');

モデル名を明示的に指定しない場合は、bdroot を使用すると、modelname でなく現在アクティブなモデル (つまり、アクティブなモデルウィンドウ) のパラメーターを設定できます。

たとえば、ラピッドアクセラレータモードを使用して現在開いているシステムをシミュレートするには、次を使用します。

simOut = sim(bdroot,'SimulationMode','rapid');

モデルのシミュレート

set_param を使用すると、シミュレーションモードや終了時刻などのモデルパラメーターを構成でき、sim コマンドを使用すると、シミュレーションを開始できます。

sim('modelname','ReturnWorkspaceOutputs','on');

ただし、前の節で説明したように、sim コマンドを使用してモデルパラメーターを直接構成する方法をお勧めします。

モデル名を明示的に指定しない場合は、modelname の代わりに gcs を使用します。

ターゲットコードがまだ生成されていない限り、関数 sim は最初に実行ファイルを作成してから、シミュレーションを実行します。ただし、ターゲットコードが既に生成され、モデルに重大な変更が行われていない場合 (詳細については、高速化されたモデルでのコードの再生成を参照)、関数 sim はコードを再生成せずに、生成されたコードを実行します。このプロセスによって、モデルのリビルドを待つことなく簡単な変更を行った後でモデルを実行できます。

シミュレーションの例

次のコマンドは、ラピッドアクセラレータモードで 10,000 秒間 myModel をプログラムでシミュレートする方法を示します。

最初に myModel を開いてから、コマンドウィンドウに以下のコマンドを入力します。

simOut = sim('myModel','SimulationMode','rapid', ...
'StopTime','10000');

モデルに変更を行った後でシミュレートするには、関数 sim をもう一度使用します。マイナーな変更 (Gain ブロックのゲインを調整するなど) を行う場合は、シミュレーションはコードを再生成せずに実行されます。

高速化のためのビルドプロセスのカスタマイズ

アクセラレータモードとラピッドアクセラレータモードのビルドプロセスと表示する情報量をビルドプロセス中にプログラムで制御できます。この操作を実行する利点の詳細は、ビルドプロセスのカスタマイズを参照してください。

ビルドプロセスの制御

SimCompilerOptimization を使用して、高速化のためにコード生成時にコンパイラによって使用される最適化の度合いを設定します。入力可能な値は、on または off です。既定の設定は off です。

コンパイラの最適化をオンにするには、コマンドウィンドウで次のように入力します。

set_param('myModel','SimCompilerOptimization','on')

JIT アクセラレータモードで SimCompilerOptimization が on に設定されると、一部のモデルではシミュレーション時間が短縮されますが、ビルド時間は長くなる可能性があります。

コード生成中の詳細レベルの制御

コード生成中に進行状況に関する情報を表示するには、AccelVerboseBuild パラメーターを使用します。入力可能な値は、on または off です。既定の設定は off です。

詳細なビルドをオンにするには、コマンドウィンドウで次のように入力します。

set_param('myModel','AccelVerboseBuild','on')