op_stat_scalar_write_symbol()
摘要
向标量统计量写入一个符号值。
语法
op_stat_scalar_write_symbol (stat_name, str_value, value)
| 参数 | 类型 | 说明 |
|---|---|---|
stat_name |
const char * |
目标标量统计量的名称 |
str_value |
const char * |
要写入的符号值 |
value |
double |
相关联的数值(可选;若无则设为 OPC_NA_DBL_UNSPEC) |
返回类型
void
无返回值。
示例
/* At end of simulation, scalar performance statistics */
/* and input parameters are written out. */
/* Only one station needs to do this */
if (!fddi_sink_scalar_write)
{
/* set the scalar write flag */
fddi_sink_scalar_write = 1;
ete_delay = fddi_sink_accum_delay / fddi_sink_total_pkts;
if (ete_delay >= 10)
op_stat_scalar_write_symbol ("Mean End-to-End Delay", “Critical”, 3.0);
else if (ete_delay >= 5)
op_stat_scalar_write_symbol ("Mean End-to-End Delay", “Marginal”, 2.0);
else
op_stat_scalar_write_symbol ("Mean End-to-End Delay", “Acceptable”, 1.0);
op_stat_scalar_write ("Throughput (bits/sec)",
fddi_sink_total_bits / op_sim_time ());
op_stat_scalar_write ("Peak End-to-End Delay (sec.)", fddi_sink_peak_delay);
op_stat_scalar_write ("TTRT (sec.)", Fddi_T_Opr);
}
详情
标量统计量可以在仿真期间的任何时刻写入。多次调用该内核过程会为同一个标量统计量创建多个值;绘制这类统计量时,会在同一个横坐标值上产生多个纵坐标值。
标量统计量的值记录在由仿真 ov_file 偏好指定的输出向量文件中。与向量数据不同,除非指定了向量输出文件名,否则不会写入标量数据。换句话说,仿真的默认行为是不记录任何标量数据,即使执行了 op_stat_scalar_write_symbol() 调用也是如此。
用途
提供了一种将用户自定义的符号值(以及可选的相关数值)作为指定标量统计量写入的机制。写入的值保存在仿真的向量输出文件中。标量统计量用于捕捉与时间无关的汇总值,例如随时间变化的状态量的平均值、最终值或最大值。
错误
- 程序中止(Program Abort):段错误。(由于无效的标量统计量名称字符串)
- 可恢复错误(Recoverable Error):内存分配失败。
参考
- 使用内核过程 op_stat_local_read() 读取输入统计量的当前值
- 使用内核过程 op_stat_scalar_write() 向标量统计量写入数值
- 使用内核过程 op_stat_write() 向输出统计量写入值,并以当前仿真时间标记
- 使用内核过程 op_stat_write_t() 向输出统计量写入值,并以指定仿真时间标记