Engee documentation

EngeePhased.CrossedDipoleAntennaElement

An antenna with crossed dipoles.

Library

EngeePhased

Description

System object EngeePhased.CrossedDipoleAntennaElement simulates an antenna element with crossed dipoles, which is used to generate a circularly polarized field. An antenna with crossed dipoles is formed from two orthogonal short dipoles.

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

You can rotate the antenna in the plane using the RotationAngle.

This antenna object generates fields with right-hand and left-hand circular polarizations, as well as a field with linear polarization controlled using the Polarization property. These fields are distributed along the axis ( determined by azimuth angles and places ).

To create and use an antenna with crossed dipoles, follow these steps:

  1. Create an object EngeePhased.CrossedDipoleAntennaElement 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.CrossedDipoleAntennaElement() — creates an antenna with crossed dipoles with default property values.

  • antenna = EngeePhased.CrossedDipoleAntennaElement(Name=Value) — creates an antenna with crossed dipoles 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.CrossedDipoleAntennaElement(RotationAngle=20, Polarization="LHCP")

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

+ 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.

Типы данных

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.

# rotationAngle is the angle of rotation of the crossed dipoles

+ 0 (by default) | the scalar between −45° and +45°

Details

The angle of rotation of the crossed dipoles, set as a scalar in the range from −45° before +45°.

This property sets the angle of rotation of the two dipoles around the axis. .

The rotation angle is measured counterclockwise around the axis towards the origin. Default value corresponds to the case when one dipole is located along the axis , and the other is along the axis .

The units of measurement are degrees.

# Polarization — transverse dipole polarization of the field

+ "RHCP" (by default) | "LHCP" | "Linear"

Details

Polarization of the field generated by the antenna:

  • "RHCP" — a field with right-hand circular polarization. The horizontal field has a phase shift of 90° compared to the vertical field.

  • "LHCP" — a field with left-hand circular polarization. The horizontal field is delayed by 90° compared to the vertical one.

  • "Linear" — linearly polarized field. The horizontal and vertical fields are in phase.

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

Algorithms

Details

The total radiation pattern of an antenna element with crossed dipoles is a combination of its frequency and spatial characteristics.

System object EngeePhased.CrossedDipoleAntennaElement calculates both radiation patterns by interpolating the nearest neighbors, and then multiplies them to obtain the total radiation pattern.

Azimuthal angles and location angles

Details

The azimuthal angle of a vector is the angle between the axis and its orthogonal projection onto a plane . The angle is positive when turning away from the axis to the axis . The azimuthal angles range from −180° before 180° degrees inclusive. The angle of a place is the angle between a vector and its orthogonal projection onto a plane. . The angle is positive if it is directed towards the positive axis. from the plane . The angles of the place range from −90° before 90° degrees inclusive.

pattern

Literature

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