移动通信节点对象
移动通信节点是节点模型的实例。其内部结构可编辑,由若干模块组成,这些模块按照用户提供的设计对数据包(Packet)进行处理、生成、存储、接收和发送,或执行其他任务。移动节点具备固定通信节点的全部功能,并且额外能够在仿真过程中动态改变自身位置。移动通信节点的默认表示是一个带四个箭头的八边形,如下图所示。
图 57:默认移动通信节点图标

移动通信节点只能通过无线链路与固定通信节点、其他移动节点或卫星节点相连。移动节点不能通过双工点对点链路、单工点对点链路或总线链路连接。有关节点移动性的更多信息,参见“Modeling Node and Subnetwork Movement” on page 13。
移动通信节点对象属性
移动通信节点对象的内置属性如下所列,按字母顺序排列。
表 17:移动通信节点对象内置属性
| Name | Editing Data Type |
|---|---|
| altitude | double |
| altitude modeling | enumerated |
| ascent rate | string |
| bearing | double |
| color | color |
| condition | toggle |
| creation data | string |
| creation source | string |
| creation timestamp | date |
| financial cost | string |
| ground speed | string |
| icon name | string |
| minimized icon | minimized icon |
| model | typed file |
| name | string |
| pitch | double |
| position cache time granularity | double |
| priority | integer |
| roll | double |
| threshold | double |
| trajectory | typed file |
| trajectory_speed_override | toggle double |
| user id | integer |
| x position | double |
| y position | double |
| yaw | double |
altitude
该属性表示移动通信节点距离地球表面海平面的高度,单位为米。该属性的值可以在整个仿真过程中变化。
如果指定了轨迹文件,则每当移动节点需要更新其位置时,该值都会被自动重新计算。如果未指定轨迹文件,则可以通过内核过程(Kernel Procedure)op_ima_obj_attr_set_dbl() 动态更新该值。
该属性对于判定视线闭合至关重要,其值通常大于 0.0。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 0.0 | |
| Units | meters | |
| Constraints | None |
altitude modeling
该属性决定仿真内核(Simulation Kernel)如何解释对象的 altitude 属性。共有三种设置:
- relative to subnet – 该 altitude 设置被解释为对象相对于当前子网(Subnet)的高度。
- absolute – 该 altitude 设置是对象相对于全球海平面的高度。
- relative to terrain – 该 altitude 设置是对象相对于下垫地形(山脉、山谷、海洋)的高度。
| Editing | Simulation | |
|---|---|---|
| Data Type | enumerated | enumerated |
| Access | read / write / promote | read |
| Default Value | relative to subnet | |
| Units | See description | |
| Constraints | None |
ascent rate
该属性指定移动节点的垂直速度。仅当节点的 “trajectory” 属性设置为 VECTOR 时使用。属性字符串由一个数值后跟一个速度单位组成,如 “3 meter/sec”。速度单位是 ‘knot’,或者是由 ‘/’ 分隔的长度单位(meter、kilometer、feet、mile 或 nautical mile)与时间单位(sec、min、hour)的组合。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write / promote | read / write |
| Default Value | None | |
| Units | See description | |
| Constraints | None |
bearing
该属性与设置为 Vector 的轨迹配合使用,指定相对于磁北的方位:0 - 北,90 - 东,180 - 南,270 - 西。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 0.0 | |
| Units | degrees | |
| Constraints | 0.0 <= bearing < 360.0 |
color
该属性指定节点轨迹的颜色,用于在 Project Editor 中显示。该属性对仿真没有影响。color 属性的取值范围为 RGB000 到 RGB333,其中每个数字是 0 到 3(含)之间的整数。第一个数字越大越偏红,第二个数字越大越偏绿,第三个数字越大越偏蓝。因此 RGB000 对应黑色,RGB333 对应白色,RGB300 对应红色,依此类推。
| Editing | Simulation | |
|---|---|---|
| Data Type | color | N/A |
| Access | read / write | N/A |
| Default Value | RGB333 | |
| Units | N/A | |
| Constraints | None |
condition
该属性表示节点的运行状态。值为 “enabled” 表示节点正在运行,可以发送或接收数据包或执行其他功能。值为 “disabled” 表示节点无法执行任何功能。condition 的默认值为 enabled。
如果用户关心节点失效所产生的影响,通常会在仿真过程中使用内核过程 op_ima_obj_attr_set() 修改 condition 属性。将值从 enabled 改为 disabled 会在选定模块处产生失效中断(failure interrupt)。将值从 disabled 改为 enabled 会在选定模块处产生恢复中断(recovery interrupt)。有关建模失效与恢复的更多信息,参见“Network Domain” on page 292。
| Editing | Simulation | |
|---|---|---|
| Data Type | toggle | toggle |
| Access | read / write / promote | read / write |
| Default Value | enabled | |
| Units | N/A | |
| Constraints | enabled, disabled |
creation data
该属性指定关于对象创建的附加信息。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | not applicable |
| Access | read/write | not applicable |
| Default Value | “” | |
| Units | ||
| Constraints |
creation source
该属性指定对象是如何创建的。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | not applicable |
| Access | read/write | not applicable |
| Default Value | “Object Palette” | |
| Units | ||
| Constraints |
creation timestamp
该属性指定对象创建的时间。
| Editing | Simulation | |
|---|---|---|
| Data Type | date | not applicable |
| Access | read/write | not applicable |
| Default Value | ||
| Units | ||
| Constraints |
financial cost
该属性指定购买或维护该对象的成本。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read/write/promote | read/write |
| Default Value | “0.00” | |
| Units | ||
| Constraints |
ground speed
该属性指定移动节点相对于地面的速度。仅当节点的 trajectory 属性设置为 VECTOR 时使用。属性字符串由一个数值后跟一个速度单位组成,如 “3 meter/sec”。速度单位是 “knot”,或者是由 “/” 分隔的长度单位(meter、kilometer、feet、mile 或 nautical mile)与时间单位(sec、min、hour)的组合。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write / promote | read / write |
| Default Value | None | |
| Units | See description | |
| Constraints | None |
icon name
该属性允许用户修改用于在网络图中表示通信节点的位图。图标可以用图标编辑器创建。该属性的值对仿真行为没有影响。
| Editing | Simulation | |
|---|---|---|
| Data Type | icon | N/A |
| Access | read / write | N/A |
| Default Value | mobile_comm | |
| Units | N/A | |
| Constraints | None |
minimized icon
该属性指定当缩放导致其小到无法用原始图标表示时,子网将如何显示。
| Editing | Simulation | |
|---|---|---|
| Data Type | minimized icon | not applicable |
| Access | read/write | not applicable |
| Default Value | “circle/#708090” | |
| Units | ||
| Constraints |
model
该属性指定通过 Node Editor 或外部模型访问(External Model Access)接口开发的节点模型的名称。节点模型表示通信节点的内部结构,因而也代表其能力,并且可以使节点继承已被向上提升(promote)的属性。
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write | read |
| Default Value | ex_node | |
| Units | N/A | |
| Constraints | None |
name
该属性指定用于标识目的的字符串。它可用于在模型报告中识别节点。在仿真过程中,它也用于通过内核过程 op_id_from_name() 获取节点的对象 ID(Object ID)。对象 ID 进而可用于获取属性值,也可用于以动态方式执行路由或禁用/启用节点。仿真内核不使用该属性。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | mobile_node_n, n >= 0 |
|
| Units | N/A | |
| Constraints | unique name, no dots, not “top” |
pitch
该属性指定移动节点在空间中的姿态的 pitch 分量。姿态的其余分量是 roll 和 yaw。如果指定了轨迹文件,仿真内核会根据当前轨迹段设置自动更新该属性的值。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 0.0 | |
| Units | degrees | |
| Constraints | None |
position cache time granularity
该属性指定一个时间窗口,在该窗口内假定移动节点的位置不变,不会重新计算。(更多细节参见“Reducing the Number of Position Calculations” on page 13。)默认值设置为 op_runsim 的 default_site_position_cache_time_granularity 属性的值。
| Editing | Simulation | |
|---|---|---|
| Data Type | N/A | double |
| Access | N/A | read / write |
| Default Value | see description | |
| Units | seconds | |
| Constraints | None |
priority
当多个事件被调度在同一仿真时刻时,该属性用于决定它们的执行顺序。优先级较高的事件先执行。事件优先级按层次评估:子网优先级的权重高于节点优先级,节点优先级的权重又高于模块优先级。
该属性不被并行仿真内核使用。
| Editing | Simulation | |
|---|---|---|
| Data Type | integer | integer |
| Access | read / write / promote | read / write |
| Default Value | 0 | |
| Units | N/A | |
| Constraints | absolute value (priority) <= 32,000 |
roll
该属性指定移动节点在空间中的姿态的 roll 分量。姿态的其余分量是 pitch 和 yaw。如果指定了轨迹文件,仿真内核会根据当前轨迹段设置自动更新该属性的值。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 0.0 | |
| Units | degrees | |
| Constraints | None |
threshold
该属性影响节点在不同缩放级别下的显示特性。如果其值高于地图的当前分辨率,节点将以缩微图标显示。通常,该属性用于确保网络图在较高缩放级别下不被图标弄得杂乱。地图的当前分辨率可以在 Project Editor 中通过 Set View Properties 命令弹出的对话框确定。在顶层子网中,该属性以像素/度为单位;在所有其他子网级别中,以像素/子网单位为单位。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | N/A |
| Access | read / write | N/A |
| Default Value | 0.0 | |
| Units | N/A | |
| Constraints | see description |
trajectory
该属性指定对象在仿真过程中的运动。有效设置为 VECTOR、NONE,或带 .trj 后缀的 ASCII 轨迹文件的名称(属性设置中不包含该后缀)。
如果 trajectory 设置为 VECTOR,则对象的 bearing、ground speed 和 ascent rate 属性决定其运动。
如果 trajectory 设置为 NONE,对象将保持静止,除非其位置属性通过诸如 op_ima_obj_attr_set() 的内核过程被直接修改。
如果 trajectory 设置为某个轨迹文件名,应用程序使用轨迹文件来确定对象的运动。轨迹文件指定一组路径段,用于确定对象在给定时刻的位置。文件可以包含所有路径段统一的穿越时间(固定间隔轨迹),也可以为每个段指定各自的穿越时间(可变间隔轨迹)。
注: 如果移动对象位于移动子网内,并使用基于段的轨迹,则只有当轨迹以非度坐标(feet、miles 等)定义时,父子网的运动才会影响该对象的运动。
有关创建和使用不同类型轨迹的更多信息,参见“Trajectories” on page 14。
| Editing | Simulation | |
|---|---|---|
| Data Type | enumerated/ file name | N/A |
| Access | read / write / promote | N/A |
| Default Value | None | |
| Units | N/A | |
| Constraints | None |
trajectory_speed_override
该属性指定移动站点在沿指定轨迹运动时使用的速度。
沿基于段的轨迹运动的移动站点的速度在轨迹定义中指定。该速度对每个段可以不同。你可以通过设置该属性来覆盖轨迹中指定的速度。该属性设置的速度将用于轨迹的所有段。
有关创建和使用基于段的轨迹的更多信息,参见“Segment-Based Trajectories” on page 14。
| Editing | Simulation | |
|---|---|---|
| Data Type | toggle double | N/A |
| Access | read / write / promote | N/A |
| Default Value | None | |
| Units | meters/sec | |
| Constraints | None |
user id
该属性是一个用于用户自定义标识目的的整数。与 sys id 不同,它不一定具有唯一性,但它是可读写变量,用户可以按任何需要的方式赋值。
| Editing | Simulation | |
|---|---|---|
| Data Type | integer | integer |
| Access | read / write / promote | read / write |
| Default Value | 0 | |
| Units | N/A | |
| Constraints | None |
x position
该属性指定通信节点位置的三个分量之一。三个分量是 x position、y position 和 altitude。在顶层子网或使用度为单位的任何子网中,x position 对应经度。在使用非度单位的子网中,它表示节点与子网范围左边缘之间的距离。
如果指定了轨迹文件,仿真内核通过在轨迹文件中的相邻点之间线性插值来自动更新该属性的值。使用相对轨迹时,x position 的初始值作为偏移量加到轨迹文件中所有 x 坐标上。使用绝对轨迹时,x position 的初始值无关紧要,因为在仿真开始时它会被轨迹文件中的第一个 x 坐标替换。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read / write |
| Default Value | N/A | |
| Units | see description | |
| Constraints | None |
y position
该属性指定通信节点位置的三个分量之一。三个分量是 x position、y position 和 altitude。在顶层子网或使用度为单位的任何子网中,y position 对应经度。在使用非度单位的子网中,它表示节点距子网范围顶边的距离。
如果指定了轨迹文件,仿真内核通过在轨迹文件中的相邻点之间线性插值来自动更新该属性的值。使用相对轨迹时,y position 的初始值作为偏移量加到轨迹文件中所有 y 坐标上。使用绝对轨迹时,y position 的初始值无关紧要,因为在仿真开始时它会被轨迹文件中的第一个 y 坐标替换。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read / write |
| Default Value | N/A | |
| Units | see description | |
| Constraints | None |
yaw
该属性指定移动节点在空间中的姿态的 yaw 分量。姿态的其余分量是 roll 和 pitch。如果指定了轨迹文件,仿真内核会根据当前轨迹段设置自动更新该属性的值。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read / write |
| Default Value | 0.0 | |
| Units | degrees | |
| Constraints | None |