tmm_cache_create()

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

摘要

创建一个数据结构,用于存储路径损耗值,以便后续查找和可能的复用。

语法

tmm_cache_create (symmetry, position_tolerence_m, height_tolerance_m)
参数 类型 说明
symmetry TmmT_Cache_Symmetry 指定缓存中的路径损耗计算在两个方向上都有效(TMMC_CACHE_SYMMETRIC),还是仅在一个方向上有效(TMMC_CACHE_ASYMMETRIC)。参见表 86“TMM Cache Symmetry Symbolic Constants“(第 27 页)。
position_tolerence_m float 水平单元大小(以米计)
该参数定义复用一个路径损耗计算时水平位置的最大变化量。
height_tolerance_m float 垂直单元大小(以米计)
该参数定义复用一个路径损耗计算时垂直位置的最大变化量。

返回类型

TmmT_Cache

包含先前位置对列表以及这些点路径损耗值的数据结构。

头文件

tmm.h

示例

/* Search our list of loss caches for a match on this frequency */
cache_ptr = my_find_cache (&cache_list, center_freq);
if (cache_ptr == NULL)
    {
    /* We have never performed a calculation for this frequency.        */
    /* Create a cache for the values for this frequency.                 */

    /* Our signal calculations are symmetric with regard to transmitter */
    /* receiver (propagation between a to b is equal to b to a).        */

    new_cache_ptr = tmm_cache_create (TMMC_CACHE_SYMMETRIC,
                100    /* 100 meters tolerance */,
                5      /* 5 meters vertical tolerance */);

    /* Add the new cache data structure to our list of all caches.      */
    ...
    }

详情

由于涉及地形的路径损耗计算可能耗时很长,TMM 提供了一种在可能时复用先前计算的路径损耗的方法。其做法是创建一个数据结构,保存每次路径损耗计算的以下信息:

表 19:路径损耗计算

值 类型 说明
p1_latitude float 第一个位置的纬度,以度计。
p1_longitude float 第一个位置的经度,以度计。
p1_height float 第一个位置的高度,海拔米数。
p2_latitude float 第二个位置的纬度,以度计。
p2_longitude float 第二个位置的经度,以度计。
p2_height float 第二个位置的高度,海拔米数。
loss_value double 对应纬度/经度/高度坐标对所计算传播损耗的实际值。
value_status TmmT_Loss_Status 路径损耗计算的状态。参见表 87“TMM Path Loss Status Symbolic Constants“(第 27 页)。

如果新路径的端点落在与先前计算位置端点相同的单元内,TMM 即可复用该路径损耗计算。单元大小由 position_tolerance_m 和 height_tolerance_m 参数决定。

缓存数据结构不包含频率信息。如果为不同频率计算路径损耗,应为每个使用的频率或频段创建不同的缓存。

用途

分配一个数据结构,用于保存为一对位置(例如发射机/接收机对的位置)计算的路径损耗信息。该信息随后可复用于其他类似的位置对,从而无需重新计算路径损耗。(缓存操作在第 24 页的“Reusing Path Loss Calculations“中描述。)

错误

  • tmm_cache_create() 的第一个参数(symmetry)无效。
  • tmm_cache_create() 的第二个参数(position_tolerance_m)必须为非负值。
  • tmm_cache_create() 的第三个参数(height_tolerance_m)必须为非负值。

参考

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