移动通信节点对象

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

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