op_tbl_pat_gain()
摘要
从天线方向图模型获取天线方向图增益值。
语法
op_tbl_pat_gain (pat_tbl_ptr, polar, azimuth)
| 参数 | 类型 | 说明 |
|---|---|---|
pat_tbl_ptr |
Pattern_Handle |
方向图 [该值是指向天线方向图表的指针,可通过 op_tbl_pattern_get() 获取。] |
polar |
double |
目标方向的 polar 角 [该值的单位为度,应在 0 到 180 范围内。] |
azimuth |
double |
目标方向的 azimuth 角 [该值的单位为度,应在 0 到 360 范围内。] |
返回类型
double
与指定方向角对应的天线方向图增益值。
示例
摘自:示例模型(models/std/base);管道模型(dra_ragain)。
/* Setup the angles at which to lookup gain... */
lookup_polar = 90.0 - tx_polar;
lookup_azimuth = tx_azimuth;
/* Obtain gain of antenna pattern at given angles. */
gain = op_tbl_pat_gain (pattern_table, lookup_polar, lookup_azimuth);
/* Set the rx antenna gain in the packet's transmission data attribute. */
op_td_set_dbl (pkptr, OPC_TDA_RA_RX_GAIN, gain);
详情
在无线通信链路中,定向天线方向图会显著影响数据传输质量。链路模型必须计入定向天线增益的影响才能得到真实的结果。在 Transceiver Pipeline 中,每一条可能的无线链路都被分别考虑,涉及一个特定的活动无线发射机和一个候选无线接收机。活动发射机天线方向图指向候选接收机方向的增益,以及候选接收机天线方向图指向活动发射机方向的增益,都是借助该 KP(以及大量预先进行的三角计算——这些计算导出用作天线方向图表索引的适当 phi 角和 theta 角)得到的。
该 KP 在天线方向图表中查找所请求的增益,不执行插值。
用途
提供一种机制,利用已加载到仿真数据表中的天线方向图模型,将特定的天线方向转换为该方向对应的增益值。方向由 polar 角和 azimuth 角值表示,这些值通常在 Transmitter Antenna Gain Model(Radio Pipeline 的第 4 阶段;该阶段的默认模型存储在文件 dra_tagain.ps.c 中)和 Receiver Antenna Gain Model(Radio Pipeline 的第 6 阶段;该阶段的默认模型存储在文件 dra_ragain.ps.c 中)中计算并传递给该 KP。得到的增益值存储在数据包中,供 Received Power Model(Radio Pipeline 的第 7 阶段)使用。
错误
- 程序中止:段违例。(由于无效的表 ID)
参考
- 使用 KP op_tbl_pat_gain_ext() 从天线方向图模型获取天线方向图增益值及附加信息
- 使用 KP op_tbl_mod_ber() 在调制格式模型表中查找误码率(BER)值
- 使用 KP op_tbl_pattern_get() 获取天线方向图表指针(或者,将 op_td_get_ptr() 应用于 OPC_TDA_RA_RX_PATTERN 或 OPC_TDA_RA_TX_PATTERN 传输数据属性,也可获取天线方向图表指针)
- 将 KP op_td_set_dbl() 应用于 OPC_TDA_RA_RX_GAIN 或 OPC_TDA_RA_TX_GAIN 传输数据属性,将计算得到的增益值存入数据包的传输数据