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

Model

モデル階層の作成のための別のモデルの参照

• ライブラリ:

• Simulink / Ports & Subsystems

  HDL Coder / Ports & Subsystems

• 

×

説明

Modell ブロックでは、モデルをブロックとして別のモデルに含めることができます。含められたモデルは "参照モデル" と呼ばれ、(Model ブロックにより) それを保存するモデルは "親モデル" と呼ばれます。

Model ブロックは、参照モデルの最上位の入力端子と出力端子に対応する入力端子と出力端子を表示します。これらの端子を使用すると、参照モデルを親モデル内の他のブロックに接続することができます。詳細については、モデル参照を参照してください。

既定では、参照モデルの内容は、Model ブロックをダブルクリックすることで、ユーザーに対して表示されます。ただし、モデルを保護されたモデルにすることで、参照モデルの内容を非表示にすることもできます。

参照モデルとシミュレーション パラメーターを設定するには、[ブロック パラメーター] ダイアログ ボックスを開いて、[メイン] タブを使用します。モデル引数の値を指定するには、[引数] タブを使用します。

端子

入力

Input_Port_1 — 参照モデルのルートレベル Inport ブロック、Enable ブロック、Trigger ブロックに対応する入力端子

Simulink^® でサポートされる任意のデータ型の実数値または複素数値

Model ブロックは、参照モデルのルートレベルの各 Inport ブロック、Enable ブロック、または Trigger ブロックに対する入力端子を備えています。Model ブロック端子の名前は、対応する参照モデルの入力ブロックの名前と一致します。Model ブロックの入力信号は、対応する参照モデルの入力ブロックに対して有効でなければなりません。モデル参照のインターフェイスと境界を参照してください。

入力信号は、バス オブジェクト、バス配列、固定小数点、列挙データ型を含む Simulink でサポートされる任意のデータ型の実数値または複素数値をもつことができます。データ型の詳細については、Simulink でサポートされているデータ型 を参照してください。

出力

Output_Port_1 — 参照モデルのルートレベル Outport ブロックに対応する出力端子

Simulink でサポートされる任意のデータ型の実数値または複素数値

Model ブロックは、参照モデルのルートレベルの各 Outport ブロックに対する出力端子を備えています。Model ブロック端子の名前は、対応する Outport ブロックの名前と一致します。Model ブロックの出力信号は、対応する参照モデルの Outport ブロックからの信号です。モデル参照のインターフェイスと境界を参照してください。

出力信号は、バス オブジェクト、バス配列、固定小数点、列挙データ型を含む Simulink でサポートされる任意のデータ型の実数値または複素数値をもつことができます。データ型の詳細については、Simulink でサポートされているデータ型 を参照してください。

パラメーター

コンテンツ プレビュー — ブロックの表面にブロックの内容を表示する

'on' (既定値) | 'off'

ブロックの表面にブロックの内容を表示します。詳細については、モデル コンポーネントの内容のプレビューを参照してください。

プログラムでの使用

パラメーター: ContentPreviewEnabled

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'on'

[メイン] タブ

モデル名 — 参照モデルのファイル名

'' (既定値) | 文字ベクトル

参照モデルへのパス。このファイル名は、適切な MATLAB^® 識別子をもたなければなりません。たとえば、.slx のような拡張子はオプションです。このファイル名は、拡張子の .slx または .mdl を除き 60 文字を超えることはできません。

参照するモデルに移動するには、[参照] をクリックします。

指定したモデルを表示するには、[モデルを開く] をクリックします。

プログラムでの使用

パラメーター: ModelFile

型: 文字ベクトル

値: '' | '<file name>'

既定の設定: ''

シミュレーション モード — モデル参照用のシミュレーション モード

ノーマル (既定値) | アクセラレータ | ソフトウェアインザループ (SIL) | プロセッサインザループ (PIL)

Model ブロックのシミュレーション モードを指定します。Model ブロックのシミュレーション モードは、その参照モデルおよびモデル階層構造内のその他のモデルのシミュレーション モードと異なる可能性があります。

• アクセラレータ — 参照モデルに対して MEX ファイルを作成し、S-Function を実行して参照モデルを実行します。

• ノーマル — 参照モデルをインタープリターで実行します。参照モデルは、親モデル内に直接実装された Atomic Subsystem であるかのように扱われます。

• ソフトウェアインザループ (SIL) — このオプションには、Embedded Coder^® ソフトウェアが必要です。[コード インターフェイス] のパラメーター設定に基づき、量産コードを生成します。そのコードは、ホスト プラットフォーム用にコンパイルされてホスト プラットフォーム上で実行されます。

• プロセッサインザループ (PIL) — このオプションには、Embedded Coder ソフトウェアが必要です。[コード インターフェイス] のパラメーター設定に基づき、量産コードを生成します。このコードは、ターゲット プラットフォーム用にコンパイルされてターゲット プラットフォーム上で実行されます。文書化されたターゲットのコネクティビティ API は、PIL シミュレーション中に各タイム ステップでホストとターゲットの間のデータ交換をサポートします。

Model ブロックの角は、Model ブロックのシミュレーション モードを反映しています。ノーマル モードでは、角に塗りつぶしなしの三角形が表示されます。アクセラレータ モードでは、角の三角形は塗りつぶされます。SIL モードと PIL モードでは、角は塗りつぶされ、ブロック アイコンに (SIL) または (PIL) という語が表示されます。

参照モデルをラピッド アクセラレータ モードに設定できますが、シミュレーションでは参照モデルのシミュレーション モードが無視されます。モデルの階層構造内におけるシミュレーション モードの優先順位の詳細については、モデルの階層構造内のシミュレーション モードの選択を参照してください。

プログラムでの使用

パラメーター: SimulationMode

型: 文字ベクトル

値: 'Normal' | 'Accelerator' | 'Software-in-the-loop' | 'Processor-in-the-loop'

既定の設定: 'Normal'

コード インターフェイス — 最上位モデルまたは参照モデルからコードを生成する

モデル参照 (既定値) | 最上位モデル

SIL シミュレーション モードと PIL シミュレーション モードにおいて、最上位モデルからコードを生成するか、参照モデルからコードを生成するかを指定します。生成したコードを、その参照モデルを使用する大規模なアプリケーションの一部として展開する場合、[モデル参照] を指定します。生成したコードをスタンドアロン アプリケーションとして展開する場合、[最上位モデル] を指定します。

モデル参照

参照モデルからモデルの階層構造の一部として生成されたコード。コード生成には slbuild('model', 'ModelReferenceCoderTarget') コマンドが使用されます。

最上位モデル

最上位モデルからスタンドアロン コード インターフェイスで生成されたコード。コード生成には slbuild('model') コマンドが使用されます。

依存関係

このパラメーターを表示し、有効化するには、[シミュレーション モード] ドロップダウン リストから [ソフトウェアインザループ (SIL)] か [プロセッサ イン ザ ループ (PIL)] のいずれかを選択します。

プログラムでの使用

パラメーター: CodeInterface

型: 文字ベクトル

値: 'Model reference' | 'Top model'

既定の設定: 'Model reference'

モデル初期化端子を表示 — 初期化イベント端子の表示を制御する

オフ (既定値) | オン

Model ブロックにおいて、初期化イベント端子の表示を制御します。

オフ

端子を削除します。

オン

モデル初期化イベント端子を表示します。

プログラムでの使用

ブロック パラメーター: ShowModelInitializePort

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

モデル リセット端子を表示 — リセット イベント端子の表示を制御する

オフ (既定値) | オン

Model ブロックにおいて、リセット イベント端子の表示を制御します。

オフ

端子を削除します。

オン

モデル リセット イベント端子を表示します。

プログラムでの使用

ブロック パラメーター: ShowModelResetPorts

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

モデル終了端子を表示 — 終了イベント端子の表示を制御する

オフ (既定値) | オン

Model ブロックにおいて、終了イベント端子の表示を制御します。

オフ

端子を削除します。

オン

モデル ブロック端子を表示します。

プログラムでの使用

ブロック パラメーター: ShowModelTerminatePort

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

レートのスケジュール — 周期的イベント端子の表示を制御する

オフ (既定値) | オン

Model ブロックにおいて、周期的イベント端子の表示を制御します。

オフ

端子を非表示にします。

オン

レートベースのモデル用の端子を表示します。レートベースのモデルとは、接続された Inport ブロックに [サンプル時間] が指定されているモデルです。

端子レートを手動で指定するには、パラメーター AutoFillPortDiscreteRates を 'off' に設定した後、その端子レートをパラメーター PortDiscreteRates に追加してください。

プログラムでの使用

ブロック パラメーター: ScheduleRates

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

次を使用してレートをスケジュール — 周期的イベント端子の表示を制御する

Ports (既定値) | Schedule Editor

Model ブロックにおいて、周期的イベント端子の表示を制御します。

端子

レート ベースのモデルの端子を表示します。

スケジュール エディター

レート ベースのモデルのパーティションを作成します。

プログラムでの使用

ブロック パラメーター: ScheduleRatesWith

型: 文字ベクトル

値: 'Ports' | 'ScheduleEditor'

既定の設定: 'Ports'

[インスタンス パラメーター] タブ

インスタンス パラメーター — インスタンス パラメーターの表示と参照モデルの値の指定

数値 | ワークスペース変数 | 数式 | 構造体または構造体フィールド

インスタンス パラメーターを表示し、インスタンス固有の値を指定します。インスタンス パラメーターは、モデルの各インスタンスに異なる値を使用するために、参照モデルで設定されているブロック パラメーターです。

インスタンス固有の値を指定するには、テーブルの [値] 列を使用します。パラメーター値が親モデルによってオーバーライドされるように指定するには、[引数] チェック ボックスをオンにします。インスタンス パラメーターの参照モデルでの設定およびインスタンス固有の値の Model ブロックでの指定の詳細については、再利用可能な参照モデルのインスタンスのパラメーター化を参照してください。

インスタンス固有の値を変更する際に、値を変更する必要があるインスタンス パラメーターのみに対応するフィールドが含まれる部分構造体を使用できます。部分構造体に含まれていないインスタンス パラメーターは値が維持されます。この構造体には、インスタンス パラメーター名と値が含まれ、文字ベクトルとして表されます。

プログラムでの使用

ブロック パラメーター: ParameterArgumentValues

タイプ: 構造体

値: 構造体

既定の設定: フィールドのない構造体

ブロック パラメーター: InstanceParameters

型: 構造体配列

値: Name、Value、Path および Argument のフィールドをもつ構造体。

モデルの例

モデル参照によるコンポーネントベースのモデル化

この例では、Model Reference の使用方法を示します。別のモデルを複数回参照するモデルのシミュレーションとコード生成について詳しく説明します。

モデルを開く

サブシステムをモデル参照に変換

この例では、モデル参照を使用するために、バスを含んでいるモデルの変換を自動化する方法を示します。

モデルを開く

モデル参照によるデータ管理の紹介

この例では、モデル参照によるデータ管理に関する基本概念を示します。

モデルを開く

モデル参照のバリアント

この例では、モデル参照バリアントの使用方法を示します。Model ブロックは、ある Simulink® モデルを別の Simulink モデルから参照するために使用されます。Variant Subsystem ブロックにはバリアントとして Model ブロックを含めることができます。"バリアント" は、1 つの Variant Subsystem ブロックが動作できる N 個のモードのうちの 1 つを表します。各バリアントは、関連付けられているモデル固有の引数を使用して特定のモデルを参照します。シミュレーションでは、1 つのバリアントのみがアクティブになります。アクティブなバリアントは、ベース ワークスペース内の変数の値を変更するか、Variant Subsystem ブロックのダイアログを使用してバリアントの選択を手動でオーバーライドして切り替えることができます。

モデルを開く

ブロックの特性

データ型	Boolean[a] | bus[a] | double[a] | enumerated[a] | fixed point[a] | integer[a] | single[a] | string[a]
直接フィードスルー	いいえ
多次元信号	限定的[a]
可変サイズの信号	限定的[a]
ゼロクロッシング検出	いいえ
[a] 実際のデータ型または機能のサポートは、ブロックの実装に依存します。

互換性についての考慮事項

Model ブロックでのバリアント モデルの指定はサポートされなくなりました

R2019a での開始で警告

R2019a 以降、Model ブロックでのバリアント モデルの指定はサポートされなくなりました。バリアント モデルを指定するために事前に設定された Model である Model Variants ブロックもサポートされなくなりました。これらのブロックを含むモデルを読み込むと、これらはバリアントの選択を表す Model ブロックを含む Variant Subsystem ブロックに変換されます。

Variant Subsystem ブロックには、以下の利点があります。

• Model ブロックと Subsystem ブロックをバリアントの選択肢として混在させることができます。

• 入力端子と出力端子の数が異なるバリアントを指定できます。

Variant Subsystem ブロック パラメーター [ブロック線図の更新中にすべての選択肢を解析し、プリプロセッサの条件を生成する] は、Model ブロック パラメーター [プリプロセッサの条件を生成] と異なる動作をします。Variant Subsystem ブロック パラメーターは、シミュレーションを実行させてブロック線図を更新することでアクティブなバリアントのみをコンパイルするのではなく、すべてのバリアントをコンパイルします。

バリアントの Model ブロック パラメーターを使用するスクリプトがある場合、Variant Subsystem ブロック パラメーターを使用するようにそれらを更新しなければなりません。

拡張機能

C/C++ コード生成

Simulink® Coder™ を使用して C および C++ コードを生成します。

実際のコード生成のサポートは、ブロックの実装に依存します。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための Verilog および VHDL のコードを生成します。

HDL Coder™ には、HDL の実装および合成されたロジックに影響する追加のコンフィギュレーション オプションがあります。HDL コード生成への Model ブロックの使用について、およびベスト プラクティスと制限事項の詳細については、HDL コード生成でのモデル参照 (HDL Coder)を参照してください。

参照モデル用のブラック ボックス インターフェイスの生成 (HDL Coder)および参照モデルのパラメーター付きのコードの生成 (HDL Coder)も参照してください。

HDL アーキテクチャ

アーキテクチャ	説明
ModelReference (既定)	参照モデルおよび任意の入れ子にされたモデルからコードを生成する場合、[ModelReference] 実装を使用します。詳細については、参照モデルのコードの生成方法 (HDL Coder)を参照してください。
BlackBox	レガシまたは外部の HDL コードについては、[BlackBox] 実装を使用して HDL ラッパー、つまりブラック ボックス インターフェイスをインスタンス化します。ブラック ボックス インターフェイスを指定する場合、HDL Coder は参照モデルについて HDL コードの生成を試みません。 詳細については、参照モデル用のブラック ボックス インターフェイスの生成 (HDL Coder)を参照してください。

ブラック ボックス インターフェイスのカスタマイズ

[BlackBox] アーキテクチャについて、端子名をカスタマイズして、外部コンポーネントのインターフェイスの属性を設定できます。ブラック ボックスまたは HDL コシミュレーション インターフェイスのカスタマイズ (HDL Coder)を参照してください。

HDL ブロック プロパティ

BalanceDelays	あるパスに新しい遅延が導入されたことを検出し、それに一致する遅延を他のパスに挿入します。既定の設定は [inherit] です。BalanceDelays (HDL Coder)も参照してください。
ConstrainedOutputPipeline	既存の遅延を設計内で移動することによって出力に配置するレジスタの数。分散型パイプラインではこれらのレジスタは再分散されません。既定の設定は 0 です。詳細については、ConstrainedOutputPipeline (HDL Coder)を参照してください。
DistributedPipelining	パイプライン レジスタの分散、またはレジスタのリタイミング。既定の設定は [オフ] です。DistributedPipelining (HDL Coder)も参照してください。
DSPStyle	乗算器のマッピングの合成属性。既定の設定は [なし] です。DSPStyle (HDL Coder)も参照してください。
InputPipeline	生成されたコードに挿入する入力パイプライン ステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は 0 です。詳細については、InputPipeline (HDL Coder)を参照してください。
OutputPipeline	生成されたコードに挿入する出力パイプライン ステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は 0 です。詳細については、OutputPipeline (HDL Coder)を参照してください。
ReferenceModelPrefix	生成されたコードに挿入する参照モデルの接頭辞。コード ジェネレーターはこの接頭辞をサブモデル ファイル名および HDL 識別子に適用します。既定の接頭辞は modelname_ です。ここで、modelname は参照モデルの名前です。 メモ 空の接頭辞を指定すると、コード ジェネレーターはサブモデル ファイル名に接頭辞を追加しません。これによって、モデル間での名前の競合に起因する HDL コンパイル エラーが発生する可能性があります。 参照モデルを DUT として使用する場合、コード ジェネレーターは指定した接頭辞を無視します。
SharingFactor	単一の共有リソースにマッピングされる、機能的に等価なリソースの数。既定の設定は 0 です。リソース共有 (HDL Coder)も参照してください。
StreamingFactor	時間多重化されてシリアルのスカラー データ パスに変換される、パラレル データ パスの数、またはベクトルの数。既定値は 0 であり、パラレル データ パスがそのまま実装されます。ストリーミング (HDL Coder)も参照してください。

固定小数点の変換

Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

実際のデータ型のサポートは、ブロックの実装に依存します。

参考

Simulink.SubSystem.convertToModelReference | Simulink.VariantManager.convertToVariant | depview | find_mdlrefs

トピック

• 既存のモデルの参照
• 再利用可能な参照モデルのインスタンスのパラメーター化
• モデルの階層構造内のシミュレーション モードの選択

R2006a より前に導入