op_tbl_pattern_get()
摘要
根据天线模块 ID 获取天线方向图。
语法
op_tbl_pattern_get (antenna_id)
| 参数 | 类型 | 说明 |
|---|---|---|
antenna_id |
objid |
天线模块 ID |
返回类型
Pattern_Handle
天线方向图;若未找到该方向图则返回 OPC_NIL。
示例
/* Discover the Antenna module id associated with this cell. */
cell_ant_id = op_topo_assoc (cell_tx_id, OPC_TOPO_ASSOC_OUT, OPC_OBJTYPE_ANT, 0);
/* Check to make sure that the returned Object ID is valid. */
if (cell_ant_id == OPC_OBJID_INVALID)
op_sim_end ("There is no antenna module connected to this cell.", "", "", "");
/* Obtain the antenna boresight and reference values. */
op_ima_obj_attr_get (cell_ant_id, "pointing ref. theta",
&(global_node_b_params[cell].boresight_theta));
op_ima_obj_attr_get (cell_ant_id, "pointing ref. phi",
&(global_node_b_params[cell].boresight_phi));
global_node_b_params[cell].boresight_phi =
90 - global_node_b_params[cell].boresight_phi;
op_radio_antenna_point_info_get (cell_ant_id,
&(global_node_b_params[cell].pointing_ref_phi),
&(global_node_b_params[cell].pointing_ref_theta));
/* Get a reference to the antenna pattern of this cell. */
global_node_b_params[cell].antenna_model_id =
(void *) op_tbl_pattern_get (cell_ant_id);
详情
无。
用途
提供一种获取天线模块的天线方向图表引用的方式。该引用随后可用于 op_tbl_pat_gain()。
错误
- 可恢复错误(Recoverable Error):对象 ID(<antenna_id>)超出范围。
- 可恢复错误(Recoverable Error):对象 ID(<antenna_id>)指向受限对象。
- 可恢复错误(Recoverable Error):对象 id(<antenna_id>, <obj_path>)不对应任何天线模块。
参考
- 使用 KP op_tbl_pat_gain() 获取与特定方向对应的天线方向图增益值