Engee documentation

EngeePhased.PartitionedArray

Partitioned into sublattices of antenna arrays.

Library

EngeePhased

Description

The EngeePhased.PartitionedArray system object models an antenna array divided into antenna sublattices. To create an antenna array and get the response of its antenna sublattices, follow the steps below:

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

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

You can also specify the EngeePhased.PartitionedArray system object as the value of the SensorArray or Sensor property of system objects that perform beamforming, steering, and other operations.

Syntax

Creation

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

  • object = EngeePhased.PartitionedArray creates an antenna array divided into antenna sublattices, with by default property values. Example:

    array = EngeePhased.PartitionedArray
  • object = EngeePhased.PartitionedArray(Name=Value) creates an antenna array divided into antenna sublattices, 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:

    array = EngeePhased.PartitionedArray()

Using.

  • RESP = object(FREQ,ANG,V) returns the responses to the output argument RESP of the antenna sublattices at the operating frequencies specified in the FREQ argument and the directions specified in the ANG argument. The phase centre of each antenna sublattice is at its geometric centre. V is the propagation velocity. The elements in each antenna sublattice are connected to the phase centre of the antenna sublattice using an equal channel.

  • RESP = object(FREQ,ANG,V,STEERANGLE) uses the value of the STEERANGLE input argument as the control direction of the antenna sublattice. This syntax is available when the SubarraySteering property is set to Phase or Time.

  • RESP = object(FREQ,ANG,V,WS) uses the value of the WS input argument as the weights of the antenna sublattice elements. This syntax is available when the SubarraySteering property is set to Custom.

Properties

Array -. antenna array
EngeePhased.ULA(NumElements,4) (by default) | Phased Array System Toolbox Sensor array

Details

An antenna element defined as any array of a system object belonging to the Phased Array System Toolbox.

SubarraySelection - antenna sublattice matrix
[1 1 0 0 0; 0 0 0 1 1] (by default) | ` real matrix M by N`

Details

Define the antenna sublattice selection as an M by N real matrix. M is the number of antenna sublattices and N is the number of elements in the antenna array. Each row of the matrix corresponds to an antenna sublattice, and each entry in the row indicates whether the element belongs to an antenna sublattice or not.

If the entry is zero, the element does not belong to the antenna sublattice. A non-zero entry represents the complex value of the weighting factor applied to the corresponding element. Each row must contain at least one non-zero entry.

The phase centre of each antenna sublattice is at the geometric centre of the antenna sublattice. The SubarraySelection and Array properties define the geometric centre.

Data types: Float64.

SubarraySteering — antenna sublattice control method
None (by default) | Phase | Time | Custom

Details

Antenna sublattice control method, set as None, Phase, Time or Custom.

If the SubarraySteering property is set to Phase, phase shift is used to control the antenna sublattice. Use the STEERANG argument of the object to define the control direction.

If the SubarraySteering property is set to Time, the antenna sublattice is controlled using time delays. Use the STEERANG argument of the object to determine the direction of control.

If the SubarraySteering property is set to Custom, antenna sublattices are managed by setting independent weighting factors for all elements in each antenna sublattice. Use the WS argument of the object to define the weighting factors for all antenna sublattices.

*Example: Time.

Data types: char | string

PhaseShifterFrequency - antenna sublattice phase shifter frequency
300e6 (by default) | positive scalar

Details

The frequency of the antenna sublattice phase shifter, set as a positive scalar. The phase shifters perform the control of the antenna sublattice.

The units of measurement are Hz.

*Example: 1e9

Dependencies

To enable this property, set the SubarraySteering property to Phase.

Data types: Float64.

NumPhaseShifterBits - number of phase shift quantisation bits
0 (by default) | `non-negative integer `

Details

The number of bits used to quantise the phase shift component of the weighting coefficients of the beamforming vector or control vector is set as a non-negative integer. A zero value means that quantisation is not performed.

Data types: Float64.

Arguments

Input

FREQ - antenna array operating frequency
real vector of a series of length L

Details

The operating frequencies of the antenna array given as a real vector of rows of length L.

Typical values are within the range specified by the H.Array.Element property. This property is called FrequencyRange or FrequencyVector, depending on the type of antenna array element. At frequencies outside this range the element has zero response.

The unit of measurement is Hz.

Data types: Float64.

ANG - azimuth and altitude angles of response directions
` a real vector of strings of length M ` | ` a real matrix 2 on M `

Details

A direction given as a real vector of strings of length M or a real matrix 2 on M.

If ANG is a vector with string length M, each element specifies the azimuth angle of the direction. In this case, the corresponding elevation angle is assumed to be 0.

If ANG is a 2-by-M matrix, 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. The elevation angle is the angle between the direction vector and the xy plane. This angle is positive when measured in the direction of the z axis.

The units of measurement are degrees.

Data types: Float64.

V - signal propagation velocity
`positive scalar

Details

The propagation velocity of a signal given as a positive scalar.

The unit of measurement is m/s.

Data types: Float64.

STEERANG - antenna sublattice rotation angle
real vector 2 by 1

Details

The rotation angle of the antenna sublattice, given as a column vector of length 2. The vector has the form [azimuthAngle;elevationAngle]. The azimuth angle must be in the range -180° to 180° inclusive. The elevation angle must be between -90° and 90° inclusive.

The units of measurement are degrees.

*Example: [20;15]

Dependencies

To enable this argument, set the Sensor property to the value of an antenna array that supports antenna subarrays, and set the SubarraySteering property of that antenna array to Phase or Time.

Data types: Float64.

WS -
complex matrix N_SE on N | array of cells 1 on N

Details

Weight coefficients of antenna sublattice elements given as a complex matrix N_SE by N or an array of cells 1 by N, where N is the number of antenna sublattices.

Antenna arrays can have different dimensions. In this case, the weight coefficients of antenna sublattices can be given in the form:

  • N_SE matrix by N, where N_SE is the number of elements in the largest antenna sublattice. The first Q entries in each column are the weight coefficients of antenna sublattices, where Q is the number of elements in the antenna sublattice;

  • an array of 1 by N cells. Each cell contains a column vector of weight coefficients for the corresponding antenna sublattice. The column vectors have a length equal to the number of elements in the corresponding antenna sublattice.

Dependencies

To enable this argument, set the SubarraySteering property to Custom.

Data types: Float64.

Output

RESP — volt-ampere characteristic of the antenna sublattice
`complex matrix M on L

Details

The voltage response of the antenna sublattice, 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 system object’s operating algorithm

release!

Allow changing the value of a system object property

reset!

Reset internal states of the system object

References

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