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（默认值）。然后使用 MagnitudePattern 和 PhasePattern 属性定义响应模式。

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

      示例

      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-el 或 phi-theta 的用户天线图案坐标系。

如果将 PatternCoordinateSystem 属性设置为 az-el，则使用 AzimuthAngles 和 ElevationAngles 属性指定模式坐标系。

如果将 PatternCoordinateSystem 属性设置为 phi-theta，则使用 PhiAngles 和 ThetaAngles 属性指定图案坐标系。

数据类型: 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

极化数组响应指定为 false 或 true。

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

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

数据类型: 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 使用近邻插值法计算这两个响应，然后将它们相乘形成整体响应。