Engee documentation

EngeePhased.ConformalArray

Conformal antenna array.

Library

EngeePhased

Description

The EngeePhased.ConformalArray system object creates a conformal antenna array. A conformal antenna array can contain elements at any position pointing in any direction.

To calculate the response for each element of the antenna array for the specified directions, perform the following steps:

  1. Identify and configure your conformal antenna array. See Sect. Creation.

  2. Call the step! method to compute the response according to the properties of the EngeePhased.ConformalArray system object.

Syntax

Creation

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

  • object = EngeePhased.ConformalArray creates a conformal antenna array. The object models a conformal antenna array formed from identical sensor elements. Example:

    H = EngeePhased.ConformalArray
  • object = EngeePhased.ConformalArray(Name=Value) creates a conformal antenna array 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:

    H = EngeePhased.ConformalArray(ElementNormal=[2; 4])
  • object = EngeePhased.ConformalArray(POS,NV,Name=Value) creates a conformal antenna array with property ElementPosition (set to POS), property ElementNormal (set to NV) with each specified property Name (name) set to the specified Value (value). POS and NV are value-only arguments. When specifying a value-only argument, all preceding value-only arguments must be specified. The Name=Value arguments can be specified in any order. Example:

    H = EngeePhased.ConformalArray(POS,NV,ElementNormal=[2; 4])

Properties

Element -. antenna element
system object EngeePhased.IsotropicAntennaElement (by default)

Details

An antenna array of sensor elements specified as an antenna element, acoustic element, or transducer.

  • By default: EngeePhased.IsotropicAntennaElement with properties by default.

ElementPosition - antenna element positions
[0; 0; 0] (by default) | matrix 3 by N

Details

The positions of the elements in a conformal antenna array as a 3-by-N matrix, where N is the number of elements in the conformal antenna array.

Each ElementPosition column represents the position as [x; y; z] of one element in the local coordinate system of the antenna array. The origin of the local coordinate system is at an arbitrary point.

The units of measurement are m.

By default [0; 0; 0; 0] of this property represents a single element at the origin of the local coordinate system.

ElementNormal - element normal directions
[0; 0] (by default) | matrix 2 by N | vector-column 2 by 1

Details

The directions of element normals in a conformal antenna array as a 2-by-N matrix or a 2-by-1 column vector.

The variable N indicates the number of elements in the antenna array.

If the ElementNormal value is a matrix, each column specifies the normal direction of the corresponding element in the form [azimuth;elevation] relative to the local coordinate system. The local coordinate system aligns the positive x axis with the normal direction of the conformal antenna array.

If the ElementNormal value is a 2-by-1 column vector, it specifies the same direction for all elements of the antenna array.

The units of measurement are degrees.

The ElementPosition and ElementNormal properties can be used to represent any arrangement in which pairs of elements are distinguished by certain transformations. The transformations can combine translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to normal.

Taper - taper or weighting of elements
1 (by default) | complex scalar | complex row vector 1 by N | complex column vector N by 1

Details

The element conicity or weighting given as a complex scalar, a 1 by N row vector or an N by 1 column vector.

The weights are applied to each element of an antenna array of sensors.

N is the number of elements in the antenna array defined by the size of the ElementPosition property.

If the Taper parameters is a scalar, the same taper value is applied to all elements.

If the Taper value is a vector, then each taper value is applied to the corresponding element.

Methods

Common for all system objects

step!

Starts the system object’s operating algorithm

release!

Allow the system object property value to be changed

reset!

Reset the internal states of the system object

References

  1. Josefsson, L. and P. Persson. "Conformal Array Antenna Theory and Design". Piscataway, NJ: IEEE Press, 2006.

  2. Van Trees, H. "Optimum Array Processing". New York: Wiley-Interscience, 2002.