Simulink.SubSystem.convertToModelReference

サブシステムからモデル参照への変換

構文

Simulink.SubSystem.convertToModelReference(gcb,'UseConversionAdvisor',true)

[tf,h] = Simulink.SubSystem.convertToModelReference(subsys,model)

[tf,h] = Simulink.SubSystem.convertToModelReference(subsys,model,Name,Value)

説明

Simulink.SubSystem.convertToModelReference(gcb,'UseConversionAdvisor',true) は、選択している Subsystem ブロックに対してモデル参照変換アドバイザーを開きます。

[tf,h] = Simulink.SubSystem.convertToModelReference(subsys,model) は指定したサブシステムを参照モデルに変換します。

関数が変換するサブシステムごとに、以下を行います。

モデルを作成する。
サブシステムの内容を新しいモデルにコピーする。
ルートレベルの Inport ブロックおよび Outport ブロックとモデルのコンフィギュレーションパラメーターを更新し、元のサブシステムのコンパイルされた属性と一致させる。
元のモデルのモデルワークスペースの内容を新しいモデルにコピーする。

この関数を使用する前に、サブシステムが含まれるモデルを読み込みます。

例

[tf,h] = Simulink.SubSystem.convertToModelReference(subsys,model,Name,Value) は、1 つ以上の名前と値の引数を使用してオプションを指定します。

例

すべて折りたたむ

モデル参照変換アドバイザーを開く

f14 モデルを開きます。

open_system('f14');

f14 モデルで、Controller Subsystem の出力信号を選択して [信号のログ] をクリックします。

Simulink^® エディターで、Controller Subsystem を選択します。コマンドラインからモデル参照変換アドバイザーを開きます。

Simulink.SubSystem.convertToModelReference(gcb,'UseConversionAdvisor',true);

アドバイザーを使用して変換を実行します。

サブシステムから参照モデルへのプログラムでの変換

スクリプトを開く

Bus Counter サブシステムを bus_counter_ref_model という名前の参照モデルに変換します。

open_system('sldemo_mdlref_conversion');
Simulink.SubSystem.convertToModelReference(...
   'sldemo_mdlref_conversion/Bus Counter', ...
   'bus_counter_ref_model', ...
   'AutoFix',true,...
   'ReplaceSubsystem',true,...
   'CheckSimulationResults',true);

### Successfully converted Subsystem block to Model block.

複数のサブシステムを参照モデルに変換する

2 つのサブシステムを 1 つのコマンドで変換します。

open_system('f14');
set_param(gcs,'SaveOutput','on','SaveFormat','Dataset');
set_param(gcs,'SignalResolutionControl','UseLocalSettings');
Simulink.SubSystem.convertToModelReference(...
{'f14/Controller','f14/Aircraft Dynamics Model'},...
{'controller_ref_model','aircraft_dynamics_ref_model'},...
'ReplaceSubsystem',true,...
'AutoFix',true,...
'CheckSimulationResults',true)

入力引数

すべて折りたたむ

`subsys` — サブシステム名またはハンドル
数値配列 | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

サブシステム名またはハンドル。数値配列、文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。

変換できるサブシステムの詳細については、参照モデルの条件付き実行を参照してください。

データ型: double | char | string

`model` — 参照モデル名
文字ベクトル | 文字ベクトルの cell 配列 | string 配列

参照モデル名。文字ベクトルまたは文字ベクトルの cell 配列、または string 配列として指定します。各モデル名は 59 文字以下でなければなりません。

変換するサブシステムを複数指定する場合は、参照モデル名の数と同じ数を指定します。各モデル名は、指定されたサブシステムに同じ順序で対応します。

データ型: char | string

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後に表示されなければなりませんが、ペアの順序は重要ではありません。

R2021a より前は、名前と値をそれぞれコンマを使って区切り、Name を引用符で囲みます。

例: Simulink.SubSystem.convertToModelReference...(engineSubsys,engineModelRef,'ReplaceSubsystem',true)

変換

すべて折りたたむ

`AutoFix` — 自動修正が可能なすべての変換の問題を修正するオプション
`false` (既定値) | `true`

自動修正が可能なすべての変換の問題を修正するオプション。true または false として指定します。

AutoFix を true に設定すると、関数は修正可能なすべての変換問題を修正します。関数で修正できない問題については、モデルを修正して対処するように促すエラーメッセージが変換プロセスによって生成されます。

メモ

Force を true に設定すると、関数は自動的に変換の問題を修正しません。

データ型: logical

`Force` — エラーが発生しても変換を完了するオプション
`false` (既定値) | `true`

エラーが発生しても変換を完了するオプション。true または false として指定します。

true の場合、関数は変換エラーを警告として返し、AutoFix を true に設定した場合でもエラーを修正せずに変換を継続します。Force オプションによって、この関数を変換の最初のステップを行うために使用し、その後手動で変換プロセスを完了させることができます。

データ型: logical

`DataFileName` — 変換データを保存するファイルの名前
文字ベクトル

変換データを保存するファイルの名前。文字ベクトルとして指定します。絶対パスまたは相対パスを指定できます。

変換データは、MAT ファイル (既定) または MATLAB^® ファイルに保存できます。.m ファイル拡張子を使用する場合、関数はすべての変数を MATLAB ファイルにシリアル化します。

既定では、関数はモデル名と _conversion_data.mat で構成されるファイル名を使用します。

データ型: char

モデルのインターフェイス

すべて折りたたむ

`CreateWrapperSubsystem` — モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション
`false` (既定値) | `true`

モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション。true または false として指定します。

サブシステムを参照モデルに変換する場合、変換プロセスでラッパーサブシステムを挿入して親モデルのレイアウトを保持できます。サブシステムラッパーには、変換による Model ブロックが含まれています。

この変換では、端子の追加によって Model ブロックのインターフェイスが変更された場合、ラッパーサブシステムが自動的に作成されます。

データ型: logical

`CreateBusObjectsForAllBuses` — インターフェイス定義のバスオブジェクトを作成するオプション
`false` (既定値) | `true`

インターフェイス定義のバスオブジェクトを作成するオプション。true または false として指定します。

サブシステムとは異なり、モデルには定義済みのインターフェイスが必要です。バーチャルバスを含むインターフェイスを定義するには、新しいモデルで以下のいずれかのオプションを使用する必要があります。

In Bus Element ブロックと Out Bus Element ブロック
Simulink.Bus オブジェクトを指定する Inport ブロックと Outport ブロック

既定では、変換時に Bus オブジェクトは作成されません。代わりに、モデルインターフェイスでバーチャルバスをサポートするために In Bus Element ブロックと Out Bus Element ブロックが使用され、変換後の新しいモデルには元のサブシステムが含まれます。

このパラメーターを true に設定すると、Bus オブジェクトを指定していない Inport ブロックと Outport ブロックに接続されたすべてのバーチャルバスについて、変換で Bus オブジェクトが作成されます。変換ではモデルインターフェイスの Inport ブロックと Outport ブロックが維持され、それらで新しい Bus オブジェクトが指定されます。

データ型: logical

`CopyCodeMappings` — 親モデルから新しいモデルにコードマッピングをコピーするオプション
`false` (既定値) | `true`

親モデルから新しいモデルにコードマッピングをコピーするオプション。true または false として指定します。

true の場合、関数は親モデルから新しい参照モデルに既存のコードマッピング構成をコピーします。

false の場合、関数は親モデルから新しいモデルに既存のコードマッピング構成をコピーしません。

データ型: logical

モデルの実装

すべて折りたたむ

`ReplaceSubsystem` — Subsystem ブロックを Model ブロックと置き換えるオプション
`false` (既定値) | `true`

Subsystem ブロックを Model ブロックと置き換えるオプション。true または false として指定します。

値を true に設定する場合は、サブシステムを変換する前に元のモデルのバックアップを作成することを検討してください。変換を元に戻す場合、バックアップを作成しておくとモデルの復元が容易になります。

ReplaceSubsystem を true に設定した場合、変換処理は自動修正オプションを使用するかどうかに応じて異なります。

自動修正を使用する場合、自動修正で入力端子または出力端子が変更されない限り、変換によって Subsystem ブロックは Model ブロックと置き換えられます。端子が変更される場合、変換によって Subsystem ブロックに挿入される Model ブロックにサブシステムの内容が含まれます。
自動修正を使用しない場合、変換によって Subsystem ブロックが Model ブロックと置き換えられます。

データ型: logical

`SimulationModes` — Model ブロック用のシミュレーションモード
`'Normal'` (既定値) | `'Accelerator'`

Model ブロック用のシミュレーションモード。'Normal' または 'Accelerator' として指定します。このシミュレーションモード設定は変換によって作成されたモデルを参照する Model ブロックに適用されます。

データ型: char | string

`BuildTarget` — 生成するモデル参照ターゲット
`'Sim'` | `'Coder'`

生成するモデル参照ターゲット。'Sim' または 'Coder' として指定します。

'Sim' — モデル参照のシミュレーションターゲット
'Coder' — コード生成ターゲット

データ型: char

シミュレーション結果の比較

すべて折りたたむ

`CheckSimulationResults` — 変換前後のシミュレーション結果をチェックするオプション
`false` (既定値) | `true`

変換前後のシミュレーション結果をチェックするオプション。true または false として指定します。

変換を実行する前に以下のようにします。

モデルで目的のサブシステム出力信号の信号ログを有効にする。
CheckSimulationResults を true に設定する。
AbsoluteTolerance を設定する。
RelativeTolerance を設定する。
SimulationModes を元のモデルで使用されるシミュレーションモードに設定する。

シミュレーション結果間の差分が許容誤差レベルを超える場合、関数はメッセージを表示します。

データ型: logical

`AbsoluteTolerance` — 比較のための信号の絶対許容誤差
`1e-06` (既定値) | 数値スカラー

比較のための信号の絶対許容誤差。数値スカラーとして指定します。

CheckSimulationResults を true に設定した場合にのみこのオプションを使用します。

データ型: double

`RelativeTolerance` — 比較のための信号の相対許容誤差
`1e-06` (既定値) | 数値スカラー

比較のための信号の相対許容誤差。数値スカラーとして指定します。

CheckSimulationResults を true に設定した場合にのみこのオプションを使用します。

データ型: double

出力引数

すべて折りたたむ

`tf` — true または false の結果
`1` | `0` | logical 配列

True または false の結果。データ型 logical の 1 または 0 として返されます。

1 の値は変換に成功したことを示します。

Force を true に設定した場合、変換が完了すると関数は 1 の値を返します。ただし、シミュレーション結果は変換前のモデルのシミュレーション結果とは異なる場合があります。

`h` — 作成された Model ブロックのハンドル
数値配列

作成された Model ブロックのハンドル。数値配列として返されます。

データ型: double

ヒント

親サブシステムとそのサブシステムの子を同時に変換することはできません。
変換する複数のサブシステムを 1 つのコマンドで指定すると、各サブシステムを個別に変換するのに比べ、時間が節約される可能性があります。複数サブシステムの変換プロセスはモデルを 1 回コンパイルします。
変換する複数のサブシステムを指定すると、変換プロセスは各システムを変換しようとします。正常に変換されたサブシステムは、他のサブシステムの変換が失敗しても、参照モデルになります。
複数のサブシステムを指定する場合は、次の点を考慮します。
- 入力引数で、'Autofix'、'ReplaceSubsystem'、'CheckSimulationResults' を true に設定する。
- モデルでは、シミュレーション時間を短時間に設定する。
データディクショナリは、次の条件がどちらも存在する場合に変換プロセスの一部として作成するバスオブジェクトを保存します。
- 最上位モデルでデータディクショナリを使用する。
- 最上位モデルへのすべての変更が保存されている。
マスクサブシステムの動作を維持するには、次の追加のタスクを実行します。
- マスクコールバック、アイコン、端子およびドキュメンテーションに対して、参照モデルに変換する前にマスクサブシステムのバックアップコピーを作成します。変換後に、バックアップしたマスクサブシステムのマスクエディターから内容を新しい Model ブロックのマスクエディターにコピーします。
- マスクパラメーターをモデル引数で置き換えます (再利用可能な参照モデルのインスタンスのパラメーター化を参照)。
メモ
参照モデルは、マスクパラメーターを作成するためにマスク初期化コードで実現できる機能をサポートしていません。

バージョン履歴

R2006a で導入

すべて展開する

R2019a: `'BuildTarget'` 引数値 `'RTW'` は推奨されない

R2019a で、関数 Simulink.SubSystem.convertToModelReference で使用される引数値は更新されました。レガシ引数値は下位互換性のためにサポートされています。

更新された 'BuildTarget' 引数値を利用するには、'RTW' ではなく 'Coder' を使用します。

参考

Simulink.BlockDiagram.copyContentsToSubsystem | Simulink.Bus.save | Simulink.SubSystem.copyContentsToBlockDiagram

Simulink.SubSystem.convertToModelReference

構文

説明

例

モデル参照変換アドバイザーを開く

サブシステムから参照モデルへのプログラムでの変換

複数のサブシステムを参照モデルに変換する

入力引数

subsys — サブシステム名またはハンドル 数値配列 | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

model — 参照モデル名 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

名前と値の引数

AutoFix — 自動修正が可能なすべての変換の問題を修正するオプション false (既定値) | true

Force — エラーが発生しても変換を完了するオプション false (既定値) | true

DataFileName — 変換データを保存するファイルの名前 文字ベクトル

CreateWrapperSubsystem — モデル レイアウトを保持するためのラッパー サブシステムを挿入するオプション false (既定値) | true

CreateBusObjectsForAllBuses — インターフェイス定義のバス オブジェクトを作成するオプション false (既定値) | true

CopyCodeMappings — 親モデルから新しいモデルにコード マッピングをコピーするオプション false (既定値) | true

ReplaceSubsystem — Subsystem ブロックを Model ブロックと置き換えるオプション false (既定値) | true

SimulationModes — Model ブロック用のシミュレーション モード 'Normal' (既定値) | 'Accelerator'

BuildTarget — 生成するモデル参照ターゲット 'Sim' | 'Coder'

CheckSimulationResults — 変換前後のシミュレーション結果をチェックするオプション false (既定値) | true

AbsoluteTolerance — 比較のための信号の絶対許容誤差 1e-06 (既定値) | 数値スカラー

RelativeTolerance — 比較のための信号の相対許容誤差 1e-06 (既定値) | 数値スカラー

出力引数

tf — true または false の結果 1 | 0 | logical 配列

h — 作成された Model ブロックのハンドル 数値配列

ヒント

バージョン履歴

R2019a: 'BuildTarget' 引数値 'RTW' は推奨されない

参考

トピック

`subsys` — サブシステム名またはハンドル
数値配列 | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

`model` — 参照モデル名
文字ベクトル | 文字ベクトルの cell 配列 | string 配列

`AutoFix` — 自動修正が可能なすべての変換の問題を修正するオプション
`false` (既定値) | `true`

`Force` — エラーが発生しても変換を完了するオプション
`false` (既定値) | `true`

`DataFileName` — 変換データを保存するファイルの名前
文字ベクトル

`CreateWrapperSubsystem` — モデルレイアウトを保持するためのラッパーサブシステムを挿入するオプション
`false` (既定値) | `true`

`CreateBusObjectsForAllBuses` — インターフェイス定義のバスオブジェクトを作成するオプション
`false` (既定値) | `true`

`CopyCodeMappings` — 親モデルから新しいモデルにコードマッピングをコピーするオプション
`false` (既定値) | `true`

`ReplaceSubsystem` — Subsystem ブロックを Model ブロックと置き換えるオプション
`false` (既定値) | `true`

`SimulationModes` — Model ブロック用のシミュレーションモード
`'Normal'` (既定値) | `'Accelerator'`

`BuildTarget` — 生成するモデル参照ターゲット
`'Sim'` | `'Coder'`

`CheckSimulationResults` — 変換前後のシミュレーション結果をチェックするオプション
`false` (既定値) | `true`

`AbsoluteTolerance` — 比較のための信号の絶対許容誤差
`1e-06` (既定値) | 数値スカラー

`RelativeTolerance` — 比較のための信号の相対許容誤差
`1e-06` (既定値) | 数値スカラー

`tf` — true または false の結果
`1` | `0` | logical 配列

`h` — 作成された Model ブロックのハンドル
数値配列

R2019a: `'BuildTarget'` 引数値 `'RTW'` は推奨されない