卫星通信节点对象

卫星通信节点是节点模型的实例。其内部结构可编辑,由若干模块组成,这些模块按照用户提供的设计对数据包(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

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