Main Content

Simulink.ModelReference.refresh

Model ブロックを強制的に更新して参照モデルへの変更を反映

R2020a 以降

説明

Simulink.ModelReference.refresh(modelBlock) は、指定された Model ブロック modelBlock を更新して参照モデルへの変更を反映します。[Model ブロック バージョンの不一致] または [端子とパラメーターの不一致] コンフィギュレーション パラメーターが [エラー] に設定されている場合でもブロックが更新されます。

すべて折りたたむ

[端子とパラメーターの不一致] コンフィギュレーション パラメーターが error に設定されている親モデル内の Model ブロックをプログラムで更新できます。

モデル例を開きます。このモデルには、参照モデルが最新でない 2 つの Model ブロックが含まれています。

open_system('RefreshModelBlockModel');
Warning: Ports and parameters of Model block 'RefreshModelBlockModel/Model1' do not reflect changes in referenced model 'RefreshModelBlockMdlRef'.
Warning: Number of input ports must match between Model block 'RefreshModelBlockModel/Model1' (1) and referenced model 'RefreshModelBlockMdlRef' (2).
Warning: Ports and parameters of Model block 'RefreshModelBlockModel/Model' do not reflect changes in referenced model 'RefreshModelBlockMdlRef'.
Warning: Number of input ports must match between Model block 'RefreshModelBlockModel/Model' (1) and referenced model 'RefreshModelBlockMdlRef' (2).

model-block-refresh.png

最上位モデルで [端子とパラメーターの不一致] コンフィギュレーション パラメーターが error に設定されています。参照モデル内の入力端子と出力端子の数が 1 から 2 に増加していますが、各 Model ブロックには入力端子と出力端子が 1 つしか表示されていません。

Model ブロックの 1 つを更新します。

Simulink.ModelReference.refresh('RefreshModelBlockModel/Model');

model-block-refresh2.png

更新された Model ブロックの端子の数が、参照モデルの端子の数と一致するようになりました。もう一方の Model ブロックは変わっていません。

入力引数

すべて折りたたむ

Model ブロックの名前またはハンドル。文字ベクトル、string スカラー、または数値スカラーとして指定します。

例: Simulink.ModelReference.refresh('mymodel/Model')

例: Simulink.BlockDiagram.refreshBlocks(h) (h は Model ブロックのハンドル)

ヒント

通常 MATLAB® に表示されるよりも多くの桁を指定しなければならないため、ハンドルの数値 (5.007 など) を手動で指定しようとしないでください。ハンドルを変数に代入し、その変数の名前を使用します。

データ型: char | string | double

ヒント

モデル内のすべてのバリアント、リンク付きブロック、および Model ブロックを更新するには、関数 Simulink.BlockDiagram.refreshBlocks を使用します。この関数では、[Model ブロック バージョンの不一致] および [端子とパラメーターの不一致] コンフィギュレーション パラメーターが [なし] または [警告] に設定されている場合のみ Model ブロックが更新されます。いずれかのコンフィギュレーション パラメーターが [エラー] に設定されている場合は Model ブロックは更新されません。

代替機能

Model ブロックを選択します。Simulink® ツールストリップの [Model ブロック] タブで [更新] をクリックします。

バージョン履歴

R2020a で導入