卫星通信节点对象
卫星通信节点是节点模型的实例。其内部结构可编辑,由若干模块组成,这些模块按照用户提供的设计对数据包(Packet)进行处理、生成、存储、接收和发送,或执行其他任务。它们具备固定通信节点的全部能力,并且额外是移动的,可以遵循指定的轨道文件。更多信息,参见“Satellite Nodes” on page 8。
卫星通信节点的默认表示是一个带卫星的六边形,如下图所示。
图 58:默认卫星通信节点图标

卫星通信节点只能通过无线链路与其他节点相连。卫星节点不能通过双工点对点链路、单工点对点链路或总线链路连接。卫星节点通常被分配一个使用 Analytical Graphics 的 Satellite Tool Kit 创建、然后导入 Riverbed Modeler 的轨道文件。有关创建和导入轨道文件的更多信息,参见“Orbits” on page 25。
卫星通信节点对象属性
卫星通信节点对象的内置属性如下所列,按字母顺序排列。
表 18:卫星通信节点对象内置属性
| Name | Editing Data Type |
|---|---|
| altitude | double |
| color | color |
| condition | toggle |
| creation data | string |
| creation source | string |
| creation timestamp | date |
| financial cost | string |
| icon name | string |
| minimized icon | minimized icon |
| model | typed file |
| name | string |
| orbit | typed file |
| phase | double |
| position cache time granularity | double |
| priority | integer |
| sys id | integer |
| threshold | double |
| user id | integer |
| x position | double |
| y position | double |
altitude
该属性表示卫星通信节点距离地球表面的高度,单位为米。由于节点是移动的,该属性的值可以在整个仿真过程中变化。每当卫星节点需要更新其位置时,都会根据与该节点关联的轨道文件中指定各点的高度之间的线性插值重新计算 altitude。该属性对于判定无线通信的视线闭合至关重要。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read |
| Default Value | 0.0 | |
| Units | meters | |
| Constraints | None |
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 | RGB331 | |
| Units | N/A | |
| Constraints | None |
condition
该属性表示节点的运行状态。值为 enabled 表示节点正在运行,可以发送或接收数据包或执行其他功能。值为 disabled 表示节点无法执行任何功能。condition 的默认值为 enabled。
如果用户关心节点失效所产生的影响,通常会在仿真过程中使用内核过程(Kernel Procedure)op_ima_obj_attr_set() 修改 condition 属性。将值从 enabled 改为 disabled 会在选定模块处产生失效中断(failure interrupt)。将值从 disabled 改为 enabled 会在选定模块处产生恢复中断(recovery interrupt)。
| 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 |
icon name
该属性允许用户修改用于在网络图中表示通信节点的位图。图标可以用图标编辑器创建。该属性的值对仿真行为没有影响。
| Editing | Simulation | |
|---|---|---|
| Data Type | icon | N/A |
| Access | read / write | N/A |
| Default Value | satellite_comm | |
| Units | N/A | |
| Constraints | None |
minimized icon
该属性指定当缩放导致其小到无法用原始图标表示时,子网(Subnet)将如何显示。
| 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 进而可用于获取属性值,也可用于以动态方式执行路由或禁用/启用节点。仿真内核(Simulation Kernel)不使用该属性。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | sat_node_n, n >= 0 |
|
| Units | N/A | |
| Constraints | unique name, no dots, not “top” |
orbit
该属性是一个文本字符串,对应带 .orb 后缀的二进制格式轨道文件的名称(属性值中不包含该后缀)。轨道文件保存着指定卫星节点在仿真推进过程中所经过的时刻和位置的数据。轨道给出了卫星节点随时间走过的实际路径的采样。在仿真过程中的任意时刻,节点的位置通过在相邻采样之间线性插值确定。有关创建和使用卫星轨道的更多信息,参见“Orbits” on page 25。
| Editing | Simulation | |
|---|---|---|
| Data Type | typed file | string |
| Access | read / write / promote | read |
| Default Value | None | |
| Units | N/A | |
| Constraints | None |
phase
该属性指定轨道在时间上的前移或后移。仿真过程中任意时刻 t 卫星的位置,是轨道文件给出的时刻 (t - phase) 的位置。例如,phase 为 100.0 秒、仿真时间为 300.0 时,卫星的位置将是轨道文件开始后 200.0 秒处给出的位置。在这种情况下,卫星的位置在仿真开始后的前 100.0 秒内保持在轨道文件中的初始位置不变。如果使用负的 phase,例如 -100.0 秒,则卫星在仿真时刻 0.0 秒的位置将是轨道文件开始后 100.0 秒处给出的位置。因此,负的 phase 使轨道在时间上前移。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write / promote | read |
| Default Value | 0.0 | |
| Units | sec | |
| Constraints | None |
position cache time granularity
该属性指定一个时间窗口,在该窗口内假定卫星节点的位置不变,不会重新计算。默认值设置为 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 <= 32,000 |
sys id
该属性包含一个用于标识目的的正的只读整数。系统为每个卫星通信节点对象分配一个唯一的编号。该编号通常与对象定义的顺序对应:第一个创建的卫星节点的 sys id 为 0,第二个的 sys id 为 1,一般地,第 n 个节点的 sys id 为 n-1。它可以用于,例如,在路由中识别某个卫星节点,或在遍历链路以访问其属性时使用,或一般地,在需要唯一整数标识的任何场合。该属性仅存在于仿真过程中。
| Editing | Simulation | |
|---|---|---|
| Data Type | N/A | integer |
| Access | N/A | read |
| Default Value | None | |
| Units | N/A | |
| Constraints | unique for each satellite communications node object |
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 |
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 对应经度。在使用非度单位的子网中,它表示节点位于子网范围左边缘右侧的距离。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read |
| Default Value | N/A | |
| Units | N/A | |
| Constraints | None |
y position
该属性是通信节点位置的三个分量之一。三个分量是 x position、y position 和 altitude。在顶层子网或使用度为单位的任何子网中,y position 对应经度。在使用非度单位的子网中,它表示节点距子网范围顶边的距离。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read |
| Default Value | N/A | |
| Units | See description | |
| Constraints | None |