tmm_propagation_model_get()

注意: 需要地形建模模块(Terrain Modeling Module)功能。

摘要

加载实现特定传播模型的共享对象库。

语法

tmm_propagation_model_get (propagation_model_name)
参数 类型 说明
propagation_model_name const char * 要获取的传播模型名称

返回类型

TmmT_Propagation_Model *

指向包含相应传播模型信息的数据结构的指针。该数据结构包括以下字段:传播模型名称、参数文件路径、指向路径损耗计算函数的指针、指向参数文件的指针,以及一个用于指示返回的数据结构是否为有效可用结构的标志。

头文件

tmm_prim_prototypes.h

示例

static TmmT_Propagation_Model         * longley_rice_model_ptr;
static TmmT_Path_Loss_Calc_Method     * loss_function_ptr;

/* ... obtain transmitter and receiver positions from packet ... */

if (longley_rice_model_ptr == OPC_NIL)
    {
    /* We haven't loaded the Longley-Rice propagation code yet. */
    /* Try to load the model now. */
    longley_rice_model_ptr = tmm_propagation_model_get ("Longley Rice");
    if (longley_rice_model_ptr == OPC_NIL)
        {
        /* Our propagation model is missing. Abort the simulation. */
        op_sim_end ("Unable to load the Longley-Rice propagation model.",
            "Please check that it is in your mod_dirs.",
            "Terminating simulation", "");
        }
    if (longley_rice_model_ptr->initialized_ok_flag == OPC_FALSE)
        {
        op_sim_end ("Longley-Rice propagation model failed to initialize",
            "correctly. Please view previous errors for details.",
            "Terminating simulation", "");
        }
    loss_function_ptr = longley_rice_model_ptr->path_loss_calc_method;
    }

详情

这是使用传播模型的关键函数,因为它提供了对初始化例程和路径损耗计算函数的访问。有关此函数返回的 TmmT_Propagation_Model 数据结构及其各组成部分的使用,请参阅 tmm.h 文件中的大量注释。

用途

用于加载传播模型并访问使用该模型的函数所需的信息。该函数在无线电收发器管道(Radio Transceiver Pipeline)的 closure 阶段(阶段 2)被调用,此时进行路径损耗计算。

错误

  • 可恢复错误:传播模型名称为 NIL。

参考

  • 无。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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