Engee documentation

EngeePhased.GaussianAntennaElement

Gaussian antenna element.

Library

EngeePhased

Description

The EngeePhased.GaussianAntennaElement system object models an antenna with a Gaussian response.

Although the Gaussian pattern is idealised, it is often used to approximate other antennas in simulations because its response exactly follows the pattern of many antennas up to about the -10dB level.

The Gaussian beam has no side lobes. The 0° azimuth and 0° elevation are considered the principal axes of the antenna response. When placed in a linear or rectangular array, the principal response axis coincides with the normal of the array.

Follow the steps below to calculate the antenna element response for the given directions:

  1. Create an EngeePhased.GaussianAntennaElement object and set its properties.

  2. Call the object with arguments as if it were a function.

Syntax

Creation

  • object = EngeePhased.GaussianAntennaElement creates a Gaussian antenna. This object models a Gaussian beam that exactly replicates the pattern of many antennas up to about -10 dB. The Gaussian beam has no side lobes. Example:

    antenna=EngeePhased.GaussianAntennaElement
  • object = EngeePhased.GaussianAntennaElement(Name=Value) creates a Gaussian antenna object with each specified property Name (name) set to the specified Value (value). You can specify additional arguments as a name-value pair in any order (Name1=Value1,…​,NameN=ValueN). For example, FrequencyRange=`[1e6 1e9] indicates that the antenna operates in the frequency range of 1 MHz to 1 GHz. Example:

    antenna=EngeePhased.GaussianAntennaElement(FrequencyRange=[4 7])

Usage

  • RESP = object(FREQ,ANG) returns the antenna voltage characteristic RESP at the operating frequencies specified in the FREQ argument and the directions specified in the ANG argument.

Properties

FrequencyRange - operating frequency range
[0 1e20] (by default) | non-negative real vector of strings 1 by 2

Details

The operating frequency range of the antenna, specified as a non-negative real vector of 1 by 2 rows in the form [LowerBound HigherBound]. The antenna element has no response outside the specified frequency range.

The units of measurement are Hz.

Data types: Float64

Beamwidth - antenna beamwidth
[10 10] (by default) | scalar | real vector 1 by 2

Details

Antenna pattern beamwidth specified as a scalar or vector with a real value of 1 by 2.

If the specified value is a 1-by-2 vector, it is [AzimuthBeamwidth ElevationBeamwidth].

If the specified value is a scalar, the azimuth and elevation beamwidths are equal.

The units of measurement are degrees.

*Example: 15

Data types: Float64

Arguments

Input

FREQ - antenna element operating frequency
non-negative scalar | non-negative real vector 1 on L lines

Details

The operating frequency of the antenna element given as a non-negative scalar or a non-negative real vector 1 on L lines.

The units of measurement are Hz.

FREQ must lie within the range of values specified by the FrequencyRange property of the element. Otherwise, the element does not respond and the response is returned as -Inf.

*Example: [1e8 2e6].

Data types: Float64

ANG - azimuth and altitude angles of response directions
` real vector of rows 1 on M` | ` real matrix 2 on M`

Details

Azimuthal and altitude angles of the answer directions given as a real vector of lines 1 by M or a real matrix 2 by M, where M is the number of angular directions.

The units of measurement are degrees.

The azimuth angle must lie in the range from -180° to 180° inclusive. Elevation angle shall lie in the range from -90° to 90° inclusive.

If ANG is a vector 1 on M, each element specifies an azimuthal angle of direction. In this case, the corresponding elevation angle is assumed to be zero.

If ANG is a matrix 2 on M, each column of the matrix specifies a direction in the form [azimuth;elevation].

The azimuth angle is the angle between the x-axis and the projection of the direction vector onto the xy plane. This angle is positive when measured from the x-axis towards the y-axis. Elevation angle is the angle between the direction vector and the xy plane. This angle is positive when measured in the z-axis direction.

*Example: [110 125; 15 10]

Data types: Float64

Output

RESP - antenna pattern
`complex matrix M on L

Details

The voltage response of the antenna element, returned as a complex matrix M on L. In this matrix, M is the number of angles specified in ANG and L is the number of frequencies specified in FREQ.

Data types: Float64

Methods

Common for all system objects

step!

Starts the system object’s operating algorithm

release!

Permission to change the value of a system object property

reset!

Reset the internal states of the system object

Optional

*Gaussian response.

The EngeePhased.GaussianAntennaElement system object returns the field response (also called the radiation pattern) of a Gaussian antenna element.

If is the azimuth angle in degrees and is the elevation angle in degrees, the field response is of the form:


where the azimuthal half-power beamwidth of is given as the first element of the Beamwidth property, and the elevation half-power beamwidth of is given as the second element of the Beamwidth property.