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>)无法识别。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com