Engee documentation

EngeePhased.IsotropicAntennaElement

Isotropic antenna element.

*Library: EngeePhased

Description

The EngeePhased.IsotropicAntennaElement object models an antenna element with an isotropic radiation pattern. The response of the antenna element is unity in all directions. An isotropic antenna does not support polarisation.

To calculate the response of the antenna element for the specified directions, follow the steps below:

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

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

Constructor

  • antenna = EngeePhased.IsotropicAntennaElement creates an Isotropic Antenna System object, antenna, with property values by default.

  • antenna = EngeePhased.IsotropicAntennaElement(Name,Value) creates an Isotropic Antenna System object, antenna, 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).

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

Properties

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

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.

BackBaffled - back reflector of the Backbaffle antenna element
false (By default) | true

The Backbaffle property for the antenna element is set as false or true.

Set this property to true to backbaffle the response from the back side of the antenna element. In this case, the antenna response to all azimuth angles greater than ±90° from the wide side (0° in azimuth and 0° in elevation) is zero.

When the value of this property is `false', the back side of the antenna element has no deflector.

Data types: logical

Arguments

Input

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

Operating frequency of the antenna element specified as a non-negative scalar or 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 fails to respond and the response is returned as -Inf. Element objects use the FrequencyRange property, except for phased.CustomAntennaElement, which uses the FrequencyVector property.

*Example: [1e8 2e6].

Data types: Float64.

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

Azimuthal and altitude angles of the answer directions given as a real vector of strings 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 volt-ampere characteristic
complex matrix M on L

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!

Start the algorithm of the system object

release!

Allow changing the value of the system object property

reset!

Reset internal states of the system object