op_dist_load()
摘要
加载一个分布,用于生成随机值流。
语法
op_dist_load (dist_name, dist_arg0, dist_arg1)
| 参数 | 类型 | 说明 |
|---|---|---|
dist_name |
const char* |
要加载的分布名称 [该值通常是一个字符串常量,如“poisson”。] |
dist_arg0 |
double |
分布的可选参数 #0 |
dist_arg1 |
double |
分布的可选参数 #1 [当加载不需要这些值的分布时,本内核过程会忽略 dist_arg0 与 dist_arg1 的值。但为了符合本内核过程的正确调用语法,必须传入有效的 double 值作为占位。] |
返回类型
Distribution*
指向已加载分布的指针。若发生可恢复错误,则返回常量 OPC_NIL。
[本内核过程返回的值通常保存在声明为 Distribution* 类型的状态变量中,之后再传递给相关的内核过程 op_dist_outcome()。]
示例
摘自:进程模型(jsd_gen);状态(init);enter execs。
/* Load the distribution function for the packet interarrival times. */
next_dist = op_dist_load ("exponential", ia_time, 0.0);
if (next_dist == OPC_NIL)
jsd_gen_error ("Unable to load packet arrival distribution.");
/* Load the distribution function for the job types. */
job_type_dist = op_dist_load ("uniform_int", 1, job_type_range);
if (job_type_dist == OPC_NIL)
jsd_gen_error ("Unable to load job type distribution.");
详情
分布以名称指定,可以是预定义的解析分布、使用 PDF 编辑器准备的用户定义 PDF 模型,或 EMA 指定的 PDF 模型。预定义分布(如 bernoulli 和 poisson)以算法实现,通过调用本内核过程并传入一个或两个数值参数进行参数化。另外两类分布是表格数据文件(文件名后缀为 .pd.s),通过调用本内核过程加载到内存中。注意,即使是预定义分布,在 models/std/base 目录中也有对应的 .pd.s 文件,但这些零长度文件只是为了让这些分布出现在应用程序菜单中,实际上并不包含任何分布数据。当用于加载用户定义的 PDF 时,dist_arg0 和 dist_arg1 会被忽略。
用途
提供一种机制,用于准备一个概率分布,作为随机数生成器使用。最常见的应用是加载一个分布,为处理器中生成的数据包之间出现的随机到达间隔时间提供来源。不过,任何应当随机分布的仿真参数都可以从分布设施导出。实际的随机值通过调用过程 op_dist_outcome() 获得。可以传入 dist_name 的预定义分布见包概述。
错误
- 程序中止:段违例。(由于无效的分布名称指针)
- 程序中止:内存分配失败。
- 可恢复错误:分布名称(
<dist_name>)无法识别。
参考
- 使用内核过程 op_dist_outcome() 或 op_dist_outcome_ext() 从已加载的分布获取随机值
- 使用内核过程 op_dist_uniform() 获取均匀分布的随机值
- 使用内核过程 op_dist_unload() 释放某个分布占用的内存