Engee documentation

EngeePhased.CrossedDipoleAntennaElement

Crossed dipole antenna element.

Library

EngeePhased

Description

The EngeePhased.CrossedDipoleAntennaElement system object models a crossed dipole antenna element that is used to generate a circularly polarised field. A crossed dipole antenna is formed from two orthogonal short dipoles.

By default, one dipole is located along the y axis and the other dipole is located along the z axis in the local antenna coordinate system.

You can rotate the antenna in the yz-plane using the RotationAngle property.

This antenna object generates fields with right-handed and left-handed circular polarisations, as well as a field with linear polarisation, controlled by the Polarization property. These fields propagate along the x axis (defined by the 0° azimuth and 0° elevation angles).

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

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

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

Syntax

Creation

The system object constructor can be called in the following ways:

  • object = EngeePhased.CrossedDipoleAntennaElement creates a crossed dipole antenna with by default property values. Example:

    antenna = EngeePhased.CrossedDipoleAntennaElement
  • object = EngeePhased.CrossedDipoleAntennaElement(Name=Value) creates a crossed dipole 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). Example:

    antenna = EngeePhased.CrossedDipoleAntennaElement(RotationAngle=20, Polarization="LHCP")

Utilisation

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

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.

RotationAngle - rotation angle of crossed dipoles
0 (by default) | scalar between -45° and +45°

Details

The rotation angle of the crossed dipoles, specified as a scalar between -45° and +45°.

The rotation angle specifies the angle of rotation of two dipoles about the x axis.

The rotation angle is measured anti-clockwise around the x axis towards the origin. By default value 0° corresponds to the case when one dipole is located along the z axis and the other dipole is located along the y axis.

The units of measurement are degrees.

Data types: Float64.

Polarization - transverse dipole field polarisation
RHCP (by default) | LHCP | Linear

Details

The polarisation of the field generated by the antenna is set as RHCP, LHCP or Linear.

  • RHCP is a field with right-hand circular polarisation. The horizontal field has a 90° phase shift compared to the vertical field.

  • LHCP is a field with left-hand circular polarisation. The horizontal field is lagged 90° behind the vertical field.

  • Linear - linearly polarised field. The horizontal and vertical fields are in phase.

Data types: char | string

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 returns 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

Azimuth and elevation angles of response 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 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

*Algorithms.

The total response of an antenna element with crossed dipoles is the combination of its frequency and spatial characteristics.

The EngeePhased.CrossedDipoleAntennaElement system object calculates both responses using nearest neighbour interpolation and then multiplies them to obtain the summed response.

See also

  1. Mott, H., "Antennas for Radar and Communications", John Wiley & Sons, 1992.