bdroot

R2026b

現在のシステムの最上位モデル

ページ内をすべて折りたたむ

構文

model = bdroot
model = bdroot(elements)

説明

model = bdroot は、現在のシステムの最上位モデルを返します。

現在のシステムとは、次のいずれかです。

  • 編集中は、最後にクリックしたサブシステム、または最後にクリックしたブロックを含むサブシステム。最後にクリックしたものがモデルの階層構造の最上位にある場合は、現在のシステムはモデルです。

  • S-Function ブロックを含むモデルのシミュレーションの実行中は、現在評価されている S-Function ブロックを含むサブシステム。評価されている S-Function がモデルの階層構造の最上位にある場合は、現在のシステムはモデルです。

  • コールバックが呼び出されたときは、コールバックを呼び出しているモデル、サブシステム、またはブロック。コールバックの実行中に現在のシステムが変更される可能性があります (たとえば、ブレークポイントを設定した場合や、エディターを操作した場合など)。

  • 関数 MaskInitialization の評価中は、マスクが評価されているブロックを含むサブシステム。マスクがモデルの階層構造の最上位にある場合は、現在のシステムはモデルです。

  • load_system 関数を使用して最後にメモリに読み込まれたモデル。

    load_system 関数を使用してモデルを読み込んだ後に現在のシステムを変更した場合、load_system 関数を使用してそのモデルを再度読み込んでも、そのモデルは現在のシステムになりません。モデルを現在のシステムにするには、モデルを閉じてから、load_system 関数を使用してモデルを再読み込みします。

例

model = bdroot(elements) は、指定されたモデル要素の最上位モデルを返します。bdroot 関数を使用するには、elements の各要素が読み込まれている必要があります。

例

例

すべて折りたたむ

Simulink® で開かれている myModel1 という名前のモデルがあるとします。モデルには Subsystem ブロックと Model ブロックが含まれています。Model ブロックは myModel2 という名前のモデルを参照しています。

サブシステム内に移動します。

現在のモデルの最上位モデルを取得します。

bdroot
'myModel1'

モデル参照内に移動します。

現在のモデルの最上位モデルを取得します。

bdroot
'myModel2'

Subsystem ブロックを含む読み込み済みのモデルがあるとします。サブシステムには、ハンドルが hBlock である Gain ブロックが含まれています。

Gain ブロックを含む最上位モデルのハンドルを取得します。

hTopLevel = bdroot(hBlock);

入力引数

すべて折りたたむ

最上位モデルを取得するモデルまたはモデル要素。1 つ以上のハンドル、モデル名、ファイル パス、またはブロック パスとして指定します。ハンドルは数値スカラーまたは数値配列の形式に設定します。モデル名、モデル パス、およびブロック パスは、string、string 配列、文字ベクトル、または文字ベクトルの cell 配列の形式に設定します。

ハンドルとパスの取得については、Get Handles and Pathsを参照してください。

ヒント

gcs、gcb および gcbh を指定して bdroot を使用することで、現在のシステムまたはブロックの最上位モデルを取得します。

例: "myModel/mySubsystem"

データ型: double | array of doubles | string | string array | character vector | cell array of character vectors

出力引数

すべて折りたたむ

最上位モデル。elements 引数と同じデータ型のハンドルまたはモデル名として返されます。複数の element 引数を指定した場合、関数は配列を返します。

データ型: double | array of doubles | string | string array | character vector | cell array of character vectors

バージョン履歴

R2006a より前に導入

参考

| |

トピック