比较模型

模型比较使你能够比较某个特定模型或某组模型的不同版本,并查看版本之间存在哪些差异。例如,你可以将标准模型的新版本与上一版本的定制副本进行比较,以评估将定制内容延续到新版本需要多少工作。

你可以比较以下类型的模型:

  • 协议模型(标准、专用和自定义)

注意—— 你必须拥有有效许可才能比较受许可的模型。

  • 进程模型
  • 节点、链路、路径、需求和无线域模型(基础与派生)
  • 公共属性定义
  • 探针(Probe,包括 Report 和 SLA)与仿真序列(Simulation Sequence)模型
  • 数据包格式
  • ICI
  • 调制与天线方向图模型
  • 外部系统定义(ESD)模型
  • 概率密度函数(PDF)模型
  • 文本文件(例如 .ef、.ets、.ex.c 和 .gdf)

所报告的差异可以包括:

  • 目录中添加、更改或删除的模型文件
  • 添加、更改或删除的模型属性
  • 对节点模型的更改(模块、连接等)
  • 对进程模型的更改(状态、转移、代码块等)

要比较的模型版本位于两组(每组一个或多个)目录中,称为 From 目录和 To 目录。From 目录中的模型版本被视为比较的基准。To 目录中模型版本的差异相对于该基准进行报告。你可以通过为 From 和 To 目录关联描述来标识正在比较的两个版本。目录组和版本描述保存在首选项中(参见模型比较首选项)。

每次模型比较运行都会创建一个汇总文件以及每个被比较模型的一个文件。因此,输出所需的存储空间大约与被比较的模型相当。输出放置在 <user_home>\op_admin\tmp 目录中。如果生成 HTML 报告,则保存在 <user_home>\op_reports 中。

比较特定模型

使用此过程比较某个特定模型的两个版本。

过程 23:比较特定模型……

  1. 选择 File > Compare Against…

    *结果:*弹出 Compare Current Model 对话框。

  2. 为 Compare(当前)模型输入文本描述。这是在比较报告中用于标识模型版本的标签。

  3. 指定用于比较的 Against 模型:

    1. 输入模型名称以指定模型文件,或单击 Browse… 选择模型文件。

      注意: “<Same Model Name>” 指名称相同但位于相关模型目录中的模型。

    2. 为 Against 模型输入文本描述。这是在比较报告中用于标识模型版本的标签。

    3. 指定 Against 模型在比较中应视为 From 模型还是 To 模型。(From 模型被视为比较的基准;To 模型的差异相对于 From 模型进行报告。)

    4. 如果你在步骤 3.1中通过 Browse 按钮选择了模型,则目录已自动指定,可以直接转到步骤 4。

      否则,通过选择相应的单选按钮来指定包含 Against 模型的相关模型目录:

      • 选择 “'From/To' directories” 单选按钮,使用由相应首选项(mdiff_from_dirs 或 mdiff_to_dirs)指定的模型目录。如果要核实或更改这些目录,请单击 “Select 'From/To' Directories…” 按钮。
      • 选择 “Directories in 'Model Directories' preference” 单选按钮,使用 “mod_dirs” 首选项中列出的目录。
  4. 如果希望比较输出列出指定模型中找到的所有组件,请选中 “Include unchanged elements in comparison output” 复选框。未选中此复选框时,只包含 From 与 To 版本之间存在差异的模型组件。

  5. 单击 OK 开始比较。

    *结果:*比较完成后,Model Differences for <model_name> 对话框显示结果。

比较模型目录

使用此过程比较特定模型目录的两个版本(目录中的全部模型,或所选的模型子集)。

过程 24:比较模型目录……

  1. 选择 File > Manage Model Files > Compare Model Directories…

    *结果:*弹出 Compare Model Directories 对话框。

  2. 指定包含用于比较的模型文件 From 版本的模型目录。(From 模型被视为比较的基准;To 模型的差异相对于 From 模型进行报告。)

    1. 单击 Select 'From' Directories… 按钮。

      *结果:*弹出 “From/To” Model Directories 对话框。

    2. 编辑模型目录列表,使其包含所有包含待比较模型 From 版本的目录。

      *结果:*模型列表更新为包含指定模型目录中的所有模型文件。

    3. 单击 OK 关闭 “From/To” Model Directories 对话框。

    4. 为 From 目录输入文本描述。这是在比较报告中用于标识该版本的标签。

  3. 重复步骤 2,这次指定 To 模型目录。

  4. 在 Model Types 树中,使用复选框指定应包含在比较中的模型。选中复选框的模型将被比较。

  5. 如果希望比较输出列出指定模型目录中找到的所有模型(及其元素),请选中 “Include unchanged elements in comparison output” 复选框。未选中此复选框时,只包含 From 与 To 版本之间存在差异的模型。

  6. 单击 OK 开始比较。

    *结果:*比较完成后,Model Directories Differences 对话框显示结果。

Compare Current Model 对话框

用于将当前编辑器中的模型与模型的另一个版本进行比较。

此对话框包含以下控件:

Compare 控件组——包含与当前模型相关的控件。

  • Model file 标签——显示当前模型文件的路径和名称。
  • Description 文本字段——指定用于在比较报告中标识当前模型的任意标签。

Against 控件组——包含用于指定与当前模型进行比较的模型的控件。

  • Model file 文本字段——指定要比较的模型名称。
  • Browse… 按钮——打开用于选择模型文件的文件浏览器。
  • Description 文本字段——指定用于在比较报告中标识该模型版本的任意标签。
  • As: 'From' model/'To' model 单选按钮——指定你所比较的模型在比较中应视为 From 模型还是 To 模型。(From 模型被视为比较的基准;To 模型的差异相对于 From 模型进行报告。)

Associated model directories 控件组——包含用于指定包含与当前模型进行比较的模型版本的模型目录的控件。

注意: 如果你通过 Browse… 按钮选择了 Against 模型,则目录已自动指定,你无需更改此组中的控件。

注意: 以下控件名称中包含 'From' 或 'To',具体取决于所选的 As 单选按钮。

Include unchanged elements in comparison output 复选框——指定比较输出应列出所有模型组件,还是只列出 From 与 To 版本之间存在差异的组件。选中此复选框时,所有模型组件都会被包含(并且比较输出可能大得多)。

OK 按钮——使用新的首选项值开始比较并关闭对话框。

Cancel 按钮——关闭对话框而不执行比较。模型比较首选项不会被更改。

Compare Model Directories 对话框

用于指定进行比较的两组模型文件。

此对话框包含以下控件:

From & To directories for comparison 控件组——包含用于指定包含待比较模型的目录的控件。(From 目录中的模型文件被视为比较的基准;在 To 模型中发现的差异相对于 From 模型进行报告。)

Model directories 区域

Textual descriptions 区域

  • From: 字段——指定用于在比较输出中标识 From 版本的任意标签。
  • To: 字段——指定用于在比较输出中标识 To 版本的任意标签。

Model Types 树——列出 From 或 To 目录中包含的所有模型。使用复选框选择应包含在比较中的模型。

From Path、To Path 表——列出每个模型所在的模型目录路径(From 和 To),如适用。

Include unchanged elements in comparison output 复选框——指定比较输出应列出所有模型组件,还是只列出 From 与 To 版本之间存在差异的组件。选中此复选框时,所有模型组件都会被包含(并且比较输出可能大得多)。

OK 按钮——使用新的首选项值开始比较并关闭对话框。

Cancel 按钮——关闭对话框而不执行比较。模型比较首选项不会被更改。

Model Directories Differences 对话框

用于查看特定模型目录两个版本之间的差异(目录中的全部模型,或所选的模型子集)。

此对话框包含以下控件:

Model Types 树——列出 From 和 To 模型目录中包含的所有被比较模型。(这些是在 Compare Model Directories 对话框中指定的模型。)

你可以将光标移到 Model Types 节点或某个单独的类型节点(例如 C Include File 节点)上方,以查看包含所发现差异摘要的工具提示。

树中每个模型名称之前都有一个表示比较结果(未更改、已修改、已添加或已删除)的图标。单击已更改模型的名称可打开 Model Differences for <model_name> 对话框,该对话框显示有关该模型更改的详细信息。

From: <description>、To: <description> 表——列出每个模型所在的模型目录路径(From 和 To)。对于已更改的模型,包含已更改版本的目录以彩色表格单元格标识。

Display tree elements representing 控件组——包含用于指定模型类型树内容的控件。

  • Modified files 复选框——指定 From 与 To 版本之间存在差异的模型是否包含在模型类型树中。选中此复选框时,已更改的模型会被包含。
  • Unchanged files 复选框——指定 From 与 To 版本之间没有差异的模型是否包含在模型类型树中。选中此复选框时,未更改的模型会被包含。
  • Removed files 复选框——指定仅存在于 From 目录中的模型是否包含在模型类型树中。选中此复选框时,已删除的模型会被包含。
  • Added files 复选框——指定仅存在于 To 目录中的模型是否包含在模型类型树中。选中此复选框时,已添加的模型会被包含。

Generate HTML Report… 按钮——生成比较输出的 HTML 表示,与其在此对话框中的显示一致。

Model Differences for <model_name> 对话框

用于查看某个特定模型两个版本之间的差异。

此对话框包含以下控件:

Model element 树——列出已更改模型的元素。树中每个模型元素之前都有一个表示比较结果(相等、不同、已添加或已删除)的图标。

From: <description>、To: <description> 表——列出模型 From 和 To 版本中每个元素的值。对于已更改的元素,发生更改的值以彩色表格单元格标识。如果值为 “<Text: # lines>”(如函数块和代码),你可以单击该表格单元格以显示两个版本之间的文本差异。

Display tree elements representing 控件组——包含用于指定模型元素树内容的控件。

  • Different elements or subtrees 复选框——指定 From 与 To 版本之间存在差异的模型元素是否包含在模型元素树中。选中此复选框时,已更改的元素或包含已更改、已添加或已删除元素的子树会被包含。
  • Equal elements or subtrees 复选框——指定 From 与 To 版本之间没有差异的模型元素是否包含在模型元素树中。选中此复选框时,未更改的元素和子树会被包含。
  • Removed 'From' elements or subtrees 复选框——指定仅存在于 From 版本中的模型元素是否包含在模型元素树中。选中此复选框时,已删除的元素和子树会被包含。
  • Added 'To' elements or subtrees 复选框——指定仅存在于 To 版本中的模型元素是否包含在模型元素树中。选中此复选框时,已添加的元素和子树会被包含。

Generate HTML Report… 按钮——生成比较输出的 HTML 表示,与其在此对话框中的显示一致。

“From/To” Model Directories 对话框

用于编辑 mdiff_from_dirs('From' Model Directories)或 mdiff_to_dirs('To' Model Directories)首选项的值。要打开此对话框,请在某个模型比较对话框中单击 Edit 'From' Model Directories… 或 Edit 'To' Model Directories… 按钮。

此对话框包含以下控件:

Editing preference <name> 标签——标识此对话框实例将更改哪个首选项。

Path 表——列出单击 OK 时将包含在首选项值中的目录。每个路径之后的 Include Sub-directories? 复选框指定是否也包含该目录的子目录。选中时,子目录会被包含。

Insert 按钮——为新目录在目录表中添加一行。你可以输入目录路径,或单击文件夹图标打开用于选择目录的浏览器。

Delete 按钮——从列表中删除所选目录。

Move Up 按钮——将所选目录在列表中上移。使用此按钮将某个目录在查找特定模型文件时更早搜索。

Move Down 按钮——将所选目录在列表中下移。使用此按钮将某个目录在查找特定模型文件时更晚搜索。

Copy 'Model Directories' Preference 按钮——用 “mod_dirs”(Model Directories)首选项指定的所有目录替换当前目录列表。

OK 按钮——将正在编辑的首选项值更改为与该列表一致并关闭对话框。

Cancel 按钮——关闭对话框而不更改首选项值。

模型比较与复合属性

执行模型比较时,在某些情况下,复合属性的 Default Value 属性所报告的差异可能造成误导。这是因为复合属性值在内部的处理方式。

复合属性的默认值可以是隐式的(未赋值,因此等于各子属性的默认值)或显式的(在复合属性属性中设置)。隐式默认值始终以 “(…)” 报告给模型比较,而显式默认值则报告为每个子属性的一个值。因此,当某个复合属性在模型的 From 版本中具有隐式默认值时,你会看到以下影响:

  • 情形 1:To 版本对子属性默认值做了更改——复合属性的隐式默认值已更改,但模型比较将 Default Value 属性报告为未更改,因为它在 From 和 To 版本中都看到 “(…)”。
  • 情形 2:To 版本具有显式默认值——模型比较正确地将 Default Value 属性报告为已更改。但是,默认值显示为已添加(而不是已更改),因为 To 版本中的隐式默认值没有报告任何值。

下图显示了这些影响。

图 14:模型比较中的复合属性(Compound Attributes in Model Comparison)

模型比较中的复合属性

模型比较首选项

模型比较功能使用以下首选项。

模型差异新增元素颜色(Model Difference Added Element Color)

指定在表格单元格中用于指示该值在 'To' 版本中被添加的颜色。

标签 数据类型 默认值
mdiff_added_element_color color #AAFFAA #AAFFAA 颜色样本

模型差异修改元素颜色(Model Difference Modified Element Color)

指定在表格单元格中用于指示该值在 'To' 版本中被修改的颜色。

标签 数据类型 默认值
mdiff_modified_element_color color #FFFF77 #FFFF77 颜色样本

模型差异修改树颜色(Model Difference Modified Tree Color)

指定在表格单元格中用于指示相应树中的某个元素已被添加、修改或删除的颜色。

标签 数据类型 默认值
mdiff_modified_tree_color color #E16000 #E16000 颜色样本

模型差异删除元素颜色(Model Difference Removed Element Color)

指定在表格单元格中用于指示该值在 'To' 版本中被删除的颜色。

标签 数据类型 默认值
mdiff_removed_element_color color #FFAAAA #FFAAAA 颜色样本

指定在表格单元格中用于指示单击所显示文本将在 Web 浏览器中显示相应 HTML 页面的颜色。

标签 数据类型 默认值
mdiff_text_link_color color #0000FF #0000FF 颜色样本

模型 HTML 制表符大小(Model HTML Tab Size)

指定在 HTML 输出中用于表示 'Tab' 字符的空格数量。

标签 数据类型 默认值
mdiff_tab_size integer 4

模型 HTML 换行宽度(Model HTML Wrap Size)

指定在 HTML 输出的一列中显示的一行文本被“换行”到下一显示行之前所显示的最大字符数。

标签 数据类型 默认值
mdiff_wrap_size integer 80

模型文本差异脚本(Model Text Difference Script)

指定要调用的程序或脚本的名称,用于检查文本块或文件之间的差异。

标签 数据类型 默认值
mdiff_diff_prog string “”

'From' 文本描述('From' Text Description)

与 'From' 模型版本关联的文本描述。

标签 数据类型 默认值
mdiff_from_description string “”

'From' 模型目录('From' Model Directories)

包含 'From' 模型版本的目录列表。路径后跟 “/...” 表示应包含所有子目录进行比较。

标签 数据类型 默认值
mdiff_from_dirs string “”

'To' 文本描述('To' Text Description)

与 'To' 模型版本关联的文本描述。

标签 数据类型 默认值
mdiff_to_description string “”

'To' 模型目录('To' Model Directories)

包含 'To' 模型版本的目录列表。路径后跟 “/...” 表示应包含所有子目录进行比较。

标签 数据类型 默认值
mdiff_to_dirs string “”

模型比较图标

表 12:模型比较图标

图标 含义
相等 相等
不同 不同
已添加 已添加
已删除 已删除
所有子元素相等 所有子元素相等
部分子元素不同 部分子元素不同
所有子元素已添加 所有子元素已添加
所有子元素已删除 所有子元素已删除

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com