このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

Model

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

• ライブラリ:

• Simulink / Ports & Subsystems

  HDL Coder / Ports & Subsystems

• 

×

説明

Model ブロックは、モデルを別のモデルにブロックとして含めます。含められたモデルは "参照モデル" と呼ばれ、その Model ブロックを含むモデルは "親モデル" と呼ばれます。

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

既定では、参照モデルの内容は Model ブロックをダブルクリックすることで確認できます。ただし、Simulink^® Coder™ のライセンスがある場合は、モデルを保護することで、参照モデルの実装の詳細を隠すことができます。コンテンツを隠すためのモデルの保護 (Simulink Coder)を参照してください。保護モデルを受け取る場合は、サードパーティからの保護モデルの参照を参照してください。

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

端子

入力

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

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

Model ブロックには、参照するモデルの各入力端子に対して 1 つの入力端子があります。参照モデルの入力端子は Inport、In Bus Element、Trigger、および Enable ブロックによって定義されます。Model ブロックの端子の名前は、参照モデルの対応する端子の名前と一致します。Model ブロックのそれぞれの端子への入力信号は、参照モデルの対応する端子に対して有効でなければなりません。モデル参照のインターフェイスと境界を参照してください。

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

出力

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

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

Model ブロックには、参照するモデルの各出力端子に対して出力端子があります。参照モデルの出力端子は Outport ブロックおよび Out Bus Element ブロックによって定義されます。Model ブロックの端子の名前は、参照モデルの対応する端子の名前と一致します。Model ブロックの出力信号は、参照モデルの Outport ブロックおよび Out Bus Element ブロックに接続されている信号です。モデル参照のインターフェイスと境界を参照してください。

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

パラメーター

メイン

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

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

参照モデルのファイル名。文字ベクトルとして指定します。ファイルの拡張子はオプションです。

このファイル名は、モデル名で定義されているような、モデルに対する有効な MATLAB^® 識別子をもたなければなりません。

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

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

プログラムでの使用

パラメーター: 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) という語が表示されます。

モデルに対してどのシミュレーション モードでも指定することができますが、そのモデルを参照する際、Model ブロックが、その参照モデルのインスタンスのシミュレーション モードを指定します。親モデルのシミュレーション モードが Model ブロックのシミュレーション モードをオーバーライドする場合があります。オーバーライドされたシミュレーション モードを参照してください。

プログラムでの使用

パラメーター: 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 ブロックのリセット イベント端子の表示を制御します。

オフ

端子を削除します。

オン

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

依存関係

このパラメーターを有効にするには Reset Function ブロックを参照モデルに追加します。端子名を指定するには、Reset Function ブロックの Event Listener block の [イベント名] パラメーターを使用します。

プログラムでの使用

ブロック パラメーター: 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 のフィールドをもつ構造体。

モデルの例

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

この例では、別のモデルを複数回参照するモデルのシミュレーションとコード生成について詳しく説明します。この例では、Simulink® がアクセラレータ シミュレーション向けのコードを生成し、Simulink® Coder™ がスタンドアロン アプリケーションに配布できるコードを生成します。

モデルを開く

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

この例では、モデル参照変換アドバイザーツールまたは関数Simulink.SubSystem.convertToModelReferenceを使用して、サブシステムを参照モデルに変換する方法を説明します。

モデルを開く

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

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

モデルを開く

モデル参照のバリアント

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

ライブ スクリプトを開く

ブロックの特性

データ型	Boolean[a] | bus[a] | double[a] | enumerated[a] | fixed point[a] | half[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™ を使用して固定小数点システムの設計とシミュレーションを行います。

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

参考

find_mdlrefs | Simulink.SubSystem.convertToModelReference | convertToVariant | depview

トピック

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

R2006a より前に導入