Engee documentation

EngeePhased.UCA

Uniform circular Phased array (UCA) antenna.

Library

EngeePhased

Description

System object EngeePhased.UCA simulates a uniform circular array (UCA). The UCA is formed from identical antenna element elements evenly spaced around the circumference.

To create and use a UCA, follow these steps:

  1. Create an object EngeePhased.UCA 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

  • uca = EngeePhased.UCA() — creates a UCA with default property values. The object simulates a UCA consisting of five identical isotropic antenna elements EngeePhased.IsotropicAntennaElement, uniformly distributed around a circle with a radius of 0.5 m.

  • uca = EngeePhased.UCA(Name=Value) — creates a UCA with the specified properties as 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:

    uca = EngeePhased.UCA(NumElements=3, Radius=7.5)

Using

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

Arguments

Input arguments

FREQ — operating frequencies of the antenna array

+ scalar | vector is a string of length L

Details

The operating frequencies of the antenna array, specified as a real positive scalar or a real vector, are strings of length containing positive numbers. Typical values are in the range specified by the properties of the FrequencyRange or FrequencyVector element, depending on the type of element in the antenna array. The element has a zero radiation pattern at frequencies outside this range.

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 array radiation pattern

+ a complex array of N by M by L

Details

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

Features

# Element — element of the antenna array

+ IsotropicAntennaElement (by default) | the system object of the antenna array element

Details

An element of the antenna array, defined as a system object antenna, microphone or converter.

By default, it is used EngeePhased.IsotropicAntennaElement.

# numElements — the number of grid elements

+ 5 (by default) | an integer greater than one

Details

The number of grid elements specified as an integer greater than one.

# Radius — the radius of the antenna array

+ 0.5 (by default) | positive scalar

Details

The radius of the lattice, defined as a positive scalar.

The units of measurement are m.

# ArrayNormal — direction of the lattice normal

+ "z" (by default) | "x" | "y"

Details

The direction of the lattice normal, set as one of the directions "x", "y" or "z".

The UCA elements lie in a plane orthogonal to the direction of the UCA normal. The vectors of the maximum directions of the radiation pattern lie in the same plane and are directed radially from the origin.

"x" The elements of UCA lie in - planes. All the normal vectors of the elements are directed along the axis . This value is used by default.

"y"

The UCA elements lie in the plane . The normal vectors of all elements are directed along the axis .

"z"

The UCA elements lie on a plane . The normal vectors of all elements are directed along the axis .

# Taper — complex weighting coefficients for amplitude weighing

+ 1 (by default) | the complex scalar | A complex vector is a row of 1 by N | The complex column vector is N by 1

Details

Complex weighting coefficients for antenna array elements, given as a complex scalar, a complex string vector on or a complex column vector on , where It represents the number of antenna array elements. Weighting factors are applied to each antenna element of the antenna array and change the amplitude and phase of the received data.

  • If Taper is a scalar, the same coefficient value is applied to all elements of the antenna array.

  • If Taper is a vector, its own coefficient value is applied to each element of the antenna array.

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 UCA is formed from identical elements evenly spaced around a circle of radius . The circle lies in the plane the local coordinate system, the origin of which lies in the center of the circle.

The positions of the elements are determined relative to the local coordinate system of the array.

The normal to the UCA plane lies along the positive axis . The elements are oriented so that the maximum of the radiation pattern is directed radially outward in the plane .

so uca

If the number of UCA elements is odd, the middle element lies on the axis .

If the number of UCA elements is even, the point located in the middle between the two middle elements is on the axis .

For UCA from elements azimuth angle of position The element is defined as follows:

where .

The azimuthal angle is the angle between the axis and its orthogonal projection onto a plane .

The angle of a place is the angle between a vector and its orthogonal projection onto a plane. . The angular distance between any two adjacent elements is degrees. The azimuthal angles are given in degrees. The angles of location for all UCA elements are zero.

Literature

  1. Brookner, E., ed. Radar Technology. Lexington, MA: LexBook, 1996.

  2. Van Trees, H. Optimum Array Processing. New York: Wiley-Interscience, 2002, pp. 274—304.