op_dist_outcome()
摘要
使用仿真内核内置的随机数生成器,生成服从指定分布的浮点数值结果。
语法
op_dist_outcome (dist_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
dist_ptr |
Distribution* |
指向已加载分布的指针 [指向分布的指针只能从内核过程 op_dist_load() 获得。] |
返回类型
double
服从指定分布的随机变量的一个结果。若发生可恢复错误,将返回常量 OPC_DBL_INVALID。
示例
摘自:进程模型(frms_traf_gen);函数块;函数 frms_traf_gen_schedule()。
/* Determine the time at which to schedule the interrupt. */
next_pk_arrvl_time = op_sim_time () + op_dist_outcome (int_arrival_distptr);
/* Check to verify that this time is within the end time */
/* specification for this module. */
if ((next_pk_arrvl_time < gen_end_time) || (gen_end_time == FRMSC_APPL_END_OF_SIM))
{
/* Schedule the self-interrupt. */
op_intrpt_schedule_self (next_pk_arrvl_time, FRMSC_FR_APPL_TRAF_GEN);
}
详情
指定的分布可以是预定义的解析算法分布,也可以是此前已使用内核过程 op_dist_load() 加载的数值表格分布。本内核过程对表格分布执行查表,对解析算法分布(如 exponential)执行数值计算。
本内核过程使用的随机数流由对 BSD random() 过程的调用生成,并由 Dist 包的所有内核过程以及生成器模块共享。随机数流依赖于一个初始种子,可通过仿真偏好设置“seed”加以改变(详见第 1 章 “Executing a Discrete Event Simulation” 第 1 页)。若仿真输入完全相同(包括相同的随机种子),仿真结果即可复现。
注意: 偏好设置可以指定随机数流是作用于整个仿真还是按模块划分。详见“per_module_random_stream“ 第 208 页。
用途
提供一种机制,用于获取符合某个概率分布的随机值。此能力最常见的应用是计算处理器中生成的数据包之间出现的随机到达间隔时间。不过,任何应当随机分布的仿真参数都可以从分布设施导出。
大量重复调用本内核过程将生成一组符合指定分布的值。
错误
- 程序中止:段违例。(由于无效的分布指针)
- 可恢复错误:分布指针为 NIL。
参考
- 使用内核过程 op_dist_load() 加载供本内核过程使用的分布
- 使用内核过程 op_dist_uniform() 获取均匀分布的随机值
- 使用内核过程 op_dist_outcome_ext() 使用用户指定的随机数值获取分布结果
- 使用内核过程 op_dist_outcome_gen() 使用用户提供的随机数生成器获取分布结果(这些分布独立于仿真内核的随机数生成器)
- 使用内核过程 op_intrpt_schedule_self()、op_intrpt_schedule_remote() 或 op_intrpt_schedule_call() 分别安排自中断、远端中断或过程中断