文档

比较Simuli万博1manbetxnk模型XML文件

浏览Simulink XM万博1manbetxL比较报告

您可以选择一对Simulink万博1manbetx®模型来比较它们的XML文件。您可以使用来自任何版本的Simulink的模型。万博1manbetxXML比较工具根据SLX文件生成一个比较报告。您可以使用该报告来探索差异,查看原始模型中突出显示的更改,并合并差异。

XML比较报告只显示更改,而不是整个XML文本文件内容。该报告显示了两个XML文件中不同部分的层次视图。报告没有显示文件中相同的部分。要了解该报告,请参见关于Simu万博1manbetxlink模型XML比较

跨越差异,使用比较选项卡。移动到下一组或上一组差异,在比较选项卡,在导航部分,单击箭头按钮转到上一个或下一个差异。看到逐步改变

您也可以单击,选择层次树中的项目,观察以下显示特征:

  • 选中的项目将在框中高亮显示。

  • 如果选择的项目是匹配对的一部分,它会在左树和右树的一个框中突出显示。

  • 当您选择一个项目时,将显示原始模型并突出显示相应的项目。看到探索原始模型中的更改

报告项目高亮显示每个差异的性质如下:

报告项目的类型 高亮显示 笔记
修改 粉红色的

修改项是两个文件之间不同的匹配对。当您选择一个修改项时,它会在两个树中的一个框中突出显示。
修改后的节点对示例:


所选对的更改参数将显示在单独的参数审查小组。如果字符串太长而不能显示在参数表,右键单击并选择作为文本进行比较打开一个新的参数比较。
参数修改示例:

无与伦比的 绿色

当您选择一个不匹配的项目时,它只在一个树的框中突出显示。
不匹配节点示例:

容器 没有一个

没有高亮显示的行表示容器项包含其他修改或不匹配的项。
容器节点的示例:

图标表示项目的类别,例如:模型、子系统、状态流®机器或图表、块、线、参数等。

要展开或筛选树视图,请使用视图工具条上的TAB控件,用于以下功能:

  • 全部展开-展开树中的每一项。

      提示右键单击可展开或折叠所选树节点中的层次结构。

  • 全部折叠-将树中的所有项目折叠到尽可能紧凑的视图。

  • 过滤器—打开Filter列表。选择复选框以启用或禁用报告中更改类别的显示。使用过滤器只显示您感兴趣的更改。默认情况下,报告隐藏了所有非功能性的更改,比如项的重新定位。关闭滤镜进行探索所有差异包括非功能性的变化。看到过滤差异

如果你想交换文件,在比较选项卡上,选择交换双方.该报告交换了双方,并重新进行了比较。刷新也再运行分析。

要创建新报告,请参见选择Simul万博1manbetxink模型进行XML比较

有关带有说明的示例,请参见XML比较示例

逐步改变

比较选项卡,在导航部分,当您单击下一个箭头键(或者当报表有焦点时按下向下键),您将按以下顺序逐步遍历报表中的更改组:

  1. 第一次点击下一个,它选择左侧树中第一个更改(粉色)或插入(绿色)的节点。

  2. 步骤通过差异下一个按钮。

    • 当选中的项目在右树中有匹配时,它们也会被高亮显示。

    • Next跳过没有颜色背景的白色节点。白色节点是层次结构中不包含差异的部分。

    • 如果对子节点进行插入或删除,下一个如果子节点也是插入或删除,则跳过它们。例如,如果你插入一个子系统,下一个选择顶层子系统节点,然后跳过子系统内的所有节点(如果它们都是插入)并选择下一个差异。

    • 下一个在模型中高亮显示时最小化上下文切换。当你点击下一个,在移动到报告的下一个级别之前,报告在报告的左树和右树中逐步遍历模型、子系统或图表的同一级别上的所有差异。例如,在转移到另一个子系统之前,您将逐步检查左树和右树中一个子系统的所有差异。

  3. 当你经历了所有的变化,下一个返回到左树的开头。

如果单击报表中的一个项目,则下一个/以前的控件将从您所选择的点逐级执行更改。

探索原始模型中的更改

当您比较来自Simulink®模型的XML文本文件时,您可以在选择报表项时选择在原万博1manbetx始模型中显示相应的项。您可以使用这个反向注释函数来研究原始模型中的更改。当您选择一个项目时,报告调用对原始模型的反向注释,并突出显示模型中相应的项目。

控件控制显示视图选项卡模型中的亮点按钮和总是强调复选框。

    提示单击一个子系统内容节点,可以看到报告突出显示子系统中所有可见的修改对象。

详情请参见在原始模型中显示项目

合并差异

    提示只能从左向右归并。如果您想合并到另一个文件,请使用交换双方在开始合并之前。Swap Sides将恢复已经进行的任何合并,并为原始文件创建一个新的比较报告。

控件上的以下按钮可合并所选内容比较选项卡,在合并部分:

  • 合并节点—将所选节点从报表左侧向右侧合并。

  • 合并参数—将所选参数从报表左侧合并到右侧。

  • 撤销所有—恢复所有合并操作。

有关更多信息,请参见合并比较报告万博1manbetx中的Simulink模型

打开选定节点的子比较报告

如果可以对特定节点进行额外的比较,则可以看到比较按钮以打开该对节点的报告。例如,如果模型工作区中存在差异,您可以单击比较打开一个新的报告来探索变量的差异。

你可以打开子报告的参数,MATLAB函数块,真值表和模型工作区。

  • 要比较参数,请单击parameters窗格,然后在比较选项卡选择比较所选参数.这将为当前选择的一对参数打开一个新报告。当报告不能显示Parameters窗格中的所有细节时,例如,长字符串或脚本时,使用此选项。

  • 如果原始模型包含MATLAB函数块组件,如果发现差异,XML比较工具将在报告的Stateflow部分列出它们。单击比较按钮,在比较工具中打开新的比较,显示MATLAB函数块组件的文本差异报告。您可以合并差异在MATLAB函数块代码从文本比较报告。看到合并比较报告万博1manbetx中的Simulink模型的例子。slxml_radar_matlab_function

  • 如果原始模型包含真值表,并且发现了差异,XML比较工具将在报告的Stateflow部分列出它们。

    • 单击比较按钮,查看所有更改的摘要。

    • 单击truthtable节点反向注释并显示truthtable编辑器。

    • 单击比较按钮的末尾条件表节点打开一个只显示条件差异的新文本比较。

    • 类似地单击比较按钮动作表只查看动作更改。

    参见示例slxml_truthtables

了解报表层次结构和匹配

的分层节点标记(例如子系统标记). xml文件)作为嵌套节点出现在树中两次。这是因为容器节点和内容的属性可以有单独的差异。XML报告的这个特性允许您区分节点本身的属性差异,以及嵌套的节点中包含的差异。

要理解XML比较报告中的匹配结果,请参见匹配算法是如何工作的MATLAB®报告生成器™文档。

    注意:分析可能无法检测到分离过多的文件先前对应部分之间的匹配。

如果无法在报告中看到预期的更改,则在视图选项卡,单击过滤器按钮来关闭过滤器并查看所有确认更改。看到过滤差异

比较信号构建块

当您没有接触Signal Builder块时,您可以看到它们的差异。这是因为当您加载模型时,Signal Builder块会生成新的句柄。报告显示句柄已经改变。要查看差异,请单击比较按钮,并观察被调用的句柄blockH而且modelH是不同的。

过滤差异

您可以使用过滤器按钮上的视图选项卡来控制更改类别的显示。关闭过滤以查看所有确认更改。

过滤器列表中,选择复选框以启用或禁用报告中更改类别的显示。使用过滤器只显示您感兴趣的更改。默认情况下,报告隐藏了所有非功能性的更改,比如项的重新定位。关闭筛选器以探索所有差异,包括非功能性更改。如果无法在报告中看到预期的更改,请尝试此操作。

过滤类别包括:

  • 隐藏行中的更改.隐藏对信号线的所有更改,包括功能更改。

  • 隐藏非功能性更改.报表处理将XML文件中的某些项标识为非功能项,例如,表示诸如块、系统、图表或标签位置等参数的标记、块和行的字体和颜色设置以及系统打印和显示设置。报告处理试图将“结果性”更改识别为非功能性的更改(也就是说,作为另一个更改的结果的更改)。例如,如果块名称从block_Ablock_B,从该块中出现的一行在其源块参数中发生了变化。这种对线路参数的更改被认为是非功能性的。线是高度功能性的,但是线的变化可能非常嘈杂,因为它们连接到的块的变化。

  • 隐藏图形界面中的更改.该信息是模型顶层导入和导出的摘要。筛选图形界面更改,以避免在报告中出现重复,因为根端口中的任何更改也会作为功能更改报告,您可以使用反向注释。

  • 隐藏块参数默认值中的更改.在默认值中隐藏更改可以避免报告中的重复,因为块中的任何更改也会报告为可以使用反向注释的功能更改。块参数默认值是Simulink XML文件中没有文档记录的部分,用于存储模型中使用的块的默认参数。万博1manbetx

异常

这份报告确实如此将对块和系统名称、注释和状态流注释的更改过滤为非功能性的,即使对这些项的更改不会影响模拟的结果。报告总是显示这些更改,以方便对代码更改的审查,因为它们可以包含关于用户意图的重要信息。

在某些罕见的情况下,报告会过滤掉可能影响设计行为的更改。默认情况下,移动被过滤为非功能性的,但在以下情况下,移动可以改变设计行为:

  • 移动块在某些情况下会改变执行顺序。

  • 在状态流图中,如果移动状态或连接使其相交,则模型将无法进行模拟。

要在报告中查看这些类型的更改,请关闭非功能性更改的筛选器。

改变颜色偏好

您可以更改和保存比较工具的不同颜色首选项。您可以将您的颜色首选项应用于所有比较类型。

  1. 在MATLAB Home选项卡上,单击首选项

  2. 在Preferences对话框中,单击MATLAB,点击比较

  3. 根据需要编辑颜色设置以进行差异和合并。查看颜色样本窗格。

    活动设置列表显示默认(修改)

  4. 若要在比较中使用修改后的设置,请单击应用并刷新比较报告。

  5. 若要返回默认颜色设置,请在“首选项”对话框中单击重置并点击应用.刷新比较报告。

  6. 如果您想保存修改后的颜色首选项以便在将来的MATLAB会话中使用,请单击另存为.为您的颜色设置配置文件输入一个名称并单击好吧

    保存设置后,可以在活动设置列表。

保存比较结果

要保存比较结果,请使用这些比较选项卡按钮:

  • 另存为>超文本标记语言,或基本的HTML-打开“保存”对话框,在这里您可以选择保存XML比较报告的可打印版本。看到保存可打印的HTML报告

  • 另存为>工作空间变量-导出XML比较结果到工作区。看到将结果导出到工作区

相关的例子

更多关于

这个话题有帮助吗?