本页采用了机器翻译。点击此处可查看英文原文。

ModelAdvisor.SystemResult

访问系统级模型顾问结果

全页展开

说明

查看使用 run 方法获取的模型顾问结果。

创建对象

要访问 SystemResult 对象的属性，请将 getResults 方法应用于 Advisor.Application 对象。如果使用 ModelAdvisor.run 运行模型顾问，它将以 SystemResult 对象的形式返回结果。您可以直接访问对象属性。

属性

全部展开

模型顾问分析的模型或子系统。

数据类型: char

模型顾问分析的模型组件的类型。

数据类型: char

不同状态的检查数，以结构体形式返回。返回的结构体包含以下字段：

  • NotRun — 未运行的模型顾问检查数

  • Information — 包含信息的模型顾问检查数

  • Passed — 通过的模型顾问检查数

  • Justified — 已申述的模型顾问检查数

  • Warning — 发出警告的模型顾问检查数

  • Failed — 失败的模型顾问检查数

  • Incomplete — 未完全运行的模型顾问检查数

数据类型: structure

包含每个模型顾问检查的 ModelAdvisor.CheckResult 对象的元胞数组。访问这些对象属性以获取模型顾问检查结果。

返回正在使用的 Simulink® 版本、MATLAB® 版本和模型版本的详细信息，以结构体返回。返回的结构体包含以下字段：

  • SimulinkVersion - 正在使用的 Simulink 版本详情

  • MATLABVersion - 正在使用的 MATLAB 版本详情

  • ModelVersion - 当前使用的模型版本详情

以结构体返回配置设置、理由、排除项、选项和分析持续时间的详细信息。返回的结构体包含以下字段：

  • ConfigurationFile - 正在使用的配置文件名

  • JustificationFile - 生成的申述文件的名称

  • ExclusionFile - 包含需要从分析中排除的检查列表的文件名

  • AnalysisOptions - 模型顾问分析选项的详细信息，以结构体的形式返回。返回的结构体包含以下字段：

    分析选项描述
    DisplayResults

    正在使用的模型顾问的结果显示设置。

    'Summary'（默认）| 'Details' | 'None'

    • 'Summary' - 在命令行窗口中显示系统结果摘要。

    • 'Details' - 在命令行窗口中显示被检查系统的实时进度更新、每次检查的通过和失败结果以及系统结果摘要。

    • 'None' - 命令行窗口中不显示任何信息。

    TempDir

    指示是否正在使用模型顾问的临时工作文件夹设置。

    'on'（默认）| 'off' |

    • 'on' - 从临时工作文件夹运行模型顾问，以避免在使用并行池运行时出现并发问题。

    • 'off' - 在当前工作文件夹中运行模型顾问。

    Force

    指示是否正在使用模型顾问的强制删除设置。

    'on'（默认）| 'off' |

    • 'on' - 删除现有的 modeladvisor/system 文件夹。

    • 'off' - 在删除现有的 modeladvisor/system 文件夹之前提示您。

    ShowExclusions

    指示是否正在使用模型顾问报告的报告排除显示设置。

    'on'（默认）| 'off' |

    • 'on' - 列出报告中的模型顾问检查排除项。

    • 'off' - 报告中未列出模型顾问检查排除项。

    TreatAsMdlRef

    指示模型是否被视为参考模型。

    []（默认）| 'on' | 'off'

    • [] - 系统中有引用的模型。

    • 'on' - 模型用作参考模型。

    • 'off' - 模型未用作参考模型。

    ParallelMode

    指示模型顾问的并行执行设置是否正在使用。

    'off' (默认) | 'on'

    • 'off' - 模型顾问不支持并行模式运行。

    • 'on' - 如果您拥有 Parallel Computing Toolbox™ 许可证和多核计算机，模型顾问将以并行模式运行。每个并行处理一次对一个模型运行检查。

    ExtensiveAnalysis

    指示是否正在使用模型顾问的扩展分析设置。

    'on' (默认) | 'off'

    • 'on' - 模型顾问运行所有检查，包括触发广泛分析的检查。

    • 'off' - 模型顾问不会运行触发广泛分析的检查。

    LogVerbosity

    指示是否提供日志信息的详细信息，例如错误、警告和调试详细信息。

    'None'（默认）| 'Concise' | 'Verbose'

    • 'None' - 无分析日志信息

    • 'Concise' - 包含错误和警告的适量信息

    • 'Verbose' - 包含错误、警告和调试详情的完整信息

    LogFile包含日志信息的日志文本文件名。
    ReportFormat

    生成的模型顾问报告格式。

    'html'（默认）| 'pdf' | 'docx'

    • 'html' - 模型顾问报告为 HTML 格式。

    • 'pdf' - 模型顾问报告为 PDF 格式。

    • 'docx' - 模型顾问报告为 DOCX 格式

    ReportPath生成的模型顾问报告所在的文件夹路径。
    ReportName模型顾问报告的名称。

  • AnalysisTimeStamp - 时间详情，以 DD-MMM-YYYY HH:MM:SS 格式指示分析完成时间。

对象函数

getCheckResults查看特定模型顾问检查结果

示例

全部折叠

此示例说明如何对从 sldemo_mdlref_basic 引用的模型 sldemo_mdlref_counter 运行检查。

在命令行窗口中，打开模型 sldemo_mdlref_basic 和被引用的模型 sldemo_mdlref_counter。

openExample('sldemo_mdlref_basic'); 
openExample('sldemo_mdlref_counter');

将模型的副本保存到工作文件夹，将它们重命名为 mdlref_basic 和 mdlref_counter。

save_system('sldemo_mdlref_basic','mdlref_basic');
save_system('sldemo_mdlref_counter','mdlref_counter');

在 mdlref_basic 中，将模型引用从 sldemo_mdlref_counter 更改为 mdlref_counter。保存 mdlref_basic。

set_param('mdlref_basic/CounterA','ModelName','mdlref_counter');
set_param('mdlref_basic/CounterB','ModelName','mdlref_counter');
set_param('mdlref_basic/CounterC','ModelName','mdlref_counter');
save_system('mdlref_basic');

将根模型设置为 mdlref_basic。

RootModel='mdlref_basic';

创建一个 Application 对象。

app = Advisor.Manager.createApplication();

设置根分析。

setAnalysisRoot(app,'Root',RootModel);

从模型顾问分析中清除检查实例。

deselectCheckInstances(app);

使用检查实例 ID 选择检查标识未连接的信号线、输入端口和输出端口。

instanceID = getCheckInstanceIDs(app,'mathworks.design.UnconnectedLinesPorts');
checkinstanceID = instanceID(1);
selectCheckInstances(app,'IDs',checkinstanceID);

运行模型顾问分析。

run(app);

获取分析结果并查看 ModelAdvisor.SystemResult 和 ModelAdvisor.CheckResult 对象的属性。

Results=getResults(app);

生成并查看模型顾问报告。模型顾问对 mdlref_basic 和 mdlref_counter 都运行检查。

report = generateReport(app);
web(report)

关闭模型。

close_system('mdlref_basic');
close_system('mdlref_counter');

版本历史记录

在 R2015b 中推出

全部展开

另请参阅

|