Engee documentation

EngeePhased.GaussianAntennaElement

The Gaussian antenna.

Library

EngeePhased

Description

System object EngeePhased.GaussianAntennaElement simulates an antenna with a Gaussian radiation pattern.

Despite the fact that the Gaussian radiation pattern is idealized, it is often used to approximate other antennas in modeling, since it accurately repeats the radiation pattern of many antennas to about the level of −10 dB.

The Gaussian beam has no side lobes. Azimuth angle and the angle of the place They are considered the main axes of the antenna pattern. When placed in a linear or rectangular antenna array, the main axis of the radiation pattern coincides with the grid normal.

To create and use an antenna with a Gaussian radiation pattern, follow these steps:

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

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

To learn more about how to work with system objects, see Engee System Objects.

Syntax

Creation

  • antenna = EngeePhased.GaussianAntennaElement () — creates a Gaussian antenna with default property values. This object simulates a Gaussian beam, which exactly repeats the radiation pattern of many antennas to about the level of −10 dB. The Gaussian beam has no side lobes.

  • antenna = EngeePhased.GaussianAntennaElement(Name=Value) — creates a Gaussian antenna with specified properties in the form of a pair Name=Value, where Name — the name of the property, and Value — the appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their default values.

    Example:

    antenna=EngeePhased.GaussianAntennaElement(FrequencyRange=[10e10 15e10])

Using

  • RESP = antenna(FREQ,ANG) — returns the antenna radiation pattern RESP at the operating frequencies FREQ in the directions ANG.

Arguments

Input arguments

FREQ — the operating frequencies of the antenna element

+ scalar | vector is a string of length L

Details

The antenna’s operating frequencies, specified as a real positive scalar or a real vector, are strings of length containing positive numbers.

Typical values are in the range FrequencyRange. Otherwise, the element does not give a directional pattern and returns it as −Inf.

The units of measurement are Hz.

Типы данных

Float64

ANG — azimuth angle and angle of the radiation pattern

+ vector is a string of length M | the 2 by M matrix

Details

The directions of the radiation pattern, specified as a real vector, are strings of length or a real matrix on .

If ANG is a matrix, then each column defines a direction in the form [azimuth; elevation]. The azimuthal angle should be in the range of −180° before 180° inclusive. The angle of the seat should be in the range of −180° before 180° inclusive.

If ANG is a string vector, each element sets the azimuth angle of the direction. In this case, the corresponding seat angle is assumed to be .

The units of measurement are degrees.

For more information about the azimuth angle and the location angle, see Azimuthal angles and location angles.

Типы данных

Float64

Output arguments

RESP — antenna pattern

+ the complex matrix M on L

Details

The radiation pattern of the antenna element, returned as a complex matrix on , where — the number of angles specified in ANG, — the number of frequencies specified in FREQ.

Features

# FrequencyRange — operating frequency range

+ [0.0 1.0e20] (by default) | A non-negative real vector is a 1 by 2 row

Details

The operating frequency range of the antenna, set as a non-negative real vector on in the format [LowerBound HigherBound]. The antenna element does not have a radiation pattern outside the specified frequency range.

The units of measurement are Hz.

# Beamwidth is the beam width of the antenna pattern
[10 10] (by default) | scalar | The real vector is 1 by 2

Details

The beam width of the antenna pattern, set as a scalar or vector with a real value on .

If the specified value is a vector on , it has the form [AzimuthBeamwidth ElevationBeamwidth].

If the specified value is a scalar, then the beam width along the azimuth angle and the angle of the location are equal.

The units of measurement are degrees.

Methods

Common to all system objects

step!

Running the system object operation algorithm

release!

Permission to change the value of a system object property

reset!

Resetting the internal states of a system object

Additional Info

Gaussian radiation pattern

Details

System object EngeePhased.GaussianAntennaElement returns the radiation pattern of the Gaussian antenna element.

If — azimuthal angle in degrees, and — the angle of the place in degrees, then the directional pattern has the form:

where

  •  — the beam width at the level of half the power at the azimuth angle, is set as the first element of the property Beamwidth;

  •  — the beam width at the level of half the power at the angle of the location, is set as the second element of the property Beamwidth.

Examples

Gaussian radiation pattern

Details

Let’s create a Gaussian antenna and plot the radiation pattern along the azimuth angle. The antenna can operate in the frequency range from 800 MHz up to 1.2 GHz and has an operating frequency 1 GHz.

using EngeePhased

element = EngeePhased.GaussianAntennaElement(FrequencyRange=[800e6 1.2e9]);
fc = 1e9;

pattern(element,fc,-180:180,0,CoordinateSystem="polar")

so gaussian antenna element

Let’s find the value of the antenna radiation pattern at the point of sight.

ang = [0 0]';
resp = element(fc,ang)
1.0