op_dist_outcome_gen()
摘要
使用完全独立于仿真内核随机数生成器的用户指定随机数生成器,生成服从指定分布的浮点数值结果。
语法
op_dist_outcome_gen (dist_ptr, gen_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
dist_ptr |
Distribution * |
指向已加载分布的指针 [指向分布的指针只能从内核过程 op_dist_load() 获得。] |
gen_ptr |
PrgT_Random_Gen * |
用户定义的随机数生成器(见详情) |
返回类型
double
服从指定分布的随机变量的一个结果。若发生可恢复错误,将返回常量 OPC_DBL_INVALID。
示例
PrgT_Random_Gen * rand_gen_ptr;
Distribution * dist_ptr;
double next_rand;
/* Create a random number generator */
rand_gen_ptr = op_prg_random_gen_create (seed);
/* Load a distribution */
dist_ptr = op_dist_load ("normal", 10.0, 0.5);
/* Get a random number */
next_rand = op_dist_outcome_gen (dist_ptr, rand_gen_ptr);
详情
在调用本函数之前,gen_ptr 指定的随机数生成器必须已使用 op_prg_random 系列内核过程创建(见“Random Sub-Package“ 第 6 页)。
用途
本内核过程提供了一种在生成随机数时完全绕过仿真内核内部随机数生成器的方法。内核过程 op_dist_outcome_ext() 也会绕过内部随机数生成器,但并非对所有分布都如此。Binomial、Erlang、Extreme、Laplace、Lognormal、Normal、Pareto、Rayleigh 和 Weibull 分布需要额外的随机数。本内核过程指定一个用户定义的生成器,用于提供初始随机数以及可能需要的任何额外随机数。
大量重复调用本内核过程将生成一组符合指定分布的值。
错误
- 程序中止:段违例。(由于无效的分布指针或无效的随机数生成器指针)
- 可恢复错误:分布指针为 NIL。
- 可恢复错误:PrgT_Random_Gen 指针为 NIL。
参考
- 使用内核过程 op_dist_load() 创建分布
- 使用内核过程 op_dist_outcome() 使用内核内置的随机数生成器获取分布结果
- 使用内核过程 op_dist_outcome_ext() 使用用户指定的随机数值获取分布结果
- 使用内核过程 op_dist_uniform() 获取均匀分布的随机数