Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

アップグレード アドバイザー

モデルの改善と現在のリリースへのアップグレード

説明

アップグレード アドバイザーは、モデルを改善して現在のリリースにアップグレードするために使用します。

アップグレード アドバイザーは以下に役立ちます。

  • Simulink® の動作の変更や改良によって機能しなくなったモデルを特定する。

  • Simulink の新しくリリースされた機能や設定を使用して拡張できるモデルを特定する。

  • 自動アップグレードを実行するか、手動で修正する指示を提供することで、新しいテクノロジーへの移行やモデルの階層構造のアップグレードを行う。

モデルでのアップグレード アドバイザーの使用の詳細については、アップグレード アドバイザーの使用を参照してください。

Upgrade Advisor tool

アップグレード アドバイザー を開く

  • Simulink エディター: [モデル化] タブで [モデル アドバイザー][アップグレード アドバイザー] を選択します。

  • MATLAB® コマンド ウィンドウ:

    upgradeadvisor("modelname")

  • モデル アドバイザー: モデル アドバイザーで [アップグレード アドバイザー] をクリックします。

すべて展開する

  1. vdp モデル例のアップグレード アドバイザーを開きます。

    openExample("vdp.slx");
    upgradeadvisor("vdp")
    

  2. 現在選択されているモデルのアップグレード アドバイザーを開きます。

    upgradeadvisor(bdroot)
    

この例では、モデルを解析してアップグレードし、自動修正が利用可能な場合に適用する方法を示します。

1. モデルを読み込み、upgrader オブジェクトを作成します。この例では、モデル例を読み込んで開くために、モデルを含むプロジェクトを開きます。

openProject("ModelReferenceHierarchy");
upgrader = upgradeadvisor("sldemo_mdlref_depgraph.slx")
upgrader = 
  Upgrader with properties:

      ChecksToSkip: {}
     SkipLibraries: 0
     SkipBlocksets: 1
      OneLevelOnly: 0
        ShowReport: 1
    VerboseLogging: 0
         RootModel: 'sldemo_mdlref_depgraph'
        ReportFile: ''

Run "upgrade" on this Upgrader object to analyze and automatically upgrade your models.

2. ライブラリ リンクとモデル参照に従って、モデルに対して推奨されるアップグレードを解析します。

analyze(upgrader);
(1/14) Analyzing Model "sldemo_mdlref_depgraph"
(2/14) Analyzing Model "sldemo_mdlref_heat2cost"
(3/14) Analyzing Model "sldemo_mdlref_house"
(4/14) Analyzing Model "sldemo_mdlref_F2C"
(5/14) Analyzing Model "sldemo_mdlref_outdoor_temp"
(6/14) Analyzing Model "sldemo_mdlref_thermostat"
(7/14) Analyzing Model "sldemo_mdlref_heater"
(8/14) Analyzing Model "sldemo_mdlref_heat2cost" using compile time information
(9/14) Analyzing Model "sldemo_mdlref_house" using compile time information
(10/14) Analyzing Model "sldemo_mdlref_F2C" using compile time information
(11/14) Analyzing Model "sldemo_mdlref_outdoor_temp" using compile time information
### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_F2C is up to date.

Build Summary

0 of 1 models built (1 models already up to date)
Build duration: 0h 0m 2.1551s
### Starting serial model reference code generation build.
### Checking status of model reference code generation target for model 'sldemo_mdlref_F2C' used in 'sldemo_mdlref_outdoor_temp'.
### Checking for structural changes in sldemo_mdlref_F2C because the model reference rebuild option is set to 'If any changes detected'. Structural changes cause the model reference code generation target to be rebuilt.
### Checking for structural changes in model reference code generation target for: sldemo_mdlref_F2C
### Generating code and artifacts to 'Model specific' folder structure
### Code for the model reference code generation target for model sldemo_mdlref_F2C is up to date because no functional changes were found in referenced model.
### Model reference code generation target for sldemo_mdlref_F2C is up to date.

Build Summary

0 of 1 models built (1 models already up to date)
Build duration: 0h 0m 1.3025s

### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_F2C is up to date.

Build Summary

0 of 1 models built (1 models already up to date)
Build duration: 0h 0m 1.4746s
(12/14) Analyzing Model "sldemo_mdlref_thermostat" using compile time information
(13/14) Analyzing Model "sldemo_mdlref_heater" using compile time information
### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_thermostat is up to date.

Build Summary

0 of 1 models built (1 models already up to date)
Build duration: 0h 0m 1.4151s
### Starting serial model reference code generation build.
### Checking status of model reference code generation target for model 'sldemo_mdlref_F2C' used in 'sldemo_mdlref_heater'.
### Checking for structural changes in sldemo_mdlref_F2C because the model reference rebuild option is set to 'If any changes detected'. Structural changes cause the model reference code generation target to be rebuilt.
### Checking for structural changes in model reference code generation target for: sldemo_mdlref_F2C
### Generating code and artifacts to 'Model specific' folder structure
### Code for the model reference code generation target for model sldemo_mdlref_F2C is up to date because no functional changes were found in referenced model.
### Model reference code generation target for sldemo_mdlref_F2C is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_thermostat' used in 'sldemo_mdlref_heater'.
### Checking for structural changes in sldemo_mdlref_thermostat because the model reference rebuild option is set to 'If any changes detected'. Structural changes cause the model reference code generation target to be rebuilt.
### Checking for structural changes in model reference code generation target for: sldemo_mdlref_thermostat
### Generating code and artifacts to 'Model specific' folder structure
### Code for the model reference code generation target for model sldemo_mdlref_thermostat is up to date because no functional changes were found in referenced model.
### Model reference code generation target for sldemo_mdlref_thermostat is up to date.

Build Summary

0 of 2 models built (2 models already up to date)
Build duration: 0h 0m 2.0631s

### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_thermostat is up to date.

Build Summary

0 of 1 models built (1 models already up to date)
Build duration: 0h 0m 1.5653s
(14/14) Analyzing Model "sldemo_mdlref_depgraph" using compile time information
### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_F2C is up to date.
### Model reference simulation target for sldemo_mdlref_thermostat is up to date.
### Model reference simulation target for sldemo_mdlref_heat2cost is up to date.
### Model reference simulation target for sldemo_mdlref_house is up to date.
### Model reference simulation target for sldemo_mdlref_outdoor_temp is up to date.

Build Summary

0 of 5 models built (5 models already up to date)
Build duration: 0h 0m 0.7038s
### Starting serial model reference code generation build.
### Checking status of model reference code generation target for model 'sldemo_mdlref_F2C' used in 'sldemo_mdlref_depgraph:sldemo_mdlref_heater'.
### Model reference code generation target for sldemo_mdlref_F2C is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_thermostat' used in 'sldemo_mdlref_depgraph:sldemo_mdlref_heater'.
### Model reference code generation target for sldemo_mdlref_thermostat is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_heat2cost' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_heat2cost is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_house' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_house is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_heater' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_heater is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_outdoor_temp' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_outdoor_temp is up to date.

Build Summary

0 of 6 models built (6 models already up to date)
Build duration: 0h 0m 0.77985s

### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_F2C is up to date.
### Model reference simulation target for sldemo_mdlref_thermostat is up to date.
### Model reference simulation target for sldemo_mdlref_heat2cost is up to date.
### Model reference simulation target for sldemo_mdlref_house is up to date.
### Model reference simulation target for sldemo_mdlref_outdoor_temp is up to date.

Build Summary

0 of 5 models built (5 models already up to date)
Build duration: 0h 0m 0.68423s

3. 出力を指定してレポートの場所を検索します。

reportLocation = upgrader.ReportFile;

4. モデルを解析またはアップグレードする前にオプションを構成します。

  • 既定では、upgradeadvisor はアップグレード プロセス時にモデルのバックアップ コピーを生成します。バクアップ ファイルの生成をオフにするには、EnableBackups プロパティを設定します。

upgrader.EnableBackups = false;
  • チェックをスキップするには、アップグレード アドバイザーでチェックを右クリックして [ワークスペースにチェック ID を送信] を選択し、ChecksToSkip プロパティを設定します。

upgrader.ChecksToSkip = {"mathworks.design.CSStoVSSConvert"};
  • ライブラリ リンク、モデル参照、または外部モデルとして保存されたテスト ハーネスを解析せずに現在のモデルを解析またはアップグレードするには、OneLevelOnly プロパティを有効にします。

upgrader.OneLevelOnly = true;
  • 現在のモデルとモデル参照をライブラリ リンクなしで解析またはアップグレードするには、SkipLibraries プロパティを有効にします。

upgrader.SkipLibraries = true;
  • 現在のモデルとブロックセットまたはツールボックスのファイルを解析またはアップグレードするには、SkipBlocksets プロパティを無効にします。既定では、アップグレード アドバイザーはブロックセットまたはツールボックスのファイルをアップグレードしません。アップグレード アドバイザーは、関数 ver の出力と Contents ファイルの存在から、ブロックセットを検出します。

upgrader.SkipBlocksets = false;
  • モデルの解析またはアップグレードの後のレポートの表示をオフにするには、ShowReport プロパティを無効にします。

upgrader.ShowReport = false;

5. モデルをアップグレードし、自動修正が利用可能な場合は適用します。

upgrade(upgrader);
(1/2) Upgrading Model "sldemo_mdlref_depgraph"
(2/2) Upgrading Model "sldemo_mdlref_depgraph" using compile time information
### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_F2C is up to date.
### Model reference simulation target for sldemo_mdlref_thermostat is up to date.
### Model reference simulation target for sldemo_mdlref_heat2cost is up to date.
### Model reference simulation target for sldemo_mdlref_house is up to date.
### Model reference simulation target for sldemo_mdlref_outdoor_temp is up to date.

Build Summary

0 of 5 models built (5 models already up to date)
Build duration: 0h 0m 0.66955s
### Starting serial model reference code generation build.
### Checking status of model reference code generation target for model 'sldemo_mdlref_F2C' used in 'sldemo_mdlref_depgraph:sldemo_mdlref_heater'.
### Model reference code generation target for sldemo_mdlref_F2C is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_thermostat' used in 'sldemo_mdlref_depgraph:sldemo_mdlref_heater'.
### Model reference code generation target for sldemo_mdlref_thermostat is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_heat2cost' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_heat2cost is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_house' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_house is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_heater' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_heater is up to date.
### Checking status of model reference code generation target for model 'sldemo_mdlref_outdoor_temp' used in 'sldemo_mdlref_depgraph'.
### Model reference code generation target for sldemo_mdlref_outdoor_temp is up to date.

Build Summary

0 of 6 models built (6 models already up to date)
Build duration: 0h 0m 0.67922s

### Starting serial model reference simulation build.
### Model reference simulation target for sldemo_mdlref_F2C is up to date.
### Model reference simulation target for sldemo_mdlref_thermostat is up to date.
### Model reference simulation target for sldemo_mdlref_heat2cost is up to date.
### Model reference simulation target for sldemo_mdlref_house is up to date.
### Model reference simulation target for sldemo_mdlref_outdoor_temp is up to date.

Build Summary

0 of 5 models built (5 models already up to date)
Build duration: 0h 0m 0.99939s

アップグレード アドバイザーで見つかった問題と自動修正のリストが表示されます。

アップグレード アドバイザーでモデル ファイルに対する修正が保存されます。

関連する例

プログラムでの使用

すべて展開する

upgradeadvisor("modelname") は、modelname により指定されたモデルのアップグレード アドバイザーを開きます。このコマンドは必要に応じてモデルを読み込みますが、Simulink エディターでモデルを開くことはありません。アップグレード アドバイザーを使用して、現在のリリースの機能を用いてモデルをアップグレードおよび改善します。

upgrader = upgradeadvisor("modelname") は、プログラムによるモデルの階層の解析とアップグレードに使用できるオブジェクトを返します。出力を指定した場合、アップグレード アドバイザーは開かれません。関数 upgradeadvisor によって返される upgrader オブジェクトでオブジェクト関数の analyzeupgrade を使用できます。

  • モデルに対して推奨されるアップグレードをプログラムで解析するには、upgrader オブジェクトを作成し、オブジェクト関数 analyze を使用します。

  • モデルをプログラムで解析およびアップグレードするには、upgrader オブジェクトを作成し、オブジェクト関数 upgrade を使用します。

  • モデルを解析またはアップグレードする前にオプションを構成する方法の詳細については、プログラムによるモデルの解析とアップグレードを参照してください。

ヒント

プロジェクト全体のアップグレード方法を示す例については、プロジェクトを使用した Simulink モデルのアップグレードを参照してください。

バージョン履歴

R2012b で導入