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)必须为非负值。
参考
- 使用函数 tmm_cache_destroy() 销毁指定的缓存。
- 使用函数 tmm_cache_entry_add() 将特定位置对的路径损耗信息添加到 TmmT_cache 数据结构。
- 使用函数 tmm_cache_entry_find() 搜索 TmmT_cache 数据结构,若存在指定位置对的路径损耗则返回。