RSim システム ターゲット ファイルを使用したホスト コンピューターでのハイブリッド動的システムの高速化、調整およびテスト
モデルを作成したら、ラピッド シミュレーション (RSim) システム ターゲット ファイルを使用して、モデルの動作を特徴付けます。ビルド プロセスで生成された実行可能プログラムは、開発用コンピューターでの非リアルタイム実行に使用されます。実行可能プログラムは、可変ステップ ソルバーやゼロクロッシング検出を使用するモデルなど、ハイブリッドな動的システムのモデルをシミュレーションするために高度に最適化されています。RSim システム ターゲット ファイルの生成コードの速度は、バッチまたはモンテ カルロ シミュレーションのプログラムを作成するのに最適な速度になります。
ラピッド シミュレーションについて
RSim ターゲットを使用して、高速なスタンドアロンのシミュレーションを実行する実行可能ファイルを生成します。シミュレーションをさまざまなデータセットで、対話的またはスクリプトでプログラム的に、モデルのリビルドなしで繰り返すことができます。これにより、モデル動作とコード生成テストの特徴付けと調整を加速化できます。
コマンド ライン オプションを使用すると、以下のことができます。
モデルのリビルドなしで、シミュレーション開始時に読み込み、および再読み込みできる 1 つ以上の MAT ファイルのパラメーター値と入力信号を定義します。
ログ データを 1 つ以上の MAT ファイルにリダイレクトし、それを解析して比較します。
シミュレーション時間を制御します。
エクスターナル モード オプションを指定します。
メモ
RSim 実行可能ファイルを実行するには、MATLAB® を実行するようコンピューターを設定し、MATLAB と Simulink® の各インストール フォルダーにアクセスできるようにします。
ラピッド シミュレーションの利点
ラピッド シミュレーションによって得られる利点はそれぞれ異なります。シミュレーションが大きくなると、標準の Simulink シミュレーションの最大 10 倍の速度向上が見られます。モデルによっては、シミュレーション速度に目立った改良が見られないこともあります。モデルの速度の差を判断するには、標準の Simulink シミュレーションの時間を測り、結果をラピッド シミュレーションと比較します。さらに、ラピッド アクセラレータ シミュレーション モードでモデル シミュレーションをテストします。
一般的なラピッド シミュレーションのワークフロー
モデルベース デザインの他の段階と同様、モデル動作の特性化と調整は、図の一般的なワークフロー図に示すように反復プロセスです。ワークフロー内のタスクは以下のとおりです。
ラピッド シミュレーションに入力ソース データを提供するInport ブロックを設定します。
ラピッド シミュレーション要件の特定
ラピッド シミュレーションを設定するには、まずシミュレーション要件を特定します。
| 質問 | 詳細情報の参照先 |
|---|---|
| シミュレーションをどのぐらいの期間実行しますか。 | ラピッド シミュレーション用のモデルの構成とビルド |
| ソルバー要件はありますか。ラピッド シミュレーション用に設定されたモデルで同じソルバーを使用しますか。 | ラピッド シミュレーション用のモデルの構成とビルド |
| ラピッド シミュレーションは柔軟なカスタム コードのインターフェイスに対応させる必要がありますか。またはシミュレーションでストレージ クラス設定を保持しなければなりませんか。 | ラピッド シミュレーション用のモデルの構成とビルド |
| 複数のデータセットでシミュレーションを実行していますか。 | ラピッド シミュレーション入力データの設定 |
| 入力データの構成はグローバル パラメーターですか、信号ですか、または両方ですか。 | ラピッド シミュレーション入力データの設定 |
| モデルに入力データを提供するソース ブロックの種類は、From File、Inport、From Workspace のどれですか。 | ラピッド シミュレーション入力データの設定 |
モデルのパラメーター ベクトル ( | モデル パラメーター構造体をもつ MAT ファイルの作成 |
| 入力パラメーターと信号のデータ型は何ですか。 | ラピッド シミュレーション入力データの設定 |
| ソース データは 1 つの変数で構成されていますか、複数の変数で構成されていますか。 | ラピッド シミュレーション入力データの設定 |
| 入力データに調整可能なパラメーターは含まれていますか。 | モデル パラメーター構造体をもつ MAT ファイルの作成 |
| 調整可能なパラメーター情報 (モデルのチェックサム、パラメーターのデータ型、識別子、複雑度) にアクセスしなければなりませんか。 | モデル パラメーター構造体をもつ MAT ファイルの作成 |
| シミュレーション実行時にシミュレーションの停止時間を変える必要がありますか。 | ラピッド シミュレーション用のモデルの構成とビルドおよびモデル シミュレーションの終了時間のオーバーライド |
| シミュレーションに時間制限を設定しますか。モデルで頻繁にゼロクロッシングが検出され、小さいマイナー ステップ サイズがある場合は、時間制限を設定することを検討してください。 | ラピッド シミュレーションのクロック時間制限の設定 |
| 各シミュレーションの実行ごとに出力を保存しなければなりませんか。 | シミュレーションでの新しい出力ファイル名の指定およびTo File ブロックの新しい出力ファイル名の指定 |
| シミュレーションは対話的に実行しますか、それともバッチ モードで実行しますか。 | バッチ シミュレーションおよびモンテ カルロ シミュレーション用のスクリプト |
シミュレーション ソース データを提供するための入力端子の構成
Inport ブロックをラピッド シミュレーションの入力データ ソースに使用できます。使用するには、外部の MAT ファイルからデータをインポートできるようにブロックを設定します。既定の設定では、Inport ブロックは下流ブロックからのパラメーター設定を継承します。ほとんどの場合、外部の MAT ファイルからデータをインポートするには、次のブロック パラメーターが MAT ファイルのソース データに一致するように明示的に設定を行わなければなりません。
[メイン] 、 [データを内挿する]
[信号属性] 、 [端子の次元]
[信号属性] 、 [データ型]
[信号属性] 、 [信号タイプ]
モデルの内容を管理できない場合は、MAT ファイルのデータを変更して、モデルが入力を期待する内容に適合させなければならないことがあります。入力データの特性とデータを受け取る Inport ブロックの仕様は一致しなければなりません。
これらのパラメーターの調整方法、および Inport ブロックで使用する MAT ファイルの作成方法は、Inport ブロックの MAT ファイルの作成を参照してください。前述のブロック パラメーターの説明は、Inport ブロックに関する説明を参照してください。
ラピッド シミュレーション用のモデルの構成とビルド
ラピッド シミュレーションの要件を特定したら、ラピッド シミュレーションに合わせてモデルを設定します。
モデル コンフィギュレーション パラメーター [システム ターゲット ファイル] を [
rsim.tlc] (ラピッド シミュレーション ターゲット) に設定します。[RSim ターゲット] をクリックすると、[RSim ターゲット] ペインが表示されます。
RSim ターゲットのコンフィギュレーション パラメーターをラピッド シミュレーションの要件に設定します。
実行する操作 説明 RSim 実行可能ファイルが MAT ファイルからパラメーターを読み込めるようにするコードを生成する [MAT ファイルからパラメーターを読み込むための RSim の実行可能な形式を有効にする] (既定の設定) を選択します。 ターゲットが既にモデル用に設定されているソルバーに基づいて、ソルバーを選択する [ソルバーの選択] を
[Auto](既定の設定) に設定します。コード ジェネレーターは、固定ステップ ソルバーが [ソルバー] ペインで指定されている場合に組み込みソルバーを使用し、可変ステップ ソルバーが指定されている場合は Simulink ソルバー モジュール (共有ライブラリ) を呼び出します。固定ステップ ソルバーを使用するように明示的にターゲットに指示する [ソルバーの選択] を [固定ステップ ソルバーを使用]に設定します。[コンフィギュレーション パラメーター] ダイアログ ボックスの [ソルバー] ペインで固定ステップ ソルバーを指定します。可変ステップ ソルバーを使用するように明示的にターゲットに指示する [ソルバーの選択] を
[Simulink ソルバーのモジュールを使用]に設定します。[コンフィギュレーション パラメーター] ダイアログ ボックスの [ソルバー] ペインで可変ステップ ソルバーを指定します。柔軟なカスタム コード インターフェイス用にストレージ クラスを強制的に [Auto]にする[ストレージ クラスを強制的に Auto にする] (既定の設定) を選択します。 アプリケーション要件に従い、 [ExportedGlobal]や[ImportedExtern]などのストレージ クラス設定を保持する[ストレージ クラスを強制的に Auto にする] をクリアします。 データのインポート オプションとエクスポート オプションを設定します。[データのインポート/エクスポート] ペインの [ワークスペースへ保存] セクションで、必要であれば [時間]、[状態]、[出力] および [最終状態] パラメーターを選択します。既定の設定では、コード ジェネレーターはシミュレーション ロギングの結果を
model.matエクスターナル モードの通信を使用する場合は、[コード生成] 、 [インターフェイス] ペインを使用してインターフェイスを設定します。詳細については、エクスターナル モード シミュレーションによるパラメーター調整、信号監視、コード実行プロファイリングを参照してください。
Ctrl+B キーを押します。コード ジェネレーターは、リビルドせずに開発用コンピューターでさまざまなデータを実行できる、高度に最適化された実行可能プログラムをビルドします。
Simulink Coder™ 製品と互換性のあるコンパイラの詳細については、C または C++ コンパイラの選択と設定およびテンプレート makefile と make オプションを参照してください。
ラピッド シミュレーション入力データの設定
ラピッド シミュレーション データの設定について
ラピッド シミュレーションの入力データの形式と設定は、要件によって異なります。
| 入力データ ソース | 説明 |
|---|---|
モデルのグローバル パラメーター ベクトル ( | 関数 rsimgetrtp を使用してベクトルの内容を取得し、MAT ファイルに保存します。 |
| モデルのグローバル パラメーター ベクトル、およびベクトルと調整可能なパラメーター間のマッピング | 関数 rsimgetrtp を呼び出してグローバル パラメーター構造体を取得し、MAT ファイルに保存します。 |
| From File ブロック提供のデータ | From File ブロックが読み取れる MAT ファイルを作成します。 |
| Inport ブロック提供のデータ | Inport ブロックが読み取れる 3 つのデータ ファイル形式の 1 つに即した MAT ファイルを作成します。 |
| From Workspace ブロック提供のデータ | MATLAB ワークスペース内で構造体変数を作成します。 |
RSim ターゲットでは、From File と Inport ブロックの入力に使用する MAT ファイルにデータが含まれていなければなりません。grt ターゲットは MAT ファイル データを直接生成コードに挿入します。データは続けて実行可能ファイルとしてコンパイルされ、リンクされます。一方、RSim では連続するシミュレーションごとにデータセットを置き換えできます。From File ブロックまたは Inport ブロックがモデルに存在する場合、From File または Inport ブロック データをもつ MAT ファイルが存在していなければなりません。
モデル パラメーター構造体をもつ MAT ファイルの作成
モデルのグローバル パラメーター構造体 (model_P
関数
rsimgetrtpを呼び出して、構造体を取得します。パラメーター構造体を MAT ファイルに保存します。
さまざまなデータセットでシミュレーションを実行する場合は、パラメーター構造体を cell 配列に変換し、パラメーターのバリエーションを単一の MAT ファイルに保存することを検討してください。
モデルのパラメーター構造体の取得. モデルのグローバル パラメーター構造体 (model_Prsimgetrtp を呼び出します。
param_struct = rsimgetrtp('model')| 引数 | 説明 |
|---|---|
| ラピッド シミュレーションを実行中のモデル。 |
関数 rsimgetrtp は、指定のモデルのブロック線図更新アクションを強制し、以下のフィールドをもつ構造体を返します。
| フィールド | 説明 |
|---|---|
modelChecksum | モデルの構造をエンコードする 4 つの要素をもつベクトル。コード ジェネレーターはチェックサムを使用して、RSim 実行可能ファイルの生成後にモデルの構造体が変化したかどうかを調べます。ブロックを削除または追加してから新しい model_P ベクトルを生成すると、新しいチェックサムは元のチェックサムに一致しなくなります。RSim 実行可能ファイルはパラメーター ベクトルからこの非互換性を検出すると、終了して間違ったシミュレーション結果が返されるのを回避します。モデル構造体が変化した場合は、モデルのコードを再生成しなければなりません。 |
parameters | モデルのグローバル パラメーターをもつ構造体。 |
パラメーター構造体には、以下の情報が含まれます。
| フィールド | 説明 |
|---|---|
dataTypeName | パラメーターのデータ型名。たとえば、double |
dataTypeID | コード ジェネレーターで使用される内部データ型識別子 |
complex | 実数の場合の値は 0、複素数の場合の値は 1 |
| dtTransIdx | コード ジェネレーターで使用される内部データ インデックス |
| values | この構造体に関連したパラメーター値のベクトル |
| map | このフィールドには「値」をモデルの調整可能なパラメーターと相関させるマッピング情報が表示されます。このマッピング情報を rsimsetrtpparam と併用すると、ブロック線図をコンパイルせずに以降の構造体 rtP を作成できるので便利です。 |
コード ジェネレーターは、保存されている値に従って、調整可能な固定小数点パラメーターのレポートを生成します。たとえば、1.4 の sfix(16) パラメーター値でスケーリングが 2^-8 の場合、int16 の値は 358 になります。
以下の例では、rsimgetrtp はモデル例 rtwdemo_rsimtf のパラメーター構造体を param_struct に返します。
param_struct = rsimgetrtp('rtwdemo_rsimtf')
param_struct =
modelChecksum: [1.7165e+009 3.0726e+009 2.6061e+009 2.3064e+009]
parameters: [1x1 struct]パラメーター構造体の MAT ファイルへの保存. rsimgetrtp を呼び出したら、関数呼び出しの戻り値を MAT ファイルに保存します。コマンド ライン オプションを使用すると、MAT ファイルをラピッド シミュレーションの入力に指定できます。
以下の例は、rtwdemo_rsimtf に返されたパラメーター構造体を MAT ファイル myrsimdemo.mat に保存します。
save myrsimdemo.mat param_struct;
コマンド ライン オプションを使用した必要なファイルの指定方法の詳細については、ラピッド シミュレーションの実行を参照してください。
さまざまなデータセットでシミュレーションを実行するためのパラメーター構造体の変換. ラピッド シミュレーションを使用して特定のパラメーターに加えた変更をテストするために、モデル パラメーターの構造体を cell 配列に変換することができます。その後、@ 演算子でファイルの特定のパラメーター セットのインデックスを指定することによって、特定のパラメーター セットにアクセスできます。
構造体を cell 配列に変換するには、以下の手順に従います。
関数
rsimgetrtpを使用して、モデル例rtwdemo_rsimtfのパラメーター情報が含まれる構造体を取得します。構造体を変数param_structに格納します。param_struct = rsimgetrtp('rtwdemo_rsimtf');構造体の
parametersフィールドはパラメーター情報が含まれるサブ構造体です。parametersサブ構造体のvaluesフィールドには、シミュレーション コードの実行中に調整できるパラメーターの数値が含まれます。より多くのパラメーター セットが含まれるように、関数
rsimsetrtpparamを使用して構造体を拡張します。この場合、さらに 2 つのパラメーター セットを作成します (合計 3 つのセット)。param_struct = rsimsetrtpparam(param_struct,3);
関数は、
parametersフィールドを 3 つの要素をもった cell 配列に変換します。各要素には単一のパラメーター セットの情報が含まれます。既定では、関数は最初の要素をコピーして、cell 配列の 2 番目と 3 番目の要素を作成します。したがって、すべてのパラメーター セットで同じパラメーター値を使用します。2 番目と 3 番目のパラメーター セットのパラメーターに新しい値を指定します。
param_struct.parameters{2}.values = [-150 -5000 0 4950]; param_struct.parameters{3}.values = [-170 -5500 0 5100];パラメーター セット情報が含まれる構造体を MAT ファイルに格納します。
save rtwdemo_rsimtf.mat param_struct;
あるいはモデル内でブロック パラメーターを変更し、rsimgetrtp を使用して複数のパラメーター セットを作成できます。
関数
rsimgetrtpを使用して、モデル例rtwdemo_rsimtfのパラメーター情報が含まれる構造体を取得します。構造体を変数param_structに格納します。param_struct = rsimgetrtp('rtwdemo_rsimtf');より多くのパラメーター セットが含まれるように、関数
rsimsetrtpparamを使用して構造体を拡張します。この場合、さらに 2 つのパラメーター セットを作成します (合計 3 つのセット)。param_struct = rsimsetrtpparam(param_struct,3);
関数は、
parametersフィールドを 3 つの要素をもった cell 配列に変換します。各要素には単一のパラメーター セットの情報が含まれます。既定では、関数は最初の要素をコピーして、cell 配列の 2 番目と 3 番目の要素を作成します。したがって、すべてのパラメーター セットで同じパラメーター値を使用します。ブロック パラメーターまたはワークスペース変数の値を変更します。たとえば、変数
wの値を70から72に変更します。w = 72;
rimsgetrtpを使用してパラメーター情報が含まれる別の構造体を取得します。構造体を一時変数rtp_tempに格納します。rtp_temp = rsimgetrtp('rtwdemo_rsimtf');rtp_tempのparametersフィールドの値を 2 番目のパラメーター セットとして構造体param_structに代入します。param_struct.parameters{2} = rtp_temp.parameters;変数
wの値を72から75に変更します。w = 75;
rimsgetrtpを使用してパラメーター情報が含まれる別の構造体を取得します。次に、parametersフィールドの値を 3 番目のパラメーター セットとしてparam_structに代入します。rtp_temp = rsimgetrtp('rtwdemo_rsimtf'); param_struct.parameters{3} = rtp_temp.parameters;パラメーター セット情報が含まれる構造体を MAT ファイルに格納します。
save rtwdemo_rsimtf.mat param_struct;
シミュレーション実行時の各パラメーター セットの指定方法の詳細については、RSim シミュレーション用のブロック パラメーターの変更を参照してください。
From File ブロックの MAT ファイルの作成
MAT ファイルを From File ブロックの入力データ ソースに使用できます。MAT ファイルのデータ形式は、そのブロックで期待されているデータ形式に一致しなければなりません。たとえば、MAT ファイルへの入力として行列を使用する場合、実行可能ファイルの行列のサイズと異なってはいけません。
From File ブロックの MAT ファイルを作成するには、以下の手順に従います。
配列形式のデータの場合、ワークスペースで 2 つ以上の行から構成される行列を作成します。1 行目には単調増加する時点が含まれていなければなりません。他の行には、その列の時点に対応するデータ点が含まれます。時点およびデータ点は
doubleのデータ型でなければなりません。以下に例を示します。
t=[0:0.1:2*pi]'; Ina1=[2*sin(t) 2*cos(t)]; Ina2=sin(2*t); Ina3=[0.5*sin(3*t) 0.5*cos(3*t)]; var_matrix=[t Ina1 Ina2 Ina3]';
int16や固定小数点など、他にサポートされているデータ型の場合は、時点とデータ点は配列形式データと同様doubleのデータ型でなければなりません。ただしサンプル データには、任意の次元を使用できます。入力データの設定方法の詳細については、From File ブロックに関する説明を参照してください。
行列を MAT ファイルに保存します。
以下の例は、行列
var_matrixを Version 7.3 形式の MAT ファイルmyrsimdemo.matで保存しています。save '-v7.3' myrsimdemo.mat var_matrix;
コマンド ライン オプションを使用すると、MAT ファイルをラピッド シミュレーションの入力に指定できます。
Inport ブロックの MAT ファイルの作成
MAT ファイルを Inport ブロックの入力データ ソースに使用できます。
MAT ファイルのデータ形式は、以下の表に記載されている 3 つの列ベースの形式の 1 つに従わなければなりません。この表では、最も柔軟性の低い形式から最も柔軟性の高い形式の順に記載しています。
| 形式 | 説明 |
|---|---|
| 単一の時間/データ行列 |
例については、以下の手順 4 の「単一の時間/データ行列」を参照してください。詳細については、データ配列のルートレベル入力への読み込みを参照してください。 |
| 信号-および-時間構造体 |
例については、以下の手順 4 の「信号-および-時間構造体」を参照してください。この形式の詳細については、データ構造体のルートレベル入力への読み込みを参照してください。 |
| 端子ごとの構造体 |
例については、以下の手順 4 の「端子ごとの構造体」を参照してください。詳細については、データ構造体のルートレベル入力への読み込みを参照してください。 |
サポートされている形式と次の手順は、rtwdemo_rsim_i に記載されています。
Inport ブロックの MAT ファイルを作成するには、以下の手順に従います。
前述のデータ ファイル形式の 1 つを選択します。
Inport ブロック パラメーター設定と仕様が MAT ファイルで提供されているデータの仕様に一致するように更新します。
既定の設定では、Inport ブロックは下流ブロックからのパラメーター設定を継承します。外部の MAT ファイルからデータをインポートするには、次のパラメーターが MAT ファイルのソース データに一致するように明示的に設定を行います。
[メイン] 、 [データを内挿する]
[信号属性] 、 [端子の次元]
[信号属性] 、 [データ型]
[信号属性] 、 [信号タイプ]
ワークスペース変数に構造体形式を使用したときに
timeフィールドが空白の場合は、ブロック パラメーター [データを内挿する] をオフにするか、パラメーターを変更して、空ではない値になるように設定します。内挿を行うには時間データが必要です。前述のブロック パラメーターの説明は、Inport ブロックに関する説明を参照してください。
モデルの RSim 実行可能プログラムをビルドします。ビルド プロセスは、モデルの構造的なチェックサムを作成して計算し、これを生成された実行可能ファイルに組み込みます。RSim ターゲットはチェックサムを使用して、モデルに渡されているデータがモデルの実行可能ファイルで期待されている内容と整合することを確認します。
ラピッド シミュレーションのソース データを提供する MAT ファイルを作成します。ワークスペース変数から MAT ファイルを作成できます。前述の形式の比較表の仕様を使用して、シミュレーションのワークスペース変数を作成します。
各形式の例は次のとおりです。
単一の時間/データ行列
t=[0:0.1:2*pi]'; Ina1=[2*sin(t) 2*cos(t)]; Ina2=sin(2*t); Ina3=[0.5*sin(3*t) 0.5*cos(3*t)]; var_matrix=[t Ina1 Ina2 Ina3];
信号-および-時間構造体
t=[0:0.1:2*pi]'; var_single_struct.time=t; var_single_struct.signals(1).values(:,1)=2*sin(t); var_single_struct.signals(1).values(:,2)=2*cos(t); var_single_struct.signals(2).values=sin(2*t); var_single_struct.signals(3).values(:,1)=0.5*sin(3*t); var_single_struct.signals(3).values(:,2)=0.5*cos(3*t); v=[var_single_struct.signals(1).values... var_single_struct.signals(2).values... var_single_struct.signals(3).values];
端子ごとの構造体
t=[0:0.1:2*pi]'; Inb1.time=t; Inb1.signals.values(:,1)=2*sin(t); Inb1.signals.values(:,2)=2*cos(t); t=[0:0.2:2*pi]'; Inb2.time=t; Inb2.signals.values(:,1)=sin(2*t); t=[0:0.1:2*pi]'; Inb3.time=t; Inb3.signals.values(:,1)=0.5*sin(3*t); Inb3.signals.values(:,2)=0.5*cos(3*t);
ワークスペース変数を MAT ファイルに保存します。
単一の時間/データ行列
以下の例は、ワークスペース変数
var_matrixを MAT ファイルrsim_i_matrix.matに保存します。save rsim_i_matrix.mat var_matrix;
信号-および-時間構造体
以下の例は、ワークスペース構造体変数
var_single_structを MAT ファイルrsim_i_single_struct.matに保存します。save rsim_i_single_struct.mat var_single_struct;
端子ごとの構造体
端子ごとの構造体変数を単一の MAT ファイルに保存するときにデータを順序付けするには、
saveコマンドの-appendオプションを使用します。モデルで期待されている順序でデータを追加してください。以下の例は、ワークスペース変数
Inb1、Inb2、およびInb3を MAT ファイルrsim_i_multi_struct.matに保存します。save rsim_i_multi_struct.mat Inb1; save rsim_i_multi_struct.mat Inb2 -append; save rsim_i_multi_struct.mat Inb3 -append;
saveコマンドでは、データを MAT ファイルに保存したときにコマンド ラインで指定したワークスペース変数の順序は保存されません。たとえば、変数v1、v2、およびv3の順で変数を指定しても、MAT ファイルの変数の順序がv2 v1 v3になることがあります。コマンド ライン オプションを使用すると、MAT ファイルをラピッド シミュレーションの入力に指定できます。
バッチ シミュレーションおよびモンテ カルロ シミュレーション用のスクリプト
RSim ターゲットは、パラメーターと入力信号が複数のシミュレーションで異なるバッチ シミュレーションを目的としています。新しい出力ファイル名を使用することで、以前のシミュレーション結果をオーバーライドせずに、新しいシミュレーションを実行することができます。Microsoft® Windows® プラットフォームで使用する .bat ファイルを作成することで、実行する一連のシミュレーションを設定することができます。
テキスト エディターを使用して Windows プラットフォームのファイルを作成し、mybatch などのファイル名を入力して実行できます (この場合、テキスト ファイルの名前は mybatch.bat)。
rtwdemo_rsimtf -f rtwdemo_rsimtf.mat=run1.mat -o results1.mat -tf 10.0 rtwdemo_rsimtf -f rtwdemo_rsimtf.mat=run2.mat -o results2.mat -tf 10.0 rtwdemo_rsimtf -f rtwdemo_rsimtf.mat=run3.mat -o results3.mat -tf 10.0 rtwdemo_rsimtf -f rtwdemo_rsimtf.mat=run4.mat -o results4.mat -tf 10.0
この場合、バッチ シミュレーションは、ファイル run1.mat、run2.mat、などの 4 つの入力データセットを使用して実行されます。RSim 実行可能ファイルは、-o オプションで指定したファイルにデータを保存します。
各ファイルのシミュレーション結果が含まれる変数名は同じです。このため、MATLAB ワークスペースに入ったデータの名前を変更せずに連続したデータのセットを読み込むと、以前のワークスペース変数が新しいデータで上書きされます。上書きを回避するため、次のデータセットを読み込む前に結果を新しい MATLAB 変数にコピーすることができます。
また、MATLAB スクリプトを記述して新しい信号と新しいパラメーター構造体を作成し、データを保存してから「bang」コマンド (!) を使用してバッチ実行を行うこともできます。
シミュレーションの実行と使用可能なコマンド ライン オプションの詳細については、ラピッド シミュレーションの実行を参照してください。ラピッド シミュレーションのバッチ スクリプトの例については、生成コードを再コンパイルしないバッチ シミュレーションの実行の例を参照してください。
ラピッド シミュレーションの実行
ラピッド シミュレーション
RSim ターゲットを使用すると、モデルを 1 度だけビルドし、複数のシミュレーションを実行して、さまざまなパラメーター設定や入力信号の効果を調べることができます。シミュレーションはオペレーティング システムのコマンド ラインから直接実行するか、「bang」(!) 文字を使用して MATLAB コマンド ラインからコマンドをリダイレクトするか、スクリプトからコマンドを実行することができます。
オペレーティング システムのコマンド ラインから、次のコマンドを使用します。
rtwdemo_rsimtf
MATLAB コマンド ラインから、次のコマンドを使用します。
!rtwdemo_rsimtfRSim ターゲット コマンド ライン オプションを使用してシミュレーションを制御する方法を以下の表に示します。
| 目的... | 使用する機能 |
|---|---|
| 以前のシミュレーションに使用された MAT ファイル以外の MAT ファイルから From File ブロックの入力データを読み取る |
|
| RSim 実行可能ファイルのターゲットのオプションの概要を表示する | |
| MAT ファイルから Inport ブロックの入力データを読み取る | |
n クロック時間 (秒) 後にタイム アウトする。(n は正の整数値) | |
MAT ファイルのログ データをファイル | |
ファイル | |
| エクスターナル モードの既定の TCP ポート (17725) のオーバーライド | |
| 前のシミュレーションで使用された MAT ファイル以外の MAT ファイルに MAT ファイルのログ データを書き込む | |
時間の値の | |
| 詳細モードで実行する | |
| Simulink エンジンがエクスターナル モードでモデルを開始するのを待機する | |
以下の節はモデル rtwdemo_rsimtf を例に使用して、これらのコマンド ライン オプションのいくつかを紹介します。各状況の例では、既に次の操作が行われたことを前提とします。
作業フォルダーを作成した、または作業フォルダーに変更した。
サンプル モデルを開いた。
データ ファイル
matlabroot/toolbox/rtw/rtwdemos/rsimdemos/rsim_tfdata.matcopyfile(fullfile(matlabroot,'toolbox','rtw','rtwdemos',... 'rsimdemos','rsim_tfdata.mat'),pwd);
ラピッド シミュレーションを実行するための要件
以下の要件は、固定ステップ実行可能ファイルと可変ステップ実行可能ファイルの両方に適用されます。
RSim 実行可能ファイルは、MATLAB を実行するように設定されたコンピューター上で実行しなければなりません。また、
RSim.exeファイルは、このマシン上の MATLAB と Simulink インストール フォルダーにアクセスできなければなりません。アクセスするには、PATH 環境変数に /bin と /bin/($ARCH) を含め、($ARCH) がオペレーティング システムのアーキテクチャを表すようにしなければなりません。たとえば、Windows プラットフォームで実行されるパーソナル コンピューターの場合、($ARCH) は "win64" ですが、Linux マシンでは、($ARCH) は "glnxa64" になります。GNU® Linux® プラットフォームで RSim 実行可能ファイルを実行するには、次のように MATLAB インストール フォルダーへのパスを示すように LD_LIBRARY_PATH 環境変数を定義します。
% setenv LD_LIBRARY_PATH /matlab/sys/os/glnx64:$LD_LIBRARY_PATH
Apple Macintosh OS X プラットフォームで RSim ターゲット実行可能ファイルを実行するには、環境変数
DYLD_LIBRARY_PATHを設定して、MATLAB インストール フォルダー下にあるbin/macとsys/os/macを含めなければなりません。たとえば、MATLAB インストールが/MATLABにある場合、/MATLAB/bin/macと/MATLAB/sys/os/macをDYLD_LIBRARY_PATHの定義に追加します。
ラピッド シミュレーションのクロック時間制限の設定
モデルで頻繁にゼロクロッシングが検出され、モデルのマイナー ステップ サイズが小さい場合は、ラピッド シミュレーションに時間制限を設定することを検討してください。時間制限を設定するには、正の整数値を使用して -L オプションを指定します。シミュレーションは指定のクロック時間後 (シミュレーション時間ではなく) に中断されます。次に例を示します。
!rtwdemo_rsimtf -L 20実行可能ファイルがクロックに基づいて 20 秒実行された後、プログラムは終了します。次のいずれかのようなメッセージが表示されます。
Microsoft Windows プラットフォームの場合
Exiting program, time limit exceeded Logging available data ...
The Open Group UNIX® プラットフォームの場合
** Received SIGALRM (Alarm) signal @ Fri Jul 25 15:43:23 2003 ** Exiting model 'rtwdemo_rsimtf' @ Fri Jul 25 15:43:23 2003
このオプションを使用するために、モデルまたはそのコンフィギュレーションに何か操作を行う必要はありません。
モデル シミュレーションの終了時間のオーバーライド
既定の設定では、ラピッド シミュレーションはシミュレーション時間が [ソルバー] ペインの [コンフィギュレーション パラメーター] ダイアログ ボックスで指定した時間に達するまで実行を続けます。モデル シミュレーションの終了時間をオーバーライドするには、-tf オプションを使用します。たとえば以下のシミュレーションは、時間が 6.0 秒に達するまで実行を続けます。
!rtwdemo_rsimtf -tf 6.0RSim ターゲットは停止し、MAT ファイルのデータ ロギング ルールを使用して出力データのログが作成されます。
モデルに From File ブロックが含まれる場合、シミュレーションの最後は [ソルバー] ペインの [コンフィギュレーション パラメーター] ダイアログ ボックスで指定された停止時間設定、または RSim ターゲット オプション -tf によって制御されます。ブロックの時間ベクトルの値は無視されます。ただし、シミュレーション時間が時間および信号行列のエンドポイントを超えた場合 (最終時間がデータ行列の最終時間値より大きい場合)、信号データは最終時間値に外挿されます。
パラメーター ベクトルのラピッド シミュレーションへの読み取り
モデルのパラメーター ベクトルをラピッド シミュレーションに読み取るには、最初にモデル パラメーター構造体をもつ MAT ファイルの作成で説明したパラメーター構造体をもつ MAT ファイルを作成しなければなりません。その後で -p オプションを使用して、コマンド ラインで MAT ファイルを指定することができます。
以下に例を示します。
モデル例
rtwdemo_rsimtfの RSim 実行可能ファイルをビルドします。モデルのパラメーターに変更を加え、パラメーター構造体を保存します。
param_struct = rsimgetrtp('rtwdemo_rsimtf'); save myrsimdata.mat param_struct
新しいパラメーター セットを使用して、実行可能ファイルを実行します。
!rtwdemo_rsimtf -p myrsimdata.mat** Starting model 'rtwdemo_rsimtf' @ Tue Dec 27 12:30:16 2005 ** created rtwdemo_rsimtf.mat **
ワークスペース変数を読み込み、次のコマンドを入力してシミュレーション結果をプロットします。
load rtwdemo_rsimf.mat plot(rt_yout)
From File ブロックの新しい信号データ ファイルの指定
モデルの入力データ ソースが From File ブロックの場合、シミュレーション時に単一の MAT ファイルから入力データを与えるか、シミュレーションから次のシミュレーションへ MAT ファイルを変更できます。MAT ファイルはそれぞれFrom File ブロックの MAT ファイルの作成で説明した形式に従わなければなりません。
初回シミュレーション後に MAT ファイルを変更するには、以下の例に示すように -f オプションと oldfile.mat=newfile.mat
一部のパラメーターを MATLAB ワークスペースに設定します。以下に例を示します。
w = 100; theta = 0.5;
モデル例
rtwdemo_rsimtfの RSim 実行可能ファイルをビルドします。実行可能ファイルを実行します。
!rtwdemo_rsimtfRSim 実行可能ファイルはシミュレーションのセットを実行し、固有のシミュレーション結果を含む出力 MAT ファイルを作成します。
ワークスペース変数を読み込み、次のコマンドを入力してシミュレーション結果をプロットします。
load rtwdemo_rsimtf.mat plot(rt_yout)結果のプロットには、既定の入力データに基づくシミュレーション結果が表示されます。
以下のデータを含む新しいデータ ファイル
newfrom.matを作成します。t=[0:.001:1]; u=sin(100*t.*t); tu=[t;u]; save newfrom.mat tu;
-fオプションを使用して元のファイルのrsim_tfdata.matをnewfrom.matで置き換え、新しいデータでラピッド シミュレーションを実行します。!rtwdemo_rsimtf -f rsim_tfdata.mat=newfrom.matデータを読み込み、次のコマンドを入力して新しい結果をプロットします。
load rtwdemo_rsimtf.mat plot(rt_yout)次の図は結果のプロットを示します。
From File ブロックには、double 型の入力データが必要です。double 以外のデータ型の信号データをインポートする場合は、Inport ブロック (Inport ブロックの MAT ファイルの作成を参照) または、From Workspace ブロックで、構造体に指定したデータを使用します。
ワークスペース データは以下の形式でなければなりません。
variable.time variable.signals.values
1 つを超える信号がある場合は、以下の形式を使用します。
variable.time variable.signals(1).values variable.signals(2).values
Inport ブロックの信号データ ファイルの指定
モデルの入力データ ソースが Inport ブロックの場合、シミュレーション時に単一の MAT ファイルから入力データを与えるか、シミュレーションから次のシミュレーションへ MAT ファイルを変更できます。MAT ファイルはそれぞれInport ブロックの MAT ファイルの作成で説明した 3 つの形式の 1 つに従わなければなりません。
シミュレーション後に MAT ファイルを指定するには、-i オプションと入力データが含まれる MAT ファイルの名前で実行可能ファイルを指定します。以下に例を示します。
モデル
rtwdemo_rsim_iを開きます。Inport ブロックのパラメーター設定を確認します。ワークスペース変数用に指定する、以下の Inport ブロック データのパラメーター設定および仕様は、シミュレーション ソース データを提供するための入力端子の構成に示すように、MAT ファイルの設定に一致しなければなりません。
[メイン] 、 [データを内挿する]
[信号属性] 、 [端子の次元]
[信号属性] 、 [データ型]
[信号属性] 、 [信号タイプ]
モデルを作成します。
入力信号を設定します。次に例を示します。
t=[0:0.01:2*pi]'; s1=[2*sin(t) 2*cos(t)]; s2=sin(2*t); s3=[0.5*sin(3*t) 0.5*cos(3*t)]; plot(t, [s1 s2 s3])
Inport ブロックの MAT ファイルの作成で説明した、使用可能な 3 つのファイル形式を使用して、MAT ファイルを準備します。以下の例は、ワークスペースの信号および時間構造体を定義し、
var_single_structと言う名前を付けます。t=[0:0.1:2*pi]'; var_single_struct.time=t; var_single_struct.signals(1).values(:,1)=2*sin(t); var_single_struct.signals(1).values(:,2)=2*cos(t); var_single_struct.signals(2).values=sin(2*t); var_single_struct.signals(3).values(:,1)=0.5*sin(3*t); var_single_struct.signals(3).values(:,2)=0.5*cos(3*t); v=[var_single_struct.signals(1).values... var_single_struct.signals(2).values... var_single_struct.signals(3).values];
ワークスペース変数
var_single_structを MAT ファイルrsim_i_single_structに保存します。save rsim_i_single_struct.mat var_single_struct;
-iオプションを使用して、入力データのラピッド シミュレーションを実行します。結果を読み込み、プロットします。!rtwdemo_rsim_i -i rsim_i_single_struct.mat** Starting model 'rtwdemo_rsim_i' @ Tue Aug 19 10:26:53 2014 *** rsim_i_single_struct.mat is successfully loaded! *** ** created rtwdemo_rsim_i.mat ** ** Execution time = 0.02024185130718954s
結果を読み込み、プロットします。
load rtwdemo_rsim_i.mat plot(rt_tout, rt_yout);
RSim シミュレーション用のブロック パラメーターの変更
モデル パラメーター構造体をもつ MAT ファイルの作成で説明したとおり、Simulink ブロック線図で 1 つ以上のパラメーターを変更した後で、パラメーター ベクトルの model_P をモデル全体のために抽出することができます。その後でパラメーター ベクトルをモデルのチェックサムと一緒に MAT ファイルに保存することができます。この MAT ファイルは直接スタンドアロンの RSim 実行可能ファイルで読み取れるため、パラメーター ベクトル全部、または個々のパラメーター値を置き換えて、係数を表すパラメーター値や入力信号の新しいデータのバリエーションの研究を実行したりすることができます。
RSim では、1 つ以上のパラメーターが変更されるたびに、モデル全体をリコンパイルせずに MAT ファイルを読み取り、model_P 構造体全体を置き換えることができます。
たとえば、モデルで 1 つ以上のパラメーターを変更し、新しい model_P ベクトルを生成して、model_P を mymatfile.mat と言う新しい MAT ファイルに保存したとします。同じ rtwdemo_rsimtf モデルを実行し、新しいパラメーター値を使用するには、以下の例に示すように -p オプションを使用します。
!rtwdemo_rsimtf -p mymatfile.mat load rtwdemo_rsimtf plot(rt_yout)
さまざまなデータセットでシミュレーションを実行するためのパラメーター構造体の変換で説明したように、さまざまなデータセットでシミュレーションを実行するためにパラメーター構造体を cell 配列に変換した場合は、@ サフィックスを MAT ファイル仕様に加えなければなりません。nn はこのシミュレーションに使用する特定の入力が含まれる cell 配列の要素です。
以下の例は param_struct を cell 配列に変換し、パラメーター値を変更して、変更を MAT ファイルの mymatfile.mat に保存してから、cell 配列の 2 番目の要素のパラメーター値を入力に使用して、実行可能ファイルを実行します。
param_struct = rsimgetrtp('rtwdemo_rsimtf');
param_struct = rsimsetrtpparam(param_struct,2);
param_struct.parameters{1}
ans =
dataTypeName: 'double'
dataTypeId: 0
complex: 0
dtTransIdx: 0
values: [-140 -4900 0 4900]
map: []
structParamInfo: []param_struct.parameters{2}.values=[-150 -5000 0 4950];
save mymatfile.mat param_struct;
!rtwdemo_rsimtf -p mymatfile.mat@2 -o rsim2.matシミュレーションでの新しい出力ファイル名の指定
[コンフィギュレーション パラメーター] ダイアログ ボックスの [データのインポート/エクスポート] ペインで [ワークスペースへ保存] パラメーター ([時間]、[状態]、[出力] または [最終状態]) のいずれかまたはいくつかを指定した場合、既定の設定ではシミュレーションのログ結果が model.mat というファイルに保存されます。たとえば、例で使用するモデル rtwdemo_rsimtf では、通常、以下のようにデータを rtwdemo_rsimtf.mat に保存します。
!rtwdemo_rsimtf created rtwdemo_rsimtf.mat
実行可能ファイルの実行時に -o オプションを使用して、データ ロギングの新しい出力ファイル名を指定することができます。
!rtwdemo_rsimtf -o rsim1.matこの場合、From File ブロック データ パラメーターを含むコード生成時に提供されたパラメーターのセットが実行されます。
To File ブロックの新しい出力ファイル名の指定
新しいシステム出力ファイル名を指定するのとほぼ同じ方法で、1 つ以上の To File ブロックから保存されたデータの新しい出力ファイル名を指定できます。その場合、以下の例に示すように、コード生成時に元のファイル名に新しい名前を付けます。
!rtwdemo_rsimtf -t rtwdemo_rsimtf_data.mat=mynewrsimdata.matこの場合、元のモデルが出力ファイル rtwdemo_rsimtf_data.mat にデータを書き込んだと想定します。新しいファイル名を指定すると、RSim は強制的に mynewrsimdata.mat ファイルに書き込むようになります。この手法を使用することで、既存のシミュレーションの実行が上書きされないようにすることができます。
ラピッド シミュレーション中のパラメーターの対話的な調整
RSim システム ターゲット ファイルは、可能な限り高速でバッチ シミュレーションを実行できるように設計されました。そのシステム ターゲット ファイルおよび調整可能なパラメーター データ構造体と組み合わせて可変ステップまたは固定ステップ ソルバーを使用すると、[既定のパラメーター動作] を Tunable または Inlined のどちらに設定していても、複数のパラメーター セットを作成できます。これらのデータセットは、生成された実行可能プログラム (Windows では .exe) で実行できます。実行可能プログラムの呼び出しでは毎回、結果に使用するファイル名を指定できます。
モデル例 RsimParamTuning を開きます。
open_system('RsimParamTuning.slx'); 
このモデルの [既定のパラメーター動作] は Inlined に設定されています。モデルは、ワークスペース変数を調整可能なパラメーターとして宣言しています。[既定のパラメーター動作] を Tunable に設定し、調整可能なパラメーターを明示的に宣言せずに RSim システム ターゲット ファイルを使用する場合は、生成コードを再コンパイルしないバッチ シミュレーションの実行を参照してください。
このモデルは RSim システム ターゲット ファイルと関数 rsimgetrtp を使用して、Simulink モデルを再コンパイルせずに新しいデータを非リアルタイム実行可能ファイルに渡すことができます。この機能により、モデル内で宣言された調整可能なパラメーターのマップを取得し、MAT ファイルに保存することができます。その後、独自の MATLAB グラフィカル ユーザー インターフェイス (GUI) またはスタンドアロンの GUI (MATLAB に依存しない) を作成して、MAT ファイルの読み取りと書き込みを行い、実行可能ファイルを再実行して新しい出力ファイルを生成することができます。
モデルで、ボタンを順番にダブルクリックして例を実行します。
MATLAB GUI およびスタンドアロンの GUI の作成に使用するコードを確認するには、[View MATLAB programs] ボタンをダブルクリックします。
詳細については、RSim システム ターゲット ファイルを使用したホスト コンピューターでのハイブリッド動的システムの高速化、調整およびテストを参照してください。
ラピッド シミュレーションのターゲットの制限
RSim ターゲットには次の制限があります。
代数ループがサポートされていない。
Interpreted MATLAB Function ブロックがサポートされていない。
Fortran S-Function のインライン化されていない MATLAB 言語がサポートされていない。
RSim のビルドに参照モデル (Model ブロックを使用) が含まれる場合、固定ステップを使用してコードを生成するようにモデルを設定します。ただし、最上位モデルでは、参照モデルのブロックが離散であれば、可変ステップ ソルバーを使用することが可能です。
特定の状況では、ブロック パラメーターを変更すると、モデルのチェックサムも変更される構造的な変更がモデルに加えられることがあります。そのような変更の例として、DSP シミュレーションで遅延回数を変更する場合が挙げられます。その場合は、モデルのコードを再生成しなければなりません。
関連するトピック
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)