op_cvov

一个从输出向量文件(文件类型后缀 .ov)中提取标量和向量信息到制表符分隔的文本文件(.csv)的工具,以便将其导入电子表格进行分析。

说明

当需要处理数量非常庞大的向量时,从 Results Browser 导出数据可能不太方便。你可以使用 op_cvov 从一个或多个输出向量文件中提取所选信息。例如,你可以

  • 获取所有向量“名称”的列表(层次名称列表,可通过某个正则表达式加以限制)
  • 提取所选向量的数据(基于向量名称列表)
  • 提取标量数据

偏好

本程序支持以下偏好集:

本程序还支持以下附加偏好。

data_precision

指定数据值的最大小数位数。

  • Type: integer
  • Default Value: 12

m

指定要从中提取统计量的文件列表。文件可以通过三种方式指定:

  • “<project-scenario>-DES-<run#>” 指某个特定的输出文件
  • “<project-scenario>” 指该场景的所有输出文件
  • “<project>” 指该项目中所有场景的全部输出文件

此偏好为必需项,且只能从命令行输入。

  • Type: string list
  • Default Value: <empty>

nosymbols

指定输出中是否应使用符号值。当为 TRUE 时,在有数值可用的情况下将不使用符号值。

  • Type: boolean
  • Default Value: FALSE

output_file_path

指定输出数据(制表符分隔)的输出文件名。该偏好的取值中必须包含文件路径和文件类型后缀。此偏好为必需项,且只能从命令行输入。

  • Type: string
  • Default Value: none

scalar

指定是否应从指定文件中提取标量信息。当为 TRUE 时,提取标量信息。此偏好只能从命令行输入。

  • Type: boolean
  • Default Value: FALSE

thousand_separator

指定数字中是否应包含当前区域的千位分隔符。当为 TRUE 时,包含千位分隔符。

  • Type: boolean
  • Default Value: FALSE

time_precision

指定时间值的最大小数位数。

  • Type: integer
  • Default Value: 12

vector_data

指定是否应从指定文件中提取向量信息。当为 TRUE 时,提取向量信息。此偏好只能从命令行输入。

  • Type: boolean
  • Default Value: FALSE

vector_data_format

指定在输出的时间/数据部分之前,为每个统计量生成哪些数据行。各行按字符串中字符的顺序生成。该偏好的字符串取值使用以下字符:

  • H – 层次名称

  • O – 对象名

  • S – 统计量名

  • R – 报告

  • F – 文件名

  • d – 日期

  • h – 时/分/秒

  • a – 注释

  • # – 元素数量

  • Type: string

  • Default Value: “HOSRFdha#”

vector_header

指定是否应从指定文件中提取向量头信息。当为 TRUE 时,提取向量头信息。此偏好只能从命令行输入。

  • Type: boolean
  • Default Value: FALSE

vector_header_format

指定在每个统计量头条目中,文件名之后生成哪些数据列。各列按字符串中字符的顺序生成。该偏好的字符串取值使用以下字符:

  • ' ' – (空格或制表符):额外列
  • H – 层次名称
  • O – 对象名
  • S – 统计量名
  • R – 报告
  • F – 文件名(显示以下元素所必需)
  • d – 日期
  • h – 时/分/秒
  • a – 注释
  • # – 元素数量
  • t – 最小时间
  • T – 最大时间
  • m – 最小值
  • M – 最大值
  • [ – 第一个值
  • ] – 最后一个值
  • e – 期望值
  • - – 样本均值
  • v – 方差
  • s – 标准差

H、O、S、R 信息仅对第一个文件打印。

  • Type: string
  • Default Value: “HOSRFdha#tTnM[]e-vs”

vector_max_time

指定报告数据的最大仿真时间。在此时间之后生成的统计量数据不会从输出向量文件中提取。负值表示仿真结束时间。此偏好只能从命令行输入。

  • Type: double
  • Default Value: –1

vector_min_time

指定报告数据的最小仿真时间。在此时间之前生成的统计量数据不会从输出向量文件中提取。此偏好只能从命令行输入。

  • Type: double
  • Default Value: 0

vector_patterns

将向量输出限制为与某个指定层次模式匹配的统计量。模式可以包含以下标记:

  • * – 可用于表示完整层次名称中的任意项
  • … – 可放置在模式的开头或结尾,分别表示模式其余部分的任意前缀或后缀

此偏好为必需项,且只能从命令行输入。

  • Type: string list
  • Default Value: “”

verbose

指定 op_cvov 在运行时是否应生成进度信息。当为 TRUE 时,生成进度信息。此偏好只能从命令行输入。

  • Type: boolean
  • Default Value: FALSE

示例用法

一个包含 4 次运行的场景的输出示例(仅显示该组中的一个统计量):

% op_cvov -output_file_path /home/abc/mydata.txt -vector_header -vector_data -m s89050-modeling_approach_purely_micro_simulation
Hierarchical Name Annotation Statistic Report File Start Date Start Time Annotation # elements Min Time Max Time Max Val 1st Val Last Val Expected Value Sample Mean Variance Standard Deviation
Dallas <-> Atlanta [0].point-to-point.queuing delay (sec) --> Dallas <-> Atlanta [0] --> point-to-point.queuing delay (sec) s89050-modeling_approach_purely_micro_simulation-DES-1 101 0 1500 0.000008179012 0.000005709877 0.000003858025 0.000003900892 0.000003900892 0 0.000000504719
s89050-modeling_approach_purely_micro_simulation-DES-2 101 0 1500 0.000008179012 0.000005709877 0.000003858025 0.000003900892 0.000003900892 0 0.000000504719
s89050-modeling_approach_purely_micro_simulation-DES-3 101 0 1500 0.000008179012 0.000005709877 0.000003858025 0.000003900892 0.000003900892 0 0.000000504719
s89050-modeling_approach_purely_micro_simulation-DES-4 101 0 1500 0.000008179012 0.000005709877 0.000003858025 0.000003900892 0.000003900892 0 0.000000504719

...

Hierarchical name Dallas <-> Atlanta [0].point-to-point.queuing delay (sec) -->
Object Dallas <-> Atlanta [0] -->
Statistic point-to-point.queuing delay (sec)
Report
File s89050-modeling_approach_purely_micro_simulation-DES-4 s89050-modeling_approach_purely_micro_simulation-DES-4 s89050-modeling_approach_purely_micro_simulation-DES-4 s89050-modeling_approach_purely_micro_simulation-DES-4
Start date unspecified unspecified unspecified unspecified
Start time unspecified unspecified unspecified unspecified
Annotation
Number of values 101 101 101 101
Sim time Value Value Value Value
0 0.000005709877 0.000005709877 0.000005709877 0.000005709877
15 0.000008179012 0.000008179012 0.000008179012 0.000008179012
30 0.000003858025 0.000003858025 0.000003858025 0.000003858025
45 0.000003858025 0.000003858025 0.000003858025 0.000003858025
60 0.000003858025 0.000003858025 0.000003858025 0.000003858025

...

1485 0.000003858025 0.000003858025 0.000003858025 0.000003858025
1500 Vector end Vector end Vector end Vector end

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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