op_radio_antenna_gain_to_location_get()
注意: 需要 Wireless 功能
摘要
获取天线指向某个给定位置的增益。
语法
op_radio_antenna_gain_to_location_get (antenna_objid, x, y, z)
| 参数 | 类型 | 说明 |
|---|---|---|
antenna_objid |
Objid |
目标天线。 |
x |
double |
目标位置的地心 x 坐标。 |
y |
double |
目标位置的地心 y 坐标。 |
z |
double |
目标位置的地心 z 坐标。 |
返回类型
double
指向指定位置方向上的天线增益,单位为 dB。(若无法获取增益,则返回 0.0。)
示例
/* Get receive antenna gain toward transmitter. */
objid rx_antenna_objid;
double tx_x, tx_y, tx_z, gain;
/* Obtain the geocentric coordinates of the transmitter. */
tx_x = op_td_get_dbl (pkptr, OPC_TDA_RA_TX_GEO_X);
tx_y = op_td_get_dbl (pkptr, OPC_TDA_RA_TX_GEO_Y);
tx_z = op_td_get_dbl (pkptr, OPC_TDA_RA_TX_GEO_Z);
/* Obtain the receiver antenna objid. */
rx_antenna_objid = op_td_get_int (pkptr, OPC_TDA_RA_RX_ANT_OBJID);
gain = op_radio_antenna_gain_to_location_get (rx_antenna_objid, tx_x, tx_y, tx_z);
详情
如果无法获取指向该位置的角度值,或角度值无关紧要,该函数将返回 OPC_COMPCODE_FAILURE。例如,以下情况即属此类:
- 不存在天线模块(因此天线是全向的)
- 天线模块使用全向方向图
- 天线与目标位置相同
用途
提供一种获取天线在指定位置方向上的增益的机制。
错误
- 无。
参考
- 无。