Engee 文档

EngeePhased.CustomAntennaElement

定制天线元件。

资料库

EngeePhased

说明

系统对象 EngeePhased.CustomAntennaElement 是一个具有自定义空间图案的天线元件模型。该模式可定义为极化或非极化场。

要创建自定义天线元件,请按以下步骤操作:

  1. 创建 EngeePhased.CustomAntennaElement 对象并设置其属性。

  2. 使用参数调用该对象,就像调用函数一样。

语法

创建

  • object = EngeePhased.CustomAntennaElement 创建一个具有 default 属性值的天线元素。默认响应模型为空间各向同性。

    示例:EngeePhased.CustomAtennaElement

    antenna = EngeePhased.CustomAntennaElement
  • object = EngeePhased.CustomAntennaElement(Name=Value) 创建一个自定义天线元素,将每个指定的 Name(名称)属性设置为指定的 价值观(值)。您可以以任意顺序(Name1=Value1,…​,NameN=ValueN)指定其他参数作为名值对(name-value pair)。例如,天线的输出响应取决于是否设置了极化。

    • 要创建无极化模式,可将 SpecifyPolarizationPattern 属性设置为 false(默认值)。然后使用 MagnitudePatternPhasePattern 属性定义响应模式。

    • 要创建极化模式,请将 SpecifyPolarizationPattern 属性设置为 "true"。然后使用 HorizontalMagnitudePatternHorizontalPhasePatternVerticalMagnitudePatternVerticalPhasePattern 属性中的任意一个或全部属性来定义方向性图案。

      示例

      antenna = EngeePhased.CustomAntennaElement ()

利用率

  • RESP = object(FREQ,ANG)` 返回参数 "RESP "在参数 "FREQ "指定的工作频率和参数 "ANG "指定的方向上的天线电压特性。 RESP 值的形状取决于天线元件是否支持 SpecifyPolarizationPattern 属性中定义的极化。

    • 如果 Specify Polarisation Pattern 属性设置为 "false",那么它就是一个 M 乘 L 的矩阵,包含在 ANG 参数中指定的角度和 FREQ 参数中指定的 L 频率下的天线响应。

    • 如果 Specify Polarisation Pattern 属性设置为 "true",则该结构包含两个字段 RESP.H 和 RESP.V,分别表示水平和垂直极化下的天线响应。每个字段都是一个 M 乘 L 矩阵,包含在 ANG 参数指定的角度和 FREQ 参数指定的 L 频率下的天线响应。

首次调用 RESP 对象时,会对其进行初始化。初始化将固定不可配置的属性和输入特征,如大小、复杂程度和输入数据类型。如果更改不可配置的属性或输入规范,系统对象将产生错误。要更改不可配置的属性或输入规格,必须首先调用释放方法来解锁对象。

属性

频率矢量 - 工作频率范围矢量
| [0 1e20](默认) | 行矢量 1 至 L

Details

要获取频率响应和天线模式的频率,以 1 至 L 的字符串矢量形式给出。矢量元素应按升序排列。在频率矢量的最小和最大元素所给出的频率范围之外,天线元素没有响应。

测量单位为赫兹。

例如: [200:50:300]*1e6

数据类型: Float64

频率响应 — 天线元件的频率特性
L 上的实向量 1

Details

FrequencyVector 属性定义的频率特性,以 L 上为 1 的字符串矢量形式指定。 L 等于 FrequencyVector 属性指定的矢量长度。

测量单位为 dB。

示例: [0 6 0]

数据类型: Float64

图案坐标系 - 用户天线图案的坐标系
az-el (默认) | phi-theta

Details

指定为 az-elphi-theta 的用户天线图案坐标系。

如果将 PatternCoordinateSystem 属性设置为 az-el,则使用 AzimuthAnglesElevationAngles 属性指定模式坐标系。

如果将 PatternCoordinateSystem 属性设置为 phi-theta,则使用 PhiAnglesThetaAngles 属性指定图案坐标系。

数据类型: char

方位角 - 方位角
长度为 P 的实向量

Details

以长度为 P 的矢量指定方位角。这些角度是指定自定义辐射模式的方位角。

方位角必须在 -180° 至 180° 的范围内,并严格按照升序排列。

测量单位为度。

示例: [30 40 40 50]

依赖关系

要启用此属性,请将 PatternCoordinateSystem 属性设置为 az-el

数据类型: Float64

ElevationAngles - 仰角
长度为 Q 的实向量

Details

以长度为 Q 的矢量指定仰角。这些角度是指定自定义辐射模式的仰角。Q 必须大于 2。仰角必须在 -90° 至 90° 的范围内,并严格按照升序排列。

测量单位为度。

示例: [-30 0 +30].

依赖关系

要启用此属性,请将 PatternCoordinateSystem 属性设置为 az-el

数据类型: Float64

PhiAngles - _phi-theta_坐标系中的Phi角
长度为 P 的实向量

Details

用于表示_phi-theta_坐标系中元素响应模式的 phi 角,以长度为 P 的实向量形式给出。phi 角的范围为 0° 至 360°。P 必须大于 2。

示例: [90:180]

依赖关系

要启用此属性,请将 PatternCoordinateSystem 属性设置为 phi-theta

数据类型: Float64

θ角 在_phi-theta_坐标系中的θ角
0:180`(默认) | 长度为 Q 的实向量

Details

用于表示_phi-theta_坐标系中元素响应模式的 Theta 角,以长度为 Q 的实向量形式给出。Theta 角的范围为 0° 至 180°。Q 必须大于 2。

示例: [40:80]

依赖关系

要启用此属性,请将 PatternCoordinateSystem 属性设置为 phi-theta

数据类型: Float64

SpecifyPolarisationPattern — 极化阵列响应
假(默认)` | `true

Details

极化数组响应指定为 falsetrue

  • 如果 SpecifyPolarisationPattern 属性设置为 false,天线元件将发射或接收非极化辐射。在这种情况下,使用 MagnitudePattern 属性来设置天线模式。

  • 如果 SpecifyPolarisationPattern 属性设置为 "true",则天线元素发射或接收极化辐射。在这种情况下,使用 HorizontalMagnitudePatternHorizontalPhasePattern 属性设置水平极化模式,使用 VerticalMagnitudePatternVerticalPhasePattern 属性设置垂直极化模式。

数据类型: logical

MagnitudePattern - 组合天线辐射模式的幅度
zeros(181,361) (默认) | P 上的实矩阵 Q | L 上的 P 上的实阵列 Q

Details

以矩阵 Q on P 或数组 Q on P on L 的形式指定的复合极化天线的辐射模式大小。该属性仅在 SpecifyPolarisationPattern 属性设置为 "false "时使用。

该值的测量单位为 dB。

  • 如果 MagnitudePattern 属性的值是一个 Q 乘 P 矩阵,则同一值将应用于 FrequencyVector 属性中指定的所有频率。

  • 如果 MagnitudePattern 属性的值是一个 Q 乘 P 乘 L 的数组,则每个 Q 乘 P 的数组结构都为 FrequencyVector 属性中指定的_appropriate_频率定义了一个模式。

如果该模式在任何方位角和仰角方向上包含 "NaN "值,它将被转换为 "Inf",表示该方向上的空响应。

系统对象 EngeePhased.CustomAntennaElement 使用插值法估算给定方向上的天线响应。为避免插值错误,自定义响应模式必须包含`[-180,180]度范围内的方位角。将仰角范围设置为 `[-90,90] 度。

数据类型: Float64

PhasePattern - 组合天线辐射模式的相位模式
zeros(181,361) (默认) | P 上的实矩阵 Q | L 上的 P 上的实阵列 Q

Details

组合极化天线的相位辐射模式,以矩阵 Q on P 或数组 Q on P on L 的形式给出。该属性仅在 SpecifyPolarisationPattern 属性设置为 "false "时使用。

测量单位为度。

  • 如果 PhasePattern 属性的值是 P 上 Q 的矩阵,则同一模式将应用于 FrequencyVector 属性中指定的所有频率。

  • 如果 PhasePattern 属性的值是一个 Q 乘 P 乘 L 的数组,则每个 Q 乘 P 的数组结构都为 FrequencyVector 属性中指定的_appropriate_频率定义了一个模式。

系统对象 EngeePhased.CustomAntennaElement 使用插值法估算给定方向上的天线响应。为避免插值错误,自定义响应模式必须包含`[-180,180]范围内的方位角。指定仰角范围为 `[-90°,90°] 度。

数据类型: Float64

HorizontalMagnitudePattern — 天线辐射模式水平极化分量的值
zeros(181,361)(默认)` | | | P 上的实矩阵 Q | L 上的实阵列 Q

Details

天线辐射模式水平极化分量的大小,以矩阵 Q on P 或阵列 Q on P on L 表示。

测量单位为 dB。

  • 如果 HorizontalMagnitudePattern 属性的值是 Q 乘 P 矩阵,则相同的模式将应用于 FrequencyVector 属性中指定的所有频率。

  • 如果 HorizontalMagnitudePattern 属性的值是一个 Q*P*L 数组,则每个 Q*P 数组结构都为 FrequencyVector 属性中指定的相应频率定义了一个模式。

如果该模式在任何方位角和仰角方向上包含 "NaN",则会转换为 "Inf",表示该方向上的空响应。

系统对象 EngeePhased.CustomAntennaElement 使用内插法估算给定方向上的天线响应。为避免插值错误,自定义辐射模式必须包含`[-180,180]范围内的方位角和[-90,90] 度`范围内的仰角。

依赖关系

要启用此属性,请将 SpecifyPolarisationPattern 属性设置为 true

数据类型: Float64

HorizontalPhasePattern -. 天线辐射模式中水平极化分量的相位模式

+ zeros(181,361)(默认) | P 上的 Q 实矩阵 | `L 上的 P 实阵列 Q

Details

天线辐射模式水平极化分量的相位,以矩阵 Q on P 或数组 Q on P on L 的形式给出。该属性只有在 SpecifyPolarisationPattern 属性设置为 "true "时才会使用。

测量单位为度。

  • 如果 HorizontalPhasePattern 属性的值是一个 Q 乘 P 矩阵,则同一模式将应用于 FrequencyVector 属性中指定的所有频率。

  • 如果 HorizontalPhasePattern 属性的值是一个 Q*P*L 数组,则每个 Q*P 数组结构都会为 FrequencyVector 属性中指定的_适当_频率定义一个模式。

系统对象 EngeePhased.CustomAntennaElement 使用插值法估算给定方向上的天线响应。为避免插值错误,自定义响应模板必须包含`[-180,180]范围内的方位角和[-90,90]`范围内的仰角。

依赖关系

要启用此属性,请将 SpecifyPolarisationPattern 属性设置为 true

数据类型: Float64

VerticalMagnitudePattern — 天线辐射模式垂直极化分量的值
zeros(181,361)(默认)` | | | P 上的实矩阵 Q | L 上的实阵列 Q

Details

天线辐射模式垂直极化分量的大小,以矩阵 Q on P 或阵列 Q on P on L 的形式给出。该属性只有在 SpecifyPolarisationPattern 属性设置为 "true "时才会使用。

测量单位为 dB。

  • 如果 VerticalMagnitudePattern 属性的值是一个 Q 乘 P 矩阵,则同一模式将应用于 FrequencyVector 属性中指定的所有频率。

  • 如果 VerticalMagnitudePattern 属性的值是一个 Q 乘 P 乘 L 的数组,则每个 Q 乘 P 数组结构都为 FrequencyVector 属性中指定的_appropriate_频率定义了一个模式。

如果该模式在任何方位角和仰角方向上包含 "NaN "值,它将被转换为 "Inf",表示该方向上的空响应。

系统对象 EngeePhased.CustomAntennaElement 使用插值法估计给定方向上的天线响应。为避免插值错误,用户响应模式必须包含`[-180,180]范围内的方位角和[-90,90]`度范围内的仰角。

依赖关系

要启用此属性,请将 SpecifyPolarisationPattern 属性设置为 true

数据类型: Float64

VerticalPhasePattern -. 天线辐射模式垂直极化分量的相位模式
zeros(181,361) (默认) | P 上的实矩阵 Q | L 上的 P 上的实阵列 Q.

Details

天线辐射模式垂直极化分量的相位,以矩阵 Q on P 或阵列 Q on P on L 的形式给出。该属性只有在 SpecifyPolarisationPattern 属性设置为 "true "时才会使用。

测量单位为度。

  • 如果 VerticalPhasePattern 属性的值是 P 上 Q 的矩阵,则同一模式将应用于 FrequencyVector 属性中指定的所有频率。

  • 如果 VerticalPhasePattern 属性的值是一个 Q 乘 P 乘 L 的数组,则每个 Q 乘 P 的数组结构都为 FrequencyVector 属性中指定的_appropriate_频率定义了一个模式。

系统对象 EngeePhased.CustomAntennaElement 使用插值法估算给定方向上的天线响应。为避免插值错误,自定义响应模板必须包含`[-180,180]范围内的方位角和[-90,90]`范围内的仰角。

依赖关系

要启用此属性,请将 SpecifyPolarisationPattern 属性设置为 true

数据类型: Float64

MatchArrayNormal - 将元素正常值匹配为数组正常值
true (default) | false

Details

MatchArrayNormal 属性设置为 true,使天线元素与阵列法线对齐。天线图案将被旋转,使元素坐标系的 轴沿着阵列法线指向。该属性仅在天线元素属于阵列时使用。

MatchArrayNormal 属性设置为 "false",可在不旋转的情况下使用元素模板。

数据类型: logical

参数

输入

FREQ -. 天线元件的工作频率
L线上的非负实向量 1

Details

天线元件的工作频率,以 L 线的非负标量或非负实数矢量 1 表示。

测量单位为 Hz。 FREQ 必须在元件的 FrequencyRange 属性指定的数值范围内。 否则,元素将无法响应,响应将以 -Inf 返回。元素对象使用 FrequencyRange 属性,但 phased.CustomAntennaElement 除外,它使用 FrequencyVector 属性。

*示例`[1e8 2e6]`.

数据类型: Float64

ANG - 反应方向的方位角和高度角
M` 上第 1 行的实向量 |` M` 上的实矩阵 2

Details

答案方向的方位角和高度角,以 M 表示的第 1 行实数矢量或 M 表示的第 2 行实数矩阵表示,其中 M 是角度方向的个数。

度量单位为度。

方位角必须在 -180°至 180°(含 180°)的范围内。仰角应在-90°至 90°(含 90°)的范围内。

如果 ANG 是 M 上的矢量 1,则每个元素指定一个方位角。在这种情况下,相应的仰角假定为零。

如果 ANG 是 M 上的矩阵 2,矩阵的每一列以 [方位角;仰角] 的形式指定一个方向。

方位角是 x 轴与方向向量在 xy 平面上的投影之间的夹角。从 x 轴向 y 轴测量时,该角度为正。仰角是方向矢量与 xy 平面之间的夹角。沿 z 轴方向测量时,该角度为正。

*举例说明[110 125; 15 10]

数据类型: Float64

输出

RESP — 天线模式
L 上的复矩阵 M

Details

天线元件的电压响应,以复数矩阵 M on L 的形式返回。在该矩阵中,M 是在 ANG 中指定的角度数,L 是在 FREQ 中指定的频率数。

数据类型: Float64

方法

所有系统对象通用

step!

启动系统对象的运行算法 release!: 更改系统对象属性值的权限 reset!: 重置系统对象的内部状态

可选

* 算法。

定制天线元件的整体响应是其频率和空间特性的组合。

系统对象 EngeePhased.CustomAntennaElement 使用近邻插值法计算这两个响应,然后将它们相乘形成整体响应。