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:
-
Create an EngeePhased.GaussianAntennaElement object and set its properties.
-
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])
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
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.