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。
参考
- 无。