op_dist_outcome_ext()
摘要
使用用户指定的随机数值,生成服从指定分布的浮点数值结果。
语法
op_dist_outcome_ext (dist_ptr, rndm_num)
| 参数 | 类型 | 说明 |
|---|---|---|
dist_ptr |
Distribution * |
指向已加载分布的指针 [指向分布的指针只能从内核过程 op_dist_load() 获得。] |
rndm_num |
double |
一个介于零(含)与一(不含)之间均匀分布的随机数,用于获取符合 dist_ptr 参数所指定分布的随机结果。(见详情小节中的注意。) |
返回类型
double
服从指定分布的随机变量的一个结果。若发生可恢复错误,将返回常量 OPC_DBL_INVALID。
示例
/* Obtain the specified value for the mean calls per slot of the traffic source. */
op_ima_obj_attr_get (op_id_self (), "mean_calls_per_slot", &mean_calls_per_slot);
/* Load in the poisson distribution for number of new calls per slot. */
callgen_dist_ptr = op_dist_load ("poisson", mean_calls_per_slot, 0.0);
/* Set up the seed for BSD’s random number generator. */
/* Use the seed specified via this module’s attribute. */
op_ima_obj_attr_get (op_id_self(), "callgen_seed", &callgen_seed);
initstate (callgen_seed, (char*) &callgen_rand_state, 8);
setstate (callgen_rand_state);
rand_val = (unsigned int) random ();
/* Normalize to the zero-one interval */
uniform_rand_val = (double) rand_val / ((double) 0x7FFFFFFF + 1.0);
/* Since this is the first slot, obtain the number of calls to initiate. */
num_new_calls = op_dist_outcome_ext (callgen_dist_ptr, uniform_rand_val);
for (num_new_calls; num_new_calls > 0; num_new_calls--)
op_pk_send (op_pk_create_fmt ("atm_cell"), PHYS_PORT);
详情
指定的分布可以是预定义的解析算法分布,也可以是此前已使用内核过程 op_dist_load() 加载的数值表格分布。本内核过程对表格分布执行查表,对解析算法分布(如 exponential)执行数值计算。
本内核过程作为 op_dist_outcome() 的替代方案提供。后者依赖 BSD 随机数生成器 random() 生成的随机数,并且为仿真中所有随机数的标准使用者(如生成器、误码计算等)共享其随机数流。(两个内核过程的)所有随机变量结果都是先获取一个均匀分布的随机数,再用该值对指定分布的累积分布函数求逆来实现的。通过允许指定这个均匀随机数,本内核过程使得可以将任意数量、来自用户自选随机数生成器的独立随机数流集成到仿真中。
本内核过程的示例小节展示了利用状态变量为流量生成器的每个实例创建独立状态的进程模型代码。状态内存用于通过 BSD 随机数生成器 random() 分别设置种子并维护随机数流;在配置足够状态时,该生成器可以具有极长的周期。创建独立随机数流更容易的方式是使用 op_prg_random_gen_create() 和 op_prg_random_double_gen()。
注意: 在大多数情况下,op_dist_outcome_ext() 不会扰动仿真内核的随机数流。但若 dist_ptr* 引用以下任一分布,则不适用:Binomial、Erlang、Extreme、Laplace、Lognormal、Normal、Pareto、Rayleigh 和 Weibull。若要完全独立于仿真内核的随机数流,请使用 op_dist_outcome_gen()。
如果想使用 Normal 分布,可以通过使用 Fast Normal 代替 Normal 分布,来保证 op_dist_outcome() 的结果可复现(即结果不受对 op_dist_outcome_ext() 的调用影响)。请记住,这种变通方法会产生对 Normal 分布“更粗糙”的近似;详见图 29 Normal and Fast Normal PDF Definition。
用途
本内核过程为那些希望绕过内核过程 op_dist_load() 所依赖的默认随机数生成的用户提供了替代方案。这样做的原因可能在于需要为不同用途分离随机数来源,或者需要使用具有不同特性的随机数生成器。
大量重复调用本内核过程将生成一组符合指定分布的值。在大多数情况下,本内核过程允许绕过仿真内核的内部随机数生成器;例外情况见详情小节。
错误
- 程序中止:段违例。(由于无效的分布指针)
- 可恢复错误:分布指针为 NIL。
- 可恢复错误:随机数(
<rndm_num>)超出范围。(若传入的值不满足 >= 0 且 <1)
参考
- 使用内核过程 op_dist_load() 创建分布
- 使用内核过程 op_dist_outcome() 使用内核内置的随机数生成器获取分布结果
- 使用内核过程 op_dist_outcome_gen() 使用用户提供的随机数生成器获取分布结果(这些分布独立于仿真内核的随机数生成器)
- 使用内核过程 op_dist_uniform() 获取均匀分布的随机数