op_radio_antenna_point_info_get()
注意: 需要 Wireless 功能
摘要
获取天线指向其目标的地心指向角。
语法
op_radio_antenna_point_info_get (antenna_id, point_polar_ptr, point_azimuth_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
antenna_id |
Objid |
目标天线。 |
point_polar_ptr |
double * |
用于填充指向极角值的区域。 |
point_azimuth_ptr |
double * |
用于填充指向方位角值的区域。 |
返回类型
Compcode
若成功获取天线指向信息则返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
Objid ant_id;
double point_polar, point_azimuth;
/* Discover the Antenna module id associated with this transmitter. */
ant_id = op_topo_assoc (tx_id, OPC_TOPO_ASSOC_OUT, OPC_OBJTYPE_ANT, 0);
/* Check to make sure that the returned Object ID is valid. */
if (ant_id == OPC_OBJID_INVALID)
op_sim_end ("There is no antenna module connected to this xmtr.", "", "", "");
op_radio_antenna_point_info_get (ant_id, &point_polar, &point_azimuth);
详情
指向角以地心坐标系给出。极角的范围为 +90°(z 轴正方向)到 -90°。方位角的范围为 0°(正东)到 360°,其增大方向为向北或向南,取决于所用的是右手系还是左手系(“geocentric_model“ 偏好)。
用途
提供一种获取天线指向角的机制。
错误
- 可恢复错误:对象 ID (
<antenna_id>) 超出范围。 - 可恢复错误:对象 ID (
<antenna_id>) 指向受限对象。
参考
- 使用内核过程 op_radio_antenna_angles_to_location_get() 可获取指向指定位置的指向角(在天线坐标系中)。