op_ima_obj_pos_get_time()

摘要

获取站点或天线对象的全局位置相关属性在当前仿真时刻的取值,或外推其在未来某个仿真时刻的取值。

语法

op_ima_obj_pos_get_time (site_objid, time, lat_ptr, long_ptr, alt_ptr, x_ptr, y_ptr, z_ptr)
参数 类型 说明
site_objid Objid 目标对象的对象 ID
[站点对象 ID 可以从 Id 和 Topo 包中的多个 KP 获得:op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。]
time double 所关注的仿真时刻
lat_ptr double* 指定对象的纬度(由本 KP 填入)
long_ptr double* 指定对象的经度(由本 KP 填入)
alt_ptr double* 指定对象的高度(由本 KP 填入)
x_ptr double* 指定对象的笛卡尔 X 坐标(由本 KP 填入)
y_ptr double* 指定对象的笛卡尔 Y 坐标(由本 KP 填入)
z_ptr double* 指定对象的笛卡尔 Z 坐标(由本 KP 填入)

返回类型

Compcode

指示操作是否成功完成的完成代码。

该代码可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。

示例

/* This line assigns the ID of the parent node object (the object */
/* which contains this processor module) to the variable rx_node_id... */
rx_node_id = op_topo_parent (op_id_self ());

/* This line determines the ID of the subnet object... */
subnet_id = op_topo_parent (rx_node_id);

/* This line assigns the object ID of the transmitter node to the */
/* variable tx_node_id... */
tx_node_id = op_id_from_name (subnet_id, OPC_OBJTYPE_NODE_FIXED, "tx");

/* This line uses op_ima_obj_pos_get_time() to retrieve the transmitter */
/* node object’s global position values... */
comp_code = op_ima_obj_pos_get_time (tx_node_id, op_sim_time(), &latitude,
	&longitude, &altitude, &x_pos, &y_pos, &z_pos);

详情

本 KP 获取的位置以两个坐标系表示:

  • 大地坐标系 {纬度 / 经度 / 高度}
  • 地心坐标系 {X / Y / Z}

大地坐标系中,纬度和经度的单位为度,高度的单位为米。地心坐标系中三个坐标的单位均为米;该坐标系在“Geocentric Coordinate System“第 317 页中有详细讨论。调用本 KP 会使仿真内核针对指定时刻外推指定对象的位置;对于基于轨迹(trajectory-based)的移动站点或卫星站点,位置在表中查找,并在时间上最接近的两个点之间插值得到。Time 必须至少等于当前仿真时刻。

仿真内核不会持续或定期计算移动站点的位置;它仅在无线电 Transceiver Pipeline 各级需要时、位置属性被查询时、或本 KP 被调用时才进行计算,从而降低众多移动站点在时间上稀疏通信的网络的计算开销。对于基于矢量(vector-based)的移动站点或卫星站点,站点位置根据方位角、地面速度和上升速率属性计算得出。

用途

提供了一种便捷的机制,通过单次过程调用即可获取站点(节点或子网)或天线对象的全部六个全局位置相关属性。之所以由 Ima 包的专用 KP 执行此操作,是因为对象的位置属性含义取决于该对象是否位于子网之内(例如,顶层站点的位置属性以地心坐标系表示,而子网内站点的位置属性则以相对于子网位置的笛卡尔坐标系表示)。本 KP 将不同类型的位置属性转换为两组通用的地心位置坐标。

错误

  • 程序中止:段违例。(由无效的坐标指针引起)
  • 可恢复错误:对象 ID(<site_objid>)超出范围。
  • 可恢复错误:对象(<site_objid>)类型不正确;应为节点或天线对象。
  • 可恢复错误:对象 ID(<site_objid>)指向受限对象。
  • 可恢复错误:仿真时刻已晚于所请求的时刻(<time>)

参考

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