op_ima_obj_pos_get()
摘要
获取站点或天线对象在当前仿真时刻的全局位置相关属性的值。
语法
op_ima_obj_pos_get (site_objid, lat_ptr, long_ptr, alt_ptr, x_ptr, y_ptr, z_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
site_objid |
Objid |
目标对象的对象 ID [站点对象的对象 ID 可通过 Id 包和 Topo 包中的多个内核过程获得: op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
lat_ptr |
double* |
指定对象的纬度(由本内核过程填入) |
long_ptr |
double* |
指定对象的经度(由本内核过程填入) |
alt_ptr |
double* |
指定对象的高度(由本内核过程填入) |
x_ptr |
double* |
指定对象的笛卡尔 X 坐标(由本内核过程填入) |
y_ptr |
double* |
指定对象的笛卡尔 Y 坐标(由本内核过程填入) |
z_ptr |
double* |
指定对象的笛卡尔 Z 坐标(由本内核过程填入) |
返回类型
Compcode
完成代码,指示操作是否成功完成。
此代码可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。
示例
/* This line assigns the ID of the parent node object (the object */
/* that 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() to retrieve the transmitter */
/* node object’s global position values... */
comp_code = op_ima_obj_pos_get (tx_node_id, &latitude, &longitude,
&altitude, &x_pos, &y_pos, &z_pos);
详情
此内核过程获得的位置以两种坐标系表示:
- 以 {latitude / longitude / altitude} 给出的大地坐标系
- 以 {X / Y / Z} 给出的地心坐标系
大地坐标系中,纬度和经度的单位是度,高度的单位是米。地心坐标系中,三个坐标的单位均为米。调用此内核过程会使仿真内核计算指定对象的位置;对于基于轨迹的移动站点或卫星站点,位置通过查表获得,并在时间上最接近的两个点之间插值。
注意: 你可以使用三种地心坐标系中的任意一种,如“Geocentric Coordinate System“第 317 页所述。此内核过程按当前指定的坐标系返回位置。
仿真内核不会持续或定期计算移动站点的位置;它仅在无线电收发器管道阶段需要、查询位置属性或调用此内核过程时才进行计算,从而降低了拥有许多在时间上稀疏通信的移动站点的网络的计算开销。对于基于向量的移动站点或卫星站点,站点位置基于方位角、地面速度和上升速率属性计算。
当使用此内核过程获取移动子网的位置时,返回的值表示子网内的中心点(而非左上角)。
用途
提供一种便捷的机制,通过单次过程调用即可获得站点(节点或子网)或天线对象的全部六个全局位置相关属性。之所以由 Ima 包的专用内核过程执行此操作,是因为对象的位置属性会因对象是否位于子网内而有不同的解释(例如,顶层站点的位置属性以地心坐标系表示,而子网内站点的位置属性以相对于子网位置的笛卡尔坐标系表示)。此内核过程将不同类型的位置属性转换为两组通用的地心位置坐标集。
注意: 此内核过程也可以使用其旧名称调用:op_ima_node_pos_get()。
错误
- 程序中止:段违例。(由于坐标指针无效)
- 可恢复错误:对象 ID(
<site_objid>)超出范围。 - 可恢复错误:对象(
<site_objid>)类型不正确;应为节点或天线对象。 - 可恢复错误:对象 ID(
<site_objid>)指向一个受限对象。
参考
- 使用内核过程 op_ima_obj_attr_get_dbl() 获取站点的单个位置相关属性