upgradeadvisor

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

構文

upgradeadvisor('modelname') upgrader = upgradeadvisor('modelname')

説明

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

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

モデルに対して推奨されるアップグレードをプログラムによって解析するには、upgrader オブジェクトを作成し、analyze メソッドを使用します。
モデルをプログラムによって解析およびアップグレードするには、upgrader オブジェクトを作成し、upgrade メソッドを使用します。
解析またはアップグレードを実行する前にオプションを構成するには、例を参照してください。

ヒント

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

入力引数

modelname

名前またはモデルのハンドル。文字ベクトルとして指定します。

出力引数

upgrader

モデルの階層をプログラムによって解析およびアップグレードするオブジェクト。

例

モデルのアップグレードアドバイザーを開く

vdp モデル例のアップグレードアドバイザーを開くには、次を実行します。

upgradeadvisor('vdp')

現在選択されているモデルでアップグレードアドバイザーを開くには、次を実行します。

upgradeadvisor(bdroot)

プログラムによるモデルの解析とアップグレード

upgrader オブジェクトを取得します。この例では、vdp モデルの書き込み可能なコピーを使用します。

load_system('vdp'); save_system('vdp',fullfile(tempdir, 'myvdp'))
upgrader = upgradeadvisor('myvdp')

upgrader = 

  Upgrader with properties:

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

モデルに対して推奨されるアップグレードを解析するには、ライブラリリンクとモデル参照に従って次を実行します。
```
analyze(upgrader);
```
見つかった問題に関するレポートが表示されます。
モデルを解析してすべての問題を自動的に修正するには (自動修正が利用可能な場合)、次を実行します。
```
upgrade(upgrader);
```
このコマンドはライブラリリンクとモデル参照に従って、モデルファイルに対する修正を保存します。
見つかった問題と実行されたアクションに関するレポートが表示されます。
レポートの場所を検索するには、次を実行します。
```
reportLocation = upgrader.ReportFile
```
解析またはアップグレードを実行する前に、オプションを構成することができます。
- 解析またはアップグレードを実行する前に、スキップするチェックを指定します。チェックを右クリックして [ワークスペースにチェック ID を送信] を選択することで、アップグレードアドバイザーでチェックの ID を見つけます。その後、upgrader.ChecksToSkip プロパティを設定します。次に例を示します。
```
upgrader.ChecksToSkip = {'mathworks.design.CSStoVSSConvert'};
upgrade(upgrader); 
```
- ライブラリリンクまたはモデル参照に従ったり、外部モデルとして保存されたテストハーネスを解析したりすることなく、現在のモデルでのみアップグレードアドバイザーの実行を指定します。
```
upgrader.OneLevelOnly = true; % default false
```
- ライブラリリンクではなくモデル参照に従って、現在のモデルでアップグレードアドバイザーの実行を指定します。
```
upgrader.SkipLibraries = true; % default false
```
- ブロックセットまたはツールボックスのアップグレードファイルを含む、現在のモデルでのアップグレードアドバイザーの実行を指定します。
```
upgrader.SkipBlocksets = false; % default true
```
  既定では、アップグレードアドバイザーはブロックセットまたはツールボックスのファイルをアップグレードしません。アップグレードアドバイザーは、ver の出力と Contents.m ファイルの存在から、ブロックセットを検出します。
- 解析またはアップグレードの後でレポートの表示をオフにするには、次のように設定します。
```
upgrader.ShowReport = false; % default true
```

ヒント

ヒント

アップグレードアドバイザーは、Simulink の新しい機能や設定を使用するようモデルを変更することで有益となるケースを特定することができます。アドバイザーは、新しいテクノロジーへの移行や、モデルの階層構造のアップグレードに関するアドバイスを提供します。
アップグレードアドバイザーは、Simulink 内の変更と改善によりモデルの変更が必要になっていることが原因でモデルが機能しないケースも特定することができます。
アップグレードアドバイザーは、推奨されるアクションを自動的に実行するオプションか、あるいは手動で修正する指示を提供します。