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