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>)
参考
- 使用 KP op_ima_obj_attr_get_dbl() 可获取站点在当前仿真时刻的单个位置相关属性。