ドキュメンテーション センター

  • 評価版
  • 製品アップデート

目次

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Simulink.SubSystem.convertToModelReference

Atomic Subsystem または Function-Call Subsystem をモデル参照に変換する

構文

[success,mdlRefBlkH] = Simulink.SubSystem.convertToModelReference(subsys, mdlRef, 'opt1', 'val1', ... , 'optN', 'valN')

説明

[success,mdlRefBlkH] = Simulink.SubSystem.convertToModelReference(subsys, mdlRef, 'opt1', 'val1', ... , 'optN', 'valN') は、Atomic Subsystem または Function-Call Subsystem を参照先モデルに変換します。関数は、新規モデルを作成し、サブシステムの内容をモデルにコピーし、新規モデルのコンフィギュレーション パラメーターを設定し、モデルのルート レベルの Inport ブロックおよびOutport ブロックを設定します。関数は、入力オプション ReplaceSubsystem に応じて、新規モデルを参照する Model ブロックでサブシステム ブロックを置き換えるか、あるいは新規モデルを参照する Model ブロックを含む別の一時 モデルを作成します。

サブシステムから参照モデルへの変換は、モデルに以下のコンフィギュレーション パラメーター設定が必要です。

  • [コンフィギュレーション パラメーター]、[最適化]、[インライン パラメーター] が [オン]

  • [コンフィギュレーション パラメーター]、[診断]、[データ有効性]、[信号の関連付け] が [明示的のみ]

  • [コンフィギュレーション パラメーター]、[診断]、[接続性]、[Mux ブロックをバス信号の作成に使用] が [エラー]

次のコマンドを使用して、これらのパラメーターをこの関数で必要な値に設定できます。

set_param(mdlName, 'InlineParams', 'on');
set_param(mdlName, 'SignalResolutionControl', 'UseLocalSettings');
set_param(mdlName, 'StrictBusMsg', 'ErrorLevel1');

この関数は、取り扱うことができないモデルやサブシステムに対して、エラー メッセージまたは警告メッセージを生成します。

  • エラーによっては、キャンセルあるいは継続の選択を行うためのメッセージ ボックスが表示されます。

  • 継続が不可能な場合は、Simulink® は継続の選択を提示せずに変換をキャンセルします。

変換が成功した場合でも、ユーザーの必要条件を満たすために結果のモデルを再構成する必要があることもあります。

新規モデル内で、各ルート入力端子の Interpolate data パラメーターは、既定の設定で選択済みです。この既定の設定が適切でないときはパラメーターをクリアすることができます。内挿データの詳細は、Inport ブロックのドキュメンテーションを参照してください。

入力引数

subsys

変換される Atomic Subsystem ブロックの完全な名前またはハンドル。

mdlRef

サブシステムを変換して作成する新しいモデルの名前。

opt1, val1, ... , optN, valN

変換プロセスを制御する省略可能なオプションとその値のペア。オプションと値は次のとおりです。

'ReplaceSubsystem'オプション値は Boolean です。このオプション値が true の場合、サブシステムからモデルが作成され、そのモデルを参照するモデル ブロックがそのサブシステム ブロックの代わりに使用されます。このオプションが省略された場合や false の場合、サブシステムから作成したモデルを参照するモデル ブロックが作成されて開きます。既定値: false
'BusSaveFormat'オプション値は 'Cell' または 'Object' です。このオプションが指定された場合、作成されるバス オブジェクトはファイルに保存されます。値はファイル形式を指定します。オブジェクトをコンパクトな形式で保存するには、セル配列を使用します。このオプションが省略された場合、バス オブジェクトはファイルに保存されません。
'BuildTarget'オプション値は 'Sim' または 'RTW' です。オプションが指定されると、指定に従って Sim または RTW のモデル参照ターゲットが新しいモデル用に作成されます。このオプションが省略されると、モデル参照ターゲットは作成されません。
'Force'オプション値は Boolean です。値が true の場合、変換処理を停止するようなエラーがあれば警告が表示されますが、変換は続行されます。これによって、この関数を変換の最初のステップを行うために使用し、その後手動で変換過程を終わらせることができます。このオプションが省略された場合や false が指定された場合、エラーが発生すると変換処理は停止します。既定値: false

出力引数

success

true は変換が正常に完了したことを示し、そうでなければ false になります。

mdlRefBlkH

新しいモデルを参照する Model ブロックのハンドル。

参考

| | |

チュートリアル

この情報は役に立ちましたか?