Main Content

upgradeadvisor

打开升级顾问

语法

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

说明

upgradeadvisor('modelname')modelname 指定的模型打开升级顾问。此命令根据需要加载模型,但不会在 Simulink® 编辑器中打开模型。可以使用升级顾问帮助您用最新版本来升级和改进模型。

upgrader = upgradeadvisor('modelname') 返回可用于以编程方式分析和升级模型层次结构的对象。如果您指定输出,则升级顾问不会打开。您可以对 upgradeadvisor 函数的 upgrader 对象输出使用 analyzeupgrade 方法。

  • 要以编程方式分析模型是否适合推荐的升级,请创建 upgrader 对象并使用 analyze 方法。

  • 要以编程方式分析并升级模型,请创建 upgrader 对象并使用 upgrade 方法。

  • 要在运行分析或升级之前配置选项,请参阅示例

提示

有关如何以编程方式升级整个工程的示例,请参阅Upgrade Simulink Models Using a Project

输入参数

modelname

模型的名称或句柄,指定为字符向量。

输出参数

upgrader

用于以编程方式分析和升级模型层次结构的对象。

示例

在模型上打开升级顾问

要在 vdp 示例模型上打开升级顾问,请运行:

upgradeadvisor('vdp')

针对当前所选模型打开升级顾问:

upgradeadvisor(bdroot)

以编程方式分析和升级模型

  1. 获取一个 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: ''
    

  2. 要分析模型是否适合推荐的升级、跟踪库链接和模型引用,请运行:

    analyze(upgrader);
    您会看到发现的问题报告。

  3. 要分析模型并自动修复所有问题(如果有可用的自动修复程序),请运行:

    upgrade(upgrader);

    此命令可跟踪库链接和模型引用,并将所有修复保存到模型文件中。

    您会看到发现的问题以及所采取行动的报告。

  4. 要找到此报告的位置,请运行:

    reportLocation = upgrader.ReportFile

  5. 您可以在运行分析或升级之前配置选项。

    • 在运行分析或升级之前指定要跳过的检查。在升级顾问中,通过右键点击检查并选择将检查 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

提示

有关如何以编程方式升级整个工程的示例,请参阅Upgrade Simulink Models Using a Project

提示

  • 升级顾问能够识别出在哪些情况下,更改模型以使用 Simulink 中的新功能和新设置对您有利。升级顾问会向您提供过渡到新技术以及升级模型层次结构的建议。

    如果 Simulink 中所做的更改和改进要求您更改模型后模型才能工作,升级顾问也能识别出这些情况。

    升级顾问会提供自动执行建议操作的选项,或者提供手动修复的说明。

替代方法

您也可以从 Simulink 编辑器中打开升级顾问。在建模选项卡中,选择模型顾问 > 升级顾问

另外,也可以从模型顾问中打开升级顾问。在模型顾问中,在 By Task 检查下,展开文件夹 Upgrading to the Current Simulink Version 并选择检查 Open the Upgrade Advisor

版本历史记录

在 R2012b 中推出