Engee documentation

Monopulse Estimator

Estimation of the direction to the target using the sum and difference channels.

monopulse estimator

Description

The Monopulse Estimator block estimates the direction of arrival of a narrowband signal based on an initial assumption by applying amplitude monopulse processing to the total and difference channel signals received by the antenna array. These channels can be set using the block Monopulse Feed.

Ports

Entry

# SIGMA - summary channel
vector

Details

Total signal as a complex column vector by 1, where is the number of frames in the signal.

Data types

Float64.

Support for complex numbers

Yes

# DeltaAz - azimuth difference signal channel
vector

Details

Azimuth difference signal as a complex column vector by 1, where is the number of frames in the signal.

Data types

Float64.

Support for complex numbers

Yes

# DeltaEl - elevation difference channel
vector

Details

Elevation difference signal as a complex column vector by 1, where is the number of frames in the signal.

Data types

Float64.

Support for complex numbers

Yes

# STEER - elevation difference channel
scalar | vector

Details

The direction of rotation of an antenna array, given as a scalar or real vector 2 by 1.

  • If the Monopulse coverage parameters is set to Azimuth, the direction of rotation is a scalar and represents the azimuth rotation angle.

  • If the Monopulse coverage parameters are set to 3D, the rotation direction vector is [azimuthAngle; elevationAngle], where azimuthAngle is the azimuth rotation angle and elevationAngle is the elevation rotation angle.

The azimuth angle shall be in the range of −180° to 180° inclusive. The elevation angle must be in the range from −90° to 90° inclusive. The units of measurement are degrees.

Data types

Float64.

Support for complex numbers

None

Output

# Az - estimate azimuthal direction to the target
vector

Details

Estimation of the azimuth direction to the target as a vector with a real value of 1 at . The elements of the vector contain the estimated azimuth angle of the direction to the target at each frame of the signal. The units of measurement are degrees.

Dependencies

To use this output port, set the Monopulse coverage parameters to Azimuth and the OutputFormat parameters to Angle.

Data types

Float64.

Support for complex numbers

None

# dAz - estimate of the azimuthal direction offset on the target
vector

Details

Estimation of the azimuth direction offset to the target as a vector with a real value of 1 at . The elements of the vector contain the offset of the estimated azimuth direction angle to the target relative to the azimuth control direction at each frame of the signal. The units of measurement are degrees.

Dependencies

To use this output port, set the Monopulse coverage parameters to Azimuth and the OutputFormat parameters to Angle offset.

Data types

Float64.

Support for complex numbers

None

# AzEl - target direction estimation
`vector'

Details

Estimated direction to the target as a real matrix 2 by . Each column contains the estimated direction to the target as [azimuthAngle; elevationAngle], where azimuthAngle is the estimated azimuth angle and elevationAngle is the estimated elevation angle.

The units of measurement are degrees.

Dependencies

To use this output port, set the Monopulse coverage parameter to 3D and the OutputFormat parameter to Angle.

Data types

Float64.

Support for complex numbers

None

# dAzEl - estimating the directional offset on the target
matrix

Details

Estimate the directional offset to the target as a real matrix 2 at . The offset is the difference between the target direction and the control vector. Each column contains the estimated target direction offset in the form of [dazimuthAngle; delevationAngle], where dazimuthAngle is the estimated azimuth angle offset and delevationAngle is the estimated elevation angle offset. The units of measurement are degrees.

Dependencies

To use this output port, set the Monopulse coverage parameters to Azimuth and the OutputFormat parameters to Angle offset.

Data types

Float64.

Support for complex numbers

None

# AzRatio - ratio of total and difference azimuth channels
vector

Details

The ratio of the sum and difference azimuth channels as a real vector of 1 at . The elements contain the ratio of the sum and difference azimuths at each frame of the signal.

Dependencies

To use this output port, set the Monopulse coverage parameters to Azimuth and select the Output sum difference ratio checkbox.

Data types

Float64.

Support for complex numbers

No

# AzElRatio is. ratio of total and difference channels of azimuths and elevations
matrix

Details

The ratio of the total and difference azimuth and elevation channels as a real matrix 2 at . The elements of the first row contain the ratio of the total and difference azimuth and elevation channels at each signal frame. The elements of the second row contain the ratio of the total and difference elevation channels on each frame of the signal.

Dependencies

To use this output port, set the Monopulse coverage parameters to 3D and select the Output sum difference ratio checkbox.

Data types

Float64.

Support for complex numbers

No

Parameters

Main

# Signal propagation speed (m/s) — signal propagation speed
Real number

Details

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

By default, the speed of light is used.

The unit of measurement is m/c.

Default value

299792458

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

# Operating frequency (Hz) — system operating frequency
Real number

Details

The operating frequency of the system, given as a positive scalar.

The unit of measurement is Hz.

Default value

3e8

Program usage name

OperatingFrequency

Tunable

No

Evaluatable

Yes

# Monopulse coverage — monopulse coverage directions
3D | Azimuth

Details

The coverage directions of the monopulse illuminator, set as 3D or Azimuth. If this parameter is set to 3D, the monopulse illuminator generates a sum channel and difference azimuth and elevation channels. If this parameter is set to `Azimuth', the monopulse illuminator generates a sum channel and an azimuth difference channel.

Values

3D | Azimuth

Default value

3D

Program usage name

Coverage

Tunable

No

Evaluatable

No

# Squint angle (degrees) — deflection angle
Scalar / vector / matrix of real numbers

Details

The angle of deviation given as a scalar or real vector 2 by 1. The deviation angle is the angle of separation between the total channel and channels in the azimuth and elevation directions.

  • If the Monopulse coverage parameter is set to Azimuth, then the Squint angle parameter must be a scalar.

  • If the Monopulse coverage parameter is set to 3D, the Squint angle parameter can be a scalar or a vector. If the Squint angle parameters are set as a scalar, the deflection angle will be the same in both the azimuth and elevation directions. If the Squint angle parameters are set as a 2 by 1 vector, its elements define the deflection angle in azimuth and elevation directions.

Default value

10

Program usage name

SquintAngle

Tunable

No

Evaluatable

Yes

# Output format — output direction format
Angle | Angle offset

Details

The output direction format, set as Angle or Angle offset. If Angle is selected for this parameter, the output port is labelled AzEl or Az and represents the actual direction to the target. If Angle offset' is selected for this parameter, the output port is labelled `dAzEl or dAz and represents the angular offset of the target relative to the direction of rotation of the antenna array.

Values

Angle | Angle offset

Default value

Angle

Program usage name

OutFormat

Tunable

No

Evaluatable

No

# Output sum difference ratio — switch on the output port of the sum and difference ratio
Logical

Details

Select this checkbox to output the sum and difference ratio of the channels in the azimuth and elevation directions. If the Monopulse coverage parameters are set to Azimuth, the unit outputs the sum and difference azimuth ratio via the AzRatio port. If the Monopulse coverage parameters are set to 3D, the unit outputs the ratio of the sum and difference of azimuths and elevations through the AzElRatio port.

Default value

false (switched off)

Program usage name

OutSumDiffRatio

Tunable

No

Evaluatable

No

Main

# Specify sensor array as — antenna array design method
Array (no subarrays) | Partitioned array | Replicated subarray

Details

A method for specifying an antenna array.

Available values:

  • Array (no subarrays).

  • Partitioned array

  • Replicated subarray

Values

Array (no subarrays) | Partitioned array | Replicated subarray

Default value

Array (no subarrays)

Program usage name

SpecifySensorArray

Tunable

No

Evaluatable

No

Element

# Element type — antenna array element type
Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Details

Type of antenna or acoustic element.

Available values:

  • Isotropic Antenna.

  • Cardioid Antenna

  • `Cosine Antenna

  • `Custom Antenna

  • `Gaussian Antenna

  • `Sinc Antenna

  • `Omni Microphone

  • `Custom Microphone

Values

Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Default value

Isotropic Antenna

Program usage name

ElementType

Tunable

No

Evaluatable

No

# Operating frequency vector (Hz) — operating frequency range of the antenna or acoustic element
Vector / matrix of real numbers

Details

The operating frequency range of an antenna or acoustic element as a 1 by 2 string vector in the form [LowerBound,UpperBound]. Outside this frequency range, the element has no response.

The unit of frequency measurement is Hz.

Dependencies

To use this parameter, set the Element type parameters to Isotropic Antenna, Cosine Antenna or Omni Microphone.

Default value

[0, 1e20]

Program usage name

FrequencyVector

Tunable

No

Evaluatable

Yes

# Frequency responses (dB) — frequency response of antenna and acoustic element
Vector / matrix of real numbers

Details

Frequency response of the user antenna or user acoustic element for frequencies defined by the Operating frequency vector (Hz) parameters. The size of the Frequency responses (dB) vector must match the size of the vector defined by the Operating frequency vector (Hz) parameters.

Dependencies

To use this parameter, set the Element type parameters to Custom Antenna or Custom Microphone.

Default value

[0, 0]

Program usage name

FrequencyResponse

Tunable

No

Evaluatable

Yes

# Input pattern coordinate system — coordinate system of the directional pattern of the user antenna
az-el | phi-theta

Details

The user antenna pattern coordinate system is specified by az-el or phi-theta. When az-el is specified, the parameters Azimuth angles (deg) and Elevations angles (deg) are used to specify the coordinates of the directional pattern points. When the phi-theta parameter is specified, the Phi angles (deg) and Theta angles (deg) parameters are used to specify the coordinates of the directional pattern points.

Dependencies

To use this parameter, set the Element type parameters to Custom Antenna.

Values

az-el | phi-theta

Default value

az-el

Program usage name

CoordinateSystem

Tunable

No

Evaluatable

No

# Azimuth angles (deg) — Azimuth angles of the antenna radiation pattern
Vector / matrix of real numbers

Details

The azimuth angles from which the antenna radiation pattern will be calculated as a vector-line 1 to P. P must be greater than 2. The azimuth angles must lie in the range from −180° up to and including 180° and be in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to az-el.

Default value

-180:180

Program usage name

AzimuthAngle

Tunable

No

Evaluatable

Yes

# Elevation angles (deg) — antenna radiation pattern elevation angles
Vector / matrix of real numbers

Details

The elevation angles at which the radiation pattern should be calculated as vector 1 at . must be greater than 2. The units of angles are degrees. Elevation angles must lie in the range from −90° to 90° inclusive and be in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to az-el.

Default value

-90:90

Program usage name

ElevationAngle_R

Tunable

No

Evaluatable

Yes

# Phi angles (deg) — values of Phi angles of the antenna pattern
Vector / matrix of real numbers

Details

Angular coordinates Phi of the points at which the antenna radiation pattern is defined. Defined as a real vector-line 1 at . must be greater than 2. The units of measurement of the angles are degrees. The values of the angles Phi must lie in the range from 0° to 360° and be arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to phi-theta.

Default value

0:360

Program usage name

PhiAngles

Tunable

No

Evaluatable

Yes

# Theta angles (deg) — Theta angles of the antenna radiation pattern
Vector / matrix of real numbers

Details

Theta angular coordinates of the points where the antenna radiation pattern is defined. They are set as a real vector-string 1 at . must be greater than 2. The units of measurement of the angles are degrees. Values of the angles Theta must lie in the range from 0° to 180° and be arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna and the Input Pattern Coordinate System parameter to phi-theta.

Default value

0:180

Program usage name

ThetaAngles

Tunable

No

Evaluatable

Yes

# Magnitude pattern (dB) — magnitude of the radiation pattern of the combined antenna
String

Details

The magnitude of the radiation pattern of the combined antenna, given as a matrix to or an array to to .

  • If the Input Pattern Coordinate System parameter is set to az-el, Q is equal to the length of the vector specified by the Elevation angles (deg) parameter, and P is equal to the length of the vector specified by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to phi-theta, then is equal to the length of the vector specified by the Theta Angles (deg) parameter, and is equal to the length of the vector specified by the Phi Angles (deg) parameter.

The value of is equal to the value of the Operating frequency vector (Hz) parameters.

  • If the value of this parameter is a matrix to , the same scheme is applied for all frequencies specified in the Operating frequency vector (Hz) parameter.

  • If the parameter is an array to to , each page to of the array specifies the pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.

Dependencies

To use this parameter, set the Element type parameters to Custom Antenna.

Default value

zeros(181,361)

Program usage name

MagnitudePattern

Tunable

No

Evaluatable

Yes

# Phase pattern (deg) — phase radiation pattern of the user antenna
String

Details

Phase radiation pattern of a compound antenna, specified as a matrix to or an array to to .

  • If the Input Pattern Coordinate System parameter is set to az-el, then is equal to the length of the vector specified by the Elevation angles (deg) parameter, and is equal to the length of the vector specified by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to phi-theta, then is equal to the length of the vector specified by the Theta Angles (deg) parameter, and is equal to the length of the vector specified by the Phi Angles (deg) parameter.

The value of is equal to the value of the Operating frequency vector (Hz) parameters.

  • If the value of this parameter is a matrix to , the same scheme is applied for all frequencies specified in the Operating frequency vector (Hz) parameter.

  • If the parameter is an array to to , each page to of the array specifies the pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.

Dependencies

To use this parameter, set the Element type parameters to Custom Antenna.

Default value

zeros(181,361)

Program usage name

PhasePattern

Tunable

No

Evaluatable

Yes

# Align element normal with array normal — turning the antenna element to the normal position of the antenna array
Logical

Details

If the parameters value is on, the antenna element pattern is rotated to align normal to the antenna array. If off, the element pattern is not rotated.

If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters are set to az-el, selecting this checkbox rotates the pattern so that the x-axis of the element coordinate system points along the normal to the antenna array. If no selection is made, the pattern of the element without rotation is used.

If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters is set to phi-theta, checking this checkbox rotates the pattern so that the z-axis of the element coordinate system points along the normal to the antenna array.

Use this parameter in conjunction with the Array Normal parameters of the URA and UCA antenna arrays.

Dependencies

To use this parameter, set the Element type parameters to Custom Antenna.

Default value

true (switched on)

Program usage name

AlignElementNormal

Tunable

No

Evaluatable

No

# Polar pattern frequencies (Hz) — response frequency of an acoustic element with polar directional pattern
Real number

Details

The response frequencies of a polar pattern acoustic element, specified as a real scalar or a real string vector 1 at . The response frequencies lie within the frequency range specified by the parameter Operating frequency vector (Hz).

Dependencies

To use this parameter, set the Element type parameters to Custom Microphone.

Default value

1e3

Program usage name

FrequencyPattern

Tunable

No

Evaluatable

Yes

# Polar pattern angles (deg) — polar response angles
Vector / matrix of real numbers

Details

Set the polar response angles as vector 1 on . The angles are measured from the centre axis of the acoustic element and should range from −180° up to and including 180°.

Dependencies

To use this parameter, set the Element type parameters to Custom Microphone.

Default value

-180:180

Program usage name

AnglePattern

Tunable

No

Evaluatable

Yes

# Polar pattern (dB) — polar directional pattern of the custom acoustic element
Vector / matrix of real numbers

Details

Set the polar pattern value of the custom acoustic element as a real vector string 1 at , where is the number of frequencies specified in the Polar pattern frequencies (Hz) parameters. The string represents the polar pattern magnitude measured at the corresponding frequency specified in Polar pattern frequencies (Hz). The directional pattern is measured in the azimuth plane. In the azimuth plane, the elevation angle is 0° and the centre axis is 0° in azimuth and 0° in elevation. The polar pattern is symmetrical around the centre axis. Based on the polar diagram, it is possible to construct the directivity diagram of an acoustic element in three-dimensional space.

Dependencies

To use this parameter, set the Element type parameters to Custom Microphone.

Default value

zeros(1, 361)

Program usage name

PolarPattern

Tunable

No

Evaluatable

Yes

# Operating frequency range (Hz) — operating frequency range of the antenna or acoustic element
Array of real numbers

Details

The operating frequency range of an antenna or acoustic element as a 1 by 2 string vector in the form [LowerBound,UpperBound]. Outside this frequency range, the element has no response.

The unit of frequency measurement is Hz.

Dependencies

To use this parameter, set the Element type parameters to Isotropic Antenna, Cosine Antenna or Omni Microphone.

Default value

[0 1e20]

Program usage name

OperatingFrequencyRange

Tunable

No

Evaluatable

Yes

# Radiation pattern beamwidth (deg) — angles of the directional pattern solution
Scalar / array of real numbers

Details

Angles of the directional pattern solution in degrees.

Dependencies

To use this parameter, set the Element type parameters to Gaussian Antenna or Sinc Antenna.

Default value

[10, 10]

Program usage name

RadiationPatternBeamwidth

Tunable

No

Evaluatable

Yes

# Null axis direction — direction of the zero-emission axis
String

Details

The direction of the zero emission axis.

Dependencies

To use this parameter, set the Element type parameters to Cardioid Antenna.

Default value

-x

Program usage name

NullAxisDirection

Tunable

No

Evaluatable

Yes

# Exponent of cosine pattern — Setting the azimuthal and altitude cosine directional diagrams index
Scalar / array of real numbers

Details

Indices of the cosine directional diagram as a non-negative scalar or a real 1 by 2 matrix of non-negative values.

If the Exponent of cosine pattern is a 1 by 2 vector, the first element is the index in the azimuth direction and the second element is the index in the elevation direction. When this parameters is scalar, the cosines in the azimuth and elevation directions are raised to the same degree.

Dependencies

To use this parameter, set the Element type parameter to Cosine Antenna.

Default value

[1.5 1.5]

Program usage name

ExponentCosinePattern

Tunable

No

Evaluatable

Yes

# Baffle the back of the element — set the response of the Isotropic Antenna element or Omni Microphone to zero
Logical

Details

Select this check box to mute the response of the element.

When muting the response, all azimuth angles greater than ±90° from the broadside are set to zero. The broadside is defined as an azimuth angle of 0° and an elevation angle of 0°.

Dependencies

To use this parameter, set the Element type parameters to Isotropic Antenna or Omni Microphone.

Default value

false (switched off)

Program usage name

BaffleBackElement

Tunable

No

Evaluatable

No

Subarray

# Geometry — antenna sublattice geometry
ULA | URA | UCA | Conformal array

Details

The geometry of the antenna sublattice, defined as:

  • ULA is a uniform linear antenna array.

  • URA - uniform rectangular antenna array.

  • UCA - uniform circular antenna array.

  • Conformal Array - arbitrary arrangement of elements.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray.

Values

ULA | URA | UCA | Conformal array

Default value

ULA

Program usage name

GeometrySubarray

Tunable

No

Evaluatable

No

# Number of elements — number of ULA or UCA antenna sublattice elements
Real number

Details

The number of ULA or UCA antenna sub-lattice elements specified as an integer greater than or equal to 2.

Dependencies

To use this parameter, set the Geometry parameters to ULA or UCA.

Default value

Program usage name

NumberElementsULASubarray, NumberElementsUCASubarray

Tunable

No

Evaluatable

Yes

# Radius of UCA (m) — radius of the UCA antenna sublattice
Real number

Details

Radius of the UCA antenna sublattice, positive scalar.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to UCA.

Default value

0.5

Program usage name

RadiusUCASubarray

Tunable

No

Evaluatable

Yes

# Array size — URA antenna sublattice dimensions
Scalar / array of real numbers

Details

The dimensions of the URA antenna sublattice, specified as a positive integer or a vector of positive integers 1 by 2.

  • If the antenna sublattice size is a vector of 1 by 2, the vector is [NumberOfArrayRows, NumberOfArrayColumns].

  • If the size of the antenna sublattice is an integer, then the array has the same number of rows and columns.

For URA, the elements of the antenna sublattice are indexed from top to bottom by the leftmost column and then proceed to the next columns from left to right. The figure shows an antenna sublattice for which the Array size parameters is [3,2], that is, it has three rows and two columns.

mvdr beamformer 1

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to URA.

Default value

[2 2]

Program usage name

ArraySizeSubarray

Tunable

No

Evaluatable

Yes

# Element spacing (m) — distance between elements of the antenna sublattice ULA or URA
Scalar / array of real numbers

Details

The distance between neighbouring elements of the antenna sublattice as a positive scalar.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to ULA or URA.

Default value

Program usage name

ElementSpacingULASubarray, ElementSpacingURASubarray

Tunable

No

Evaluatable

Yes

# Array axis — ULA linear axis direction
x | y | z

Details

The direction of the linear axis of the ULA, given as y, x or z. All elements of the ULA antenna sublattice are uniformly distributed along this axis in the local grid coordinate system.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to ULA.

Values

x | y | z

Default value

y

Program usage name

ArrayAxisSubarray

Tunable

No

Evaluatable

No

# Element lattice — grid of URA element positions
Rectangular | Triangular

Details

Lattice of URA element positions defined as rectangular or triangular.

  • Rectangular - aligns all elements by rows and columns.

  • Triangular - shifts elements of the even row of the rectangular lattice towards the positive direction of the row axis. The offset is half the distance between the elements by the row size.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to URA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLatticeSubarray

Tunable

No

Evaluatable

No

# Array normal — direction of normal of the antenna sublattice URA or ULA
x | y | z

Details

The normal direction of the antenna sublattice, specified as x, y or z.

The elements of planar sublattices lie in a plane orthogonal to the selected direction of the antenna sublattice normal. The directions of angular coordinates of the elements are directed along the normal direction of the antenna sublattice.

  • x - the elements of the antenna sublattice lie in the yz-plane. The angular coordinate vectors of all elements are directed along the x-axis.

  • y - the elements of the antenna sublattice lie in the zx-plane. The angular coordinate vectors of all elements are directed along the y-axis.

  • z - elements of the antenna sublattice lie in the xy-plane. The vectors of angular coordinates of all elements are directed along the z-axis.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to URA or ULA.

Values

x | y | z

Default value

Program usage name

ArrayNormalURASubarray, ArrayNormalUCASubarray

Tunable

No

Evaluatable

No

# Element positions (m) — positions of conformal antenna sublattice elements
Array of real numbers

Details

The positions of the conformal antenna sublattice elements given as a matrix of real values 3 by N, where N is the number of elements in the conformal sublattice. Each column of this matrix represents the position [x;y;z] of the antenna sublattice element in the local coordinate system of the antenna sublattice. The origin of the local coordinate system is (0,0,0). The units of measurement are metres.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to Conformal Array.

Default value

[0, 0, 0]

Program usage name

ElementPositionsSubarray

Tunable

No

Evaluatable

Yes

# Element normals (deg) — direction of normal vectors of elements of the conformal antenna sublattice
Array of real numbers

Details

The direction of the normal vectors of the elements of a conformal antenna sublattice, given as a 2 by 1 column vector or a 2 by matrix, where denotes the number of elements in the antenna sublattice. For a matrix, each column specifies the normal direction of the corresponding element as [azimuth;elevation] with respect to the local coordinate system. In the local coordinate system, the positive axis coincides with the direction of the normal to the conformal antenna sublattice. If the parameter value is a 2-by-1 column vector, the same pointing direction is used for all elements of the antenna sublattice.

The parameters Element positions (m) and Element normals (deg) can be used to represent any arrangement in which pairs of elements differ from each other by certain transformations. These transformations may include translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to the direction of the normal.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and the Geometry parameter to Conformal Array.

Default value

[0, 0]

Program usage name

ElementNormalsSubarray

Tunable

No

Evaluatable

Yes

# Taper — change of the directivity diagram of the antenna sublattice elements
Scalar / array of real and/or complex numbers

Details

The change of the directivity diagram of the antenna sublattice elements is specified as a complex scalar or complex vector 1 at , where is the number of the antenna sublattice elements.

The coefficients that change the directivity pattern, also called element weights, multiply the responses of the antenna sublattice elements. The coefficients change both the amplitude and phase of the response to reduce side lobes or the direction of the main response axis.

If the value of the Taper parameters is a scalar, the same weight is applied to each element. If Taper is a vector, then the weight from the vector is applied to the corresponding element of the antenna sublattice. The number of weights must correspond to the number of antenna array elements.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray.

Default value

1

Program usage name

TaperSubarray

Tunable

No

Evaluatable

Yes

Array

# Geometry — antenna array geometry
ULA | URA | UCA | Conformal array

Details

The geometry of the antenna array, given as:

  • ULA is a uniform linear antenna array.

  • URA - uniform rectangular antenna array.

  • UCA - uniform circular antenna array.

  • Conformal Array - arbitrary arrangement of elements.

Dependencies

To use this parameter, set the Specify sensor array as parameters to Array (no subarrays) or Partitioned array.

Values

ULA | URA | UCA | Conformal array

Default value

ULA

Program usage name

Geometry

Tunable

No

Evaluatable

No

# Number of elements — number of antenna array elements ULA or UCA
Real number

Details

The number of antenna array elements for a ULA or UCA, specified as an integer greater than or equal to 2.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) and the Geometry parameter to ULA or UCA.

Default value

Program usage name

NumberElementsULA, NumberElementsUCA, NumberElementsULAPart

Tunable

No

Evaluatable

Yes

# Radius of UCA (m) — radius of the UCA antenna array
Real number

Details

The radius of the UCA antenna array, a positive scalar.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to UCA.

Default value

0.5

Program usage name

RadiusUCA

Tunable

No

Evaluatable

Yes

# Array size — dimensions of the URA antenna array
Scalar / array of real numbers

Details

The dimensions of the URA antenna array, given as a positive integer or a vector of positive integers 1 by 2.

  • If the antenna array size is a vector of 1 by 2, the vector has the form [NumberOfArrayRows, NumberOfArrayColumns].

  • If the antenna array size is an integer, the array has the same number of rows and columns.

For URA, the elements of the antenna array are indexed from top to bottom by the leftmost column and then proceed to the next columns from left to right. The figure shows an antenna array for which the Array size parameters is [3,2], that is, it has three rows and two columns.

mvdr beamformer 1

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to URA.

Default value

[2 2]

Program usage name

ArraySize

Tunable

No

Evaluatable

Yes

# Element spacing (m) — distance between the elements of the antenna array ULA or URA
Scalar / array of real numbers

Details

The distance between neighbouring array elements as a positive scalar.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to ULA or URA.

Default value

Program usage name

ElementSpacingULA, ElementSpacingURA

Tunable

No

Evaluatable

Yes

# Array axis — ULA linear axis direction
x | y | z

Details

The direction of the linear axis of the ULA, given as y, x or z. All elements of the ULA antenna array are uniformly distributed along this axis in the local array coordinate system.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to ULA.

Values

x | y | z

Default value

y

Program usage name

ArrayAxis

Tunable

No

Evaluatable

No

# Element lattice — grid of URA element positions
Rectangular | Triangular

Details

A lattice of URA element positions specified as rectangular or triangular.

  • Rectangular - aligns all elements by rows and columns.

  • Triangular - shifts elements of the even row of the rectangular lattice towards the positive direction of the row axis. The offset is half the distance between the elements by the row size.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to URA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLattice

Tunable

No

Evaluatable

No

# Array normal — direction of the antenna array normal URA or ULA
x | y | z

Details

The normal direction of the antenna array, specified as x, y or z.

The elements of plane gratings lie in a plane orthogonal to the selected direction of the antenna array normal. The directions of the angular coordinates of the elements are directed along the normal direction of the antenna array.

  • x - the antenna array elements lie in the yz-plane. The angular coordinate vectors of all elements are directed along the x-axis.

  • y - the elements of the antenna array lie in the zx-plane. The vectors of angular coordinates of all elements are directed along the y-axis.

  • z - elements of the antenna array lie in the xy-plane. The vectors of angular coordinates of all elements are directed along the z-axis.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to URA or ULA.

Values

x | y | z

Default value

Program usage name

ArrayNormalURA, ArrayNormalUCA

Tunable

No

Evaluatable

No

# Element positions (m) — positions of conformal antenna array elements
Array of real numbers

Details

Positions of the conformal antenna array elements given as a matrix of real values 3 by , where is the number of elements in the conformal array. Each column of this matrix represents the position [x;y;z] of the antenna array element in the local coordinate system of the antenna array. The origin of the local coordinate system is (0,0,0).

The units of measurement are m.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) and the Geometry parameter to Conformal Array.

Default value

Program usage name

ElementPositions, ElementPositionsPart

Tunable

No

Evaluatable

Yes

# Element normals (deg) — direction of normal vectors of conformal antenna array elements
Array of real numbers

Details

The direction of the normal vectors of the elements of a conformal antenna array, given as a 2 by 1 column vector or a 2 by matrix, where denotes the number of elements in the antenna array. For a matrix, each column specifies the normal direction of the corresponding element as [azimuth;elevation] with respect to the local coordinate system. In the local coordinate system, the positive axis coincides with the direction of the normal to the conformal antenna array. If the parameter value is a 2-by-1 column vector, the same pointing direction is used for all elements of the antenna array.

The parameters Element positions (m) and Element normals (deg) can be used to represent any arrangement in which pairs of elements differ from each other by certain transformations. These transformations may include translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to the direction of the normal.

Dependencies

To use this parameter, set the Specify sensor array as parameter to Array (no subarrays) or Partitioned array and the Geometry parameter to Conformal Array.

Default value

[0, 0]

Program usage name

ElementNormals

Tunable

No

Evaluatable

Yes

# Taper — change of the directivity diagram of the antenna array elements
Scalar / array of real and/or complex numbers

Details

The change of the directivity diagram of the antenna array elements is specified as a complex scalar or complex vector 1 at , where is the number of antenna array elements.

The coefficients that change the directivity pattern, also called element weights, multiply the responses of the antenna array elements. The coefficients change both the amplitude and phase of the response to reduce side lobes or the direction of the main response axis.

If the value of the Taper parameters is a scalar, the same weight is applied to each element. If Taper is a vector, then the weight from the vector is applied to the corresponding antenna array element. The number of weights must correspond to the number of antenna array elements.

Dependencies

To use this parameter, set the Specify sensor array as parameters to Array (no subarrays) or Partitioned array.

Default value

1

Program usage name

Taper

Tunable

No

Evaluatable

Yes

# Subarray definition matrix — Determination of elements belonging to the antenna sublattice
Array of real numbers

Details

Set the antenna sublattice selection as a matrix to , where is the number of sublattices and is the total number of elements in the antenna array. Each row of the matrix represents an antenna sublattice, and each entry in the row indicates whether the element belongs to that sublattice. If the entry is zero, the element does not belong to the sublattice. A non-zero entry represents the complex weight 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 sublattice. The geometric centre of the sublattice depends on the parameters Subarray definition matrix and Geometry.

Dependencies

To use this parameter, set the Specify sensor array as parameters to Partitioned array.

Default value

[ 1 1 0 0; 0 0 1 1 ]

Program usage name

SubarraySelection

Tunable

No

Evaluatable

Yes

# Subarrays layout — antenna sub array arrangement
Rectangular | Custom

Details

Specify the location of the replicated antenna sublattice.

  • When Rectangular is set, the Grid size and Grid spacing parameters are used to position the antenna sub-arrays.

  • When `Custom' is set, the Subarray positions (m) and Subarray normals parameters are used to position the antenna arrays.

Dependencies

To use this parameter, set the Sensor array parameters to Replicated subarray.

Values

Rectangular | Custom

Default value

Rectangular

Program usage name

SubarraysLayout

Tunable

No

Evaluatable

No

# Grid size — dimensions of the rectangular grid of antenna sub-grids
Scalar / array of real numbers

Details

Rectangular antenna sub-grid mesh size, specified as a single positive integer or a vector-string of positive integers 1 by 2.

  • If Grid size is an integer scalar, the antenna array has an equal number of sub-grids in each row and each column.

  • If Grid size is a 1-by-2 row vector of the form [NumberOfRows, NumberOfColumns], then the first variable is the number of sub-grids in each column. The second variable is the number of sublattices in each row. A row is along the local y-axis and a column is along the local z-axis. The figure shows how URA 3 by 2 subgrids can be reproduced when the Grid size parameter is set to [1,2].

mvdr beamformer 2

Dependencies

To use this parameter, set the Sensor array parameter to Replicated subarray and the Subarrays layout parameter to Rectangular.

Default value

[1 2]

Program usage name

GridSize

Tunable

No

Evaluatable

Yes

# Grid spacing (m) — distance between antenna sublattices on a rectangular grid
String

Details

The distance between antenna sublattices on a rectangular grid, specified as a positive real scalar or vector 1 by 2 or Auto. The unit of measure is metres.

If Grid spacing is a scalar, the distance between rows and columns is the same.

If Grid spacing is a 1 by 2 row vector, the vector is of the form [SpacingBetweenRows, SpacingBetweenColumn], the first variable specifies the row spacing along the column. The second variable is the spacing between columns along the row.

If the Grid spacing parameters are set to Auto, replication preserves the spacing between subgrid elements for both rows and columns when building a full antenna array. This option is available only if ULA or URA is selected for the Geometry parameters.

Dependencies

To use this option, set the Sensor array parameters to Replicated subarray and the Subarrays layout parameters to Rectangular.

Default value

Auto

Program usage name

GridSpacing

Tunable

No

Evaluatable

Yes

# Subarray positions (m) — antenna array positions
Array of real numbers

Details

The positions of the antenna sub-arrays in the user grid defined as a real matrix 3 by , where is the number of sub-arrays in the antenna array. Each column of the matrix represents the position of one sublattice in the local coordinate system of the antenna array. Coordinates are expressed as [x; y; z]. The units of measurement are metres.

Dependencies

To use this parameter, set the Sensor array parameter to Replicated subarray and the Subarrays layout parameter to Custom.

Default value

[0 0;-0.5 0.5;0 0]

Program usage name

SubarrayPositions

Tunable

No

Evaluatable

Yes

# Subarray normals (deg) — direction of antenna sub-grids normals
Array of real numbers

Details

The direction of the normal of the antenna array sublattice normals. The value of this parameters is a matrix of size 2 by , where is the number of sublattices in the antenna array. Each column of the matrix specifies the direction of the normal of the corresponding sublattice in the form [azimuth;elevation]. The units of angles are degrees. The angles are defined relative to the local coordinate system.

The Subarray positions and Subarray normals parameters can be used to represent any arrangement in which pairs of antenna sublattices are distinguished by certain transformations. These transformations may include translation, azimuth rotation, and elevation rotation. However, transformations that require rotation with respect to the normal cannot be used.

Dependencies

To use this parameter, set the Sensor array parameter to Replicated subarray and the Subarrays layout parameter to Custom.

Default value

[0 0;0 0]

Program usage name

SubarrayNormals

Tunable

No

Evaluatable

Yes

# Subarray steering method — sublattice control method
None | Phase | Time

Details

A sublattice control method defined as:

  • None.

  • Phase

  • Time

Dependencies

To use this parameter, set the Specify sensor array as parameters to Partitioned Array or Replicated subarray.

Values

None | Phase | Time

Default value

None

Program usage name

SubarraySteeringMethod

Tunable

No

Evaluatable

No

# Phase shifter frequency (Hz) — sublattice phase shift frequency
Real number

Details

The operating frequency of the sublattice phase shift, specified as a positive real scalar. The unit of measurement is Hz.

Dependencies

To use this parameter, set the Sensor array parameters to Partitioned array or Replicated subarray and set the Subarray steering method parameters to Phase.

Default value

3e8

Program usage name

PhaseShifterFrequency

Tunable

No

Evaluatable

Yes

# Number of bits in phase shifters — number of phase shift quantisation bits
Real number

Details

phase shift quantisation bits of the sublattice specified as a non-negative integer. A value equal to zero means that quantisation is not performed.

Dependencies

To use this parameter, set the Sensor array parameter to Partitioned array or Replicated subarray and set the Subarray steering method parameter to Phase.

Default value

0

Program usage name

NumberBitsPhaseShifters

Tunable

No

Evaluatable

Yes