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):内存分配失败。

参考

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