op_stat_write_t()
摘要
向指定的统计量写入一个 (time,value) 对。值和时间均作为该内核过程的参数给出。
语法
op_stat_write_t (stat_handle, value, time)
| 参数 | 类型 | 说明 |
|---|---|---|
stat_handle |
Stathandle |
标识接收更新值的全局或局部统计量的统计量句柄 [统计量句柄可通过内核过程 op_stat_reg() 获得。] |
value |
double |
要写入指定统计量的值 |
time |
double |
用作为输出向量新条目横坐标的值 [该值不一定与仿真时间相关,之所以称为“time”是因为大多数向量都以该变量作为横坐标。] |
返回类型
void
无返回值。
示例
/* obtain the arriving packet */
pkptr = op_pk_get (INPUT_STRM);
/* determine the bulk size of the packet */
bulk_size = op_pk_bulk_size_get (pkptr);
/* If the statistic handle for received packet size has not yet */
/* been initialized, do so now. */
if (pk_size_init == OPC_FALSE)
{
pk_size_shandle = op_stat_reg ("Packet Size (bits)", OPC_STAT_INDEX_NONE,
OPC_STAT_GLOBAL);
pk_size_init = OPC_TRUE;
}
/* write out the bulk size of the packet as a global statistic. Don’t */
/* use current time as the independent variable, but instead the time at */
/* which the packet was created. */
op_stat_write_t (pk_size_shandle, (double) bulk_size,
op_pk_creation_time_get (pkptr));
详情
该内核过程向为指定全局或局部统计量收集的输出向量追加一个新的 (time, value) 对。统计量只能通过类型为 Stathandle、且已通过调用内核过程 op_stat_reg() 初始化的变量来引用。使用初始化不当的句柄调用该内核过程可能导致可恢复的仿真错误。
仿真模型中的不同过程若使用同一统计量句柄,可以通过该内核过程向同一输出向量写入值。内核过程 op_stat_reg() 利用传入的统计量名称与同一统计量的其他来源“会合(rendezvous)”,将数据多路复用到一个输出向量。一个向量可以同时接收来自该内核过程和 op_stat_write() 的值。写入新 (time, value) 对的输出向量名称只在通过 op_stat_reg() 注册统计量时指定。
对应的输出向量按该内核过程报告条目的顺序存储。由于 time 值可以是任意数字,所得的向量未必有序。
要在输出向量文件中生成数据,必须由在 Probe Editor 中定义的探测对象,或通过 Project Editor 中的 Select statistics 操作选定的探测对象对统计量进行探测。包含该探测的探测文件名由仿真的 probe 属性指定。要记录所有全局统计量,设置仿真的 record_gstats 属性。就统计量连线(statistic wire)而言,该内核过程与 op_stat_write() 的行为完全相同。
用途
向输出向量贡献一个新值,并以用户指定的时间作为标记。
当用向量关联两个变量且二者均非时间,或横坐标变量不是当前时间时(如本节示例所示),通常使用该内核过程代替 op_stat_write()。
错误
- 程序中止(Program Abort):段违例(Segmentation violation)。(由无效统计量句柄引起)
- 可恢复错误(Recoverable Error):试图使用未注册的统计量句柄。
参考
- 使用内核过程 op_stat_local_read() 读取输入统计量的当前值
- 使用内核过程 op_stat_write() 向输出统计量写入以当前仿真时间标记的值
- 使用内核过程 op_stat_scalar_write() 向标量统计量写入值
- 使用内核过程 op_stat_obj_reg() 访问任意链路、路径、模块或子模块对象的统计量
- 使用内核过程 op_stat_reg() 获取统计量句柄