天线对象

与无线电发射机和接收机相关的天线特性通过天线对象的属性来指定。这为在节点内为一组接收机和发射机分配相同的天线特性提供了一种便捷方式。

天线仅用于对无线电传输建模,并且只通过其与无线电发射机和接收机的关联来影响仿真。数据包流(packet stream)用于将天线与接收机和发射机耦合。数据包流可以从无线电发射机引向天线,或从天线引向无线电接收机。不允许与天线进行其他任何连接。

在节点编辑器(Node Editor)中,天线默认表示为方形框,框内有一个抛物面天线的图像。天线的名称显示在其下方,如下图所示:

图 62:天线表示形式

天线表示形式

天线对象的主要用途是允许对无线电接收机和发射机的方向性增益进行建模。每个天线都分配一个方向图(增益方向图),它规定了相对于全向(isotropic)辐射功率的增益,其取值随水平面和垂直面偏转角(极角和方位角)变化。因此,天线增益方向图是由两个变量生成的三维模型。

天线对象属性

天线对象的内置属性列于下表。

表 22:天线对象内置属性

Name Data Type
name string
pattern typed file
boresight azimuth toggle double
boresight polar toggle double
antenna location compound
target location coordinate type enum
target location: global coordinates compound
target location: body coordinates compound
secondary target location coordinate type enum
secondary target location: global coordinates compound
secondary target location: body coordinates compound
icon name icon

antenna location

该复合属性指定天线相对于其所在节点的放置位置。位置由相对于节点位置的 x、y 和 z 偏移量(以米计)给出(详情参见“天线坐标系”第 60 页中关于本体坐标(body coordinates)的描述)。

Editing Simulation
Data Type compound compound
Access read / write read / write

x (m)

该子属性指定天线在其所在节点 x 轴上的位置。正值表示朝向节点前方的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units meters
Constraints none

¹ 若要从仿真代码访问该子属性,请将其视为名为 “antenna x” 的顶层属性(而不是 “antenna location” 的子属性)。

y (m)

该子属性指定天线在其所在节点 y 轴上的位置。正值表示朝向节点左侧的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units meters
Constraints none

¹ 若要从仿真代码访问该子属性,请将其视为名为 “antenna y” 的顶层属性(而不是 “antenna location” 的子属性)。

z (m)

该子属性指定天线在其所在节点 z 轴上的位置。正值表示朝向节点顶部的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 1.5
Units meters
Constraints none

¹ 若要从仿真代码访问该子属性,请将其视为名为 “antenna z” 的顶层属性(而不是 “antenna location” 的子属性)。

boresight azimuth

该属性指定用于天线指向的参考方向的方位角分量。通常,视准轴(boresight)方向继承自天线方向图;对于不包含视准轴信息的较旧天线方向图,可使用该属性指定参考方向。

Editing Simulation
Data Type toggle double double
Access read / write / promote read / write
Default Value inherit from pattern (disabled)
Units degrees
Constraints 0.0 <= boresight azimuth < 360.0

boresight polar

该属性指定用于天线指向的参考方向的极角分量。通常,视准轴方向继承自天线方向图;对于不包含视准轴信息的较旧天线方向图,可使用该属性指定参考方向。

Editing Simulation
Data Type toggle double double
Access read / write / promote read / write
Default Value inherit from pattern (disabled)
Units degrees
Constraints 0.0 <= boresight polar <= 180.0

icon name

该属性指定在节点编辑器显示和节点模型打印输出中用于表示天线模块的图标名称。图标可以用图标编辑器创建。该属性的取值对仿真行为没有影响。

Editing Simulation
Data Type icon N/A
Access read / write N/A
Default Value antenna
Units
Constraints

name

该属性是用户为天线模块指定的标识。分配给该属性的值显示在节点图中该模块图标的下方。它也可用于在仿真期间引用该对象。有关更多信息,参见内核过程(Kernel Procedure)op_id_from_name() 的文档。

Editing Simulation
Data Type string string
Access read / write read
Default Value a_n, n >= 0
Units N/A
Constraints unique in node model; no dots

pattern

该属性指定天线方向图增益表的名称,该增益表用于将三维传输方向映射为天线增益。天线方向图增益表可以在天线方向图编辑器(Antenna Pattern Editor)中构建,或通过外部模型访问(External Model Access, EMA)包构建。天线方向图增益表通常由无线电收发管道(Radio Transceiver Pipeline)的天线增益级 “tagain model” 和 “ragain model” 使用。

Editing Simulation
Data Type typed file string
Access read / write / promote read / write
Default Value isotropic
Units
Constraints

secondary target location: body coordinates

该复合属性指定天线次级参照点(secondary reference point)的瞄准点,以本体坐标表示(如“天线坐标系”第 60 页所述)。瞄准点由相对于包含该天线的节点的 x、y 和 z 坐标给出。当 secondary target location coordinate type 属性设置为 “body” 时,使用该属性确定次目标位置。

在仿真期间,该属性可用于使天线的次级参照保持指向相对于其所在节点的特定方向。

Editing Simulation
Data Type compound compound
Access read / write / promote read / write

x (m)

该子属性指定目标在 antenna 所在节点 x 轴上的位置。正值表示朝向节点前方的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 2.0
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “secondary target x” 的顶层属性(而不是 “secondary target location: body coordinates” 的子属性)。

y (m)

该子属性指定目标在 antenna 所在节点 y 轴上的位置。正值表示朝向节点左侧的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 2.0
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “secondary target y” 的顶层属性(而不是 “secondary target location: body coordinates” 的子属性)。

z (m)

该子属性指定目标在 antenna 所在节点 z 轴上的位置。正值表示朝向节点顶部的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 1.5
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “secondary target z” 的顶层属性(而不是 “secondary target location: body coordinates” 的子属性)。

secondary target location: global coordinates

该复合属性指定天线次级参照点的瞄准点,以全局坐标(global coordinates)表示(如“天线坐标系”第 60 页所述)。瞄准点由纬度、经度和高度给出。当 secondary target location coordinate type 属性设置为 “global” 时,使用该属性确定次目标位置。

在仿真期间,该属性可用于使次级参照点保持指向特定位置(例如某个固定节点)。

Editing Simulation
Data Type compound compound
Access read / write / promote read / write

latitude (deg)

该子属性指定次目标位置的纬度分量。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units degrees
Constraints -90.0 <= latitude <= 90.0

¹ 若要从仿真代码访问该子属性,请将其视为名为 “secondary target latitude” 的顶层属性(而不是 “secondary target location: global coordinates” 的子属性)。

longitude (deg)

该子属性指定次目标位置的经度分量。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units degrees
Constraints -180.0 <= longitude <= 180.0 (-180 is equivalent to 180)

¹ 若要从仿真代码访问该子属性,请将其视为名为 “secondary target longitude” 的顶层属性(而不是 “secondary target location: global coordinates” 的子属性)。

altitude (m)

该子属性指定次目标位置的高度分量。高度从地球表面起算。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “secondary target altitude” 的顶层属性(而不是 “secondary target location: global coordinates” 的子属性)。

secondary target location coordinate type

该属性指定天线次级参照瞄准点所使用的坐标类型。根据该属性的取值,目标位置将由 secondary target location: global coordinates 或 secondary target location: body coordinates 属性指定。

Editing Simulation
Data Type enum enum
Access read / write / promote read
Default Value global
Units
Constraints global, body

target location: body coordinates

该复合属性指定天线视准轴的瞄准点,以本体坐标表示(如“天线坐标系”第 60 页所述)。瞄准点由相对于包含该天线的节点的 x、y 和 z 坐标给出。当 target location coordinate type 属性设置为 “body” 时,使用该属性确定目标位置。

在仿真期间,该属性可用于使天线视准轴保持指向相对于其所在节点的特定方向。

Editing Simulation
Data Type compound compound
Access read / write / promote read / write

x (m)

该子属性指定目标在 antenna 所在节点 x 轴上的位置。正值表示朝向节点前方的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 4.0
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “target x” 的顶层属性(而不是 “target location: body coordinates” 的子属性)。

y (m)

该子属性指定目标在 antenna 所在节点 y 轴上的位置。正值表示朝向节点左侧的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “target y” 的顶层属性(而不是 “target location: body coordinates” 的子属性)。

z (m)

该子属性指定目标在 antenna 所在节点 z 轴上的位置。正值表示朝向节点顶部的位置。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 1.5
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “target z” 的顶层属性(而不是 “target location: body coordinates” 的子属性)。

target location: global coordinates

该复合属性指定天线视准轴的瞄准点,以全局坐标表示(如“天线坐标系”第 60 页所述)。瞄准点由纬度、经度和高度给出。当 target location coordinate type 属性设置为 “global” 时,使用该属性确定目标位置。

在仿真期间,该属性可用于使天线视准轴保持指向特定位置(例如某个固定节点)。

Editing Simulation
Data Type compound double
Access read / write / promote read / write

latitude (deg)

该子属性指定目标位置的纬度分量。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units degrees
Constraints -90.0 <= latitude <= 90.0

¹ 若要从仿真代码访问该子属性,请将其视为名为 “target latitude” 的顶层属性(而不是 “target location: global coordinates” 的子属性)。

longitude (deg)

该子属性指定目标位置的经度分量。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units degrees
Constraints -180.0 <= longitude <= 180.0 (-180 is equivalent to 180)

¹ 若要从仿真代码访问该子属性,请将其视为名为 “target longitude” 的顶层属性(而不是 “target location: global coordinates” 的子属性)。

altitude (m)

该子属性指定目标位置的高度分量。高度从地球表面起算。

Editing Simulation¹
Data Type double double
Access read / write / promote read / write
Default Value 0.0
Units meters
Constraints

¹ 若要从仿真代码访问该子属性,请将其视为名为 “target altitude” 的顶层属性(而不是 “target location: global coordinates” 的子属性)。

target location coordinate type

该属性指定天线视准轴瞄准点所使用的坐标类型。根据该属性的取值,目标位置将由 target location: global coordinates 或 target location: body coordinates 属性指定。

Editing Simulation
Data Type enum enum
Access read / write / promote read
Default Value global
Units
Constraints global, body

天线对象统计

天线模块不生成任何统计量。

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