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。例如,以下情况即属此类:

  • 不存在天线模块(因此天线是全向的)
  • 天线模块使用全向方向图
  • 天线与目标位置相同

用途

提供一种获取天线在指定位置方向上的增益的机制。

错误

  • 无。

参考

  • 无。

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