Engee documentation

EngeePhased.SincAntennaElement

An antenna with a directional pattern in the form of a cardinal sine.

Library

EngeePhased

Description

An object EngeePhased.SincAntennaElement simulates an antenna with a radiation pattern in the form of a cardinal sine (see A directional pattern in the form of a cardinal sine). Such an antenna is a uniformly irradiated rectangular antenna.

Antennas with a cardinal-sine radiation pattern are often used as an approximation for sector antennas or antenna arrays.

The side lobes are −13.6 dB relative to the gain of the main beam. The axis by azimuth angle and The angle of the location is considered the main axis of the antenna pattern. When placed in a linear or rectangular grid, the main axis coincides with the grid normal.

To create and use a dipole antenna, follow these steps:

  1. Create an object EngeePhased.SincAntennaElement 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.SincAntennaElement() — creates an antenna with a radiation pattern in the form of a cardinal sine with default property values.

  • antenna = EngeePhased.SincAntennaElement(Name=Value) — creates an antenna with a radiation pattern in the form of a cardinal sine 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.

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 have a directional pattern and returns it as −Inf.

The units of measurement are Hz.

Типы данных

Float64

ANG — azimuth angle and angle of the radiation pattern location

+ 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

A directional pattern in the form of a cardinal sine

Details

System object EngeePhased.SincAntennaElement returns a radiation pattern in the form of a cardinal sine.

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

where

 — azimuth coefficient, which depends on the azimuth angle and the beam width at the half-power level along the azimuth angle :

+

+ Specify as the first element of the Beamwidth;

  •  — the coefficient of the place, which depends on the angle of the place and the beam width at the half-power level at the angle of the seat :

    Specify as the second property element Beamwidth;

  •  — the normalization factor, which provides half power corresponding to the beam width at half power. This coefficient is the solution: