op_radio_antenna_point_info_get()

Note: Requires Wireless functionality

Abstract

Gets the geocentric pointing angles from an antenna to its target.

Syntax

op_radio_antenna_point_info_get (antenna_id, point_polar_ptr, point_azimuth_ptr)
Argument Type Description
antenna_id Objid Antenna of interest.
point_polar_ptr double * Area to be filled with pointing polar value.
point_azimuth_ptr double * Area to be filled with pointing azimuth value.

Return Type

Compcode

OPC_COMPCODE_SUCCESS if the antenna pointing information was successfully obtained; OPC_COMPCODE_FAILURE otherwise.

Example

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);

Details

Pointing angles are given in the geocentric coordinate system. The polar angle ranges from +90° (positive z axis) to -90°. Azimuth ranges from 0° (east) to 360°, increasing in either the north or south direction depending on whether a right-hand or left-hand system is being used (“geocentric_model“ preference).

Purpose

Provides a mechanism for getting the pointing angles of an antenna.

Errors

  • Recoverable Error: Object ID (<antenna_id>) is out of range.
  • Recoverable Error: Object ID (<antenna_id>) refers to a restricted object.

Reference

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