Engee documentation

Monopulse Estimator

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

blockType: MonopulseEstimator

Path in the library:

/Phased Array Systems/Direction of Arrival/Monopulse Estimator

Description

Block Monopulse Estimator evaluates the direction of arrival of a narrowband signal based on an initial assumption by applying amplitude monopulse signal processing of the total and difference channels received by the antenna array. You can set these channels using the block Monopulse Feed.

Ports

Entrance

# SIGMA — total signal channel
vector

Details

The total signal in the form of a complex column vector on 1, where — 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 in the form of a complex column vector on 1, where — the number of frames in the signal.

Data types

Float64

Support for complex numbers

Yes

# DeltaEl — elevation difference signal channel

+ vector

Details

The difference elevation signal in the form of a complex column vector on 1, where — the number of frames in the signal.

Data types

Float64

Support for complex numbers

Yes

# STEER — channel of the elevation difference signal

+ scalar | vector

Details

The direction of rotation of the antenna array, set as a scalar or a 2-by-1 real vector.

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

  • If the Monopulse coverage parameter is set to 3D, then the rotation direction vector looks like [azimuthAngle; elevationAngle], where azimuthAngle is the azimuth rotation angle, and `elevationAngle' is the elevation rotation angle.

The azimuth angle should be in the range of −180° to 180° inclusive. The elevation angle should be in the range of −90° up to and including 90°. The units of measurement are degrees.

Data types

Float64

Support for complex numbers

None

Output

# Az — estimation of the azimuthal direction of the target
vector

Details

Estimation of the azimuthal direction to the target in the form of a vector with a real value of 1 on . The vector elements contain the calculated azimuth angle of the direction to the target on each frame of the signal. The units of measurement are degrees.

Dependencies

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

Data types

Float64

Support for complex numbers

None

# dAz — estimation of the azimuthal direction shift to the target
vector

Details

Estimation of the azimuthal direction offset to the target in the form of a vector with a real value of 1 by . The vector elements contain the offset of the calculated azimuth angle to the target relative to the azimuth control direction on each frame of the signal. The units of measurement are degrees.

Dependencies

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

Data types

Float64

Support for complex numbers

None

# AzEl — assessment of the direction to the goal
vector

Details

Estimation of the direction to the target in the form of a real matrix 2 on . Each column contains the calculated direction to the target in the form of [azimuthAngle; elevationAngle], where azimuthAngle is the calculated azimuth angle, and elevationAngle is the calculated 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 — estimation of the direction shift to the target
The matrix

Details

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

Dependencies

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

Data types

Float64

Support for complex numbers

None

# AzRatio is the ratio of the total and difference azimuth channels

+ vector

Details

The ratio of the total and difference azimuth channels in the form of a real vector of 1 on . The elements contain the ratio of the sum and the azimuth difference on each frame of the signal.

Dependencies

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

Data types

Float64

Support for complex numbers

None

# AzElRatio is the ratio of the total and difference channels of azimuths and elevations

+ The matrix

Details

The ratio of the total and difference channels of azimuths and elevations in the form of a real matrix 2 on . The elements of the first row contain the ratio of the total and difference azimuth channels on each frame of the signal. 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 parameter to 3D and select the Output sum difference ratio checkbox.

Data types

Float64

Support for complex numbers

None

Parameters

Main

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

Details

The propagation velocity of the signal in the form of a real positive scalar.

The default value is the speed of light.

The units of measurement are m/s.

Default value

299792458

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

# Operating frequency (Hz) — Operating frequency of the system
Real number

Details

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

The units of measurement are 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 irradiator, specified as 3D or Azimuth'. If this parameter is set to `3D, the monopulse irradiator generates a total signal channel and difference azimuth and elevation channels. If this parameter is set to Azimuth, then the monopulse irradiator generates a total signal channel and an azimuth difference channel.

Values

3D | Azimuth

Default value

3D

Program usage name

Coverage

Tunable

No

Evaluatable

No

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

Details

The deflection angle, defined as a scalar or a real vector of 2 by 1. The deflection 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', then the Squint angle parameter can be a scalar or a vector. If the Squint angle parameter is set as a scalar, then the angle of deflection will be the same both in the azimuth direction and in the elevation direction. If the Squint angle parameter is set as a 2-by-1 vector, then its elements determine the angle of deviation in the azimuth and elevation directions.

Default value

10

Program usage name

SquintAngle

Tunable

No

Evaluatable

Yes

# Output format — the format of the output direction
Angle | Angle offset

Details

The format of the output direction is set as Angle or Angle offset'. If the value `Angle is selected for this parameter, the output port is designated AzEl or Az and represents the actual direction to the target. If the value Angle offset is selected for this parameter, the output port is designated 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 — enable the sum-difference ratio output port
Logical

Details

Select this option to display the ratio of the sum and difference of the channels in the azimuth and elevation directions. If the Monopulse coverage parameter is set to Azimuth, the block outputs the ratio of the sum and the azimuth difference via the AzRatio port. If the Monopulse coverage parameter is set to 3D, the block outputs the ratio of the sum and difference of azimuths and elevations via the AzElRatio port.

Default value

false (switched off)

Program usage name

OutSumDiffRatio

Tunable

No

Evaluatable

No

Main

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

Details

The method of setting the 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 — type of antenna array element
Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Details

The 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) — the range of operating frequencies of the antenna or acoustic element
Vector / matrix of real numbers

Details

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

The units of frequency measurement are Hz.

Dependencies

To use this parameter, set the Element type parameter 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 the antenna and acoustic element
Vector / matrix of real numbers

Details

The frequency response of a custom antenna or custom acoustic element for frequencies defined by the Operating frequency vector (Hz) parameter. The dimensions of the Frequency responses (dB) vector must match the dimensions of the vector specified by the Operating frequency vector (Hz) parameter.

Dependencies

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

Default value

[0, 0]

Program usage name

FrequencyResponse

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

To use this parameter, set the Element type parameter 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

Azimuth angles, which will be used to calculate the radiation pattern of the antenna in the form of a vector row 1 on P. P must be greater than 2. The azimuth angles must be in the range of −180° up to 180° inclusive and 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 az-el.

Default value

-180:180

Program usage name

AzimuthAngle

Tunable

No

Evaluatable

Yes

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

Details

Elevation angles at which it is necessary to calculate the radiation pattern in the form of a vector 1 on . it must be more than 2. The units of measurement of angles are degrees. Elevation angles should be in the range of −90° to 90° inclusive and 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 az-el.

Default value

-90:90

Program usage name

ElevationAngle_R

Tunable

No

Evaluatable

Yes

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

Details

The angular coordinates of the Phi points where the antenna radiation pattern is set. They are defined as a real vector-row 1 on . it must be more than 2. The units of measurement of angles are degrees. The values of the Phi angles should be in the range from 0° to 360° and 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) — the values of the angles of the Theta radiation pattern of the antenna
Vector / matrix of real numbers

Details

The angular coordinates of the Theta points where the antenna radiation pattern is set. They are defined as a real vector-row 1 on . it must be more than 2. The units of measurement of angles are degrees. The values of the Theta angles must 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) — the magnitude of the radiation pattern of the combined antenna
String

Details

The value of the radiation pattern of the combined antenna, set as a matrix on or an array on on .

  • If the Input Pattern Coordinate System parameter is set to az-el, then Q is equal to the length of the vector specified by the Elevation angles (deg) parameter, and P is 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 — the length of the vector specified by the Phi Angles (deg) parameter.

Value is equal to the value of the Operating frequency vector (Hz) parameter.

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

  • If the parameter is an array on on , then each page on The array sets the radiation pattern for the corresponding frequency specified in the parameter Operating frequency vector (Hz).

Dependencies

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

Default value

zeros(181,361)

Program usage name

MagnitudePattern

Tunable

No

Evaluatable

Yes

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

Details

The phase radiation pattern of the combined antenna, defined as a matrix on or an array on on .

  • 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 — 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 — the length of the vector specified by the Phi Angles (deg) parameter.

Value is equal to the value of the Operating frequency vector (Hz) parameter.

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

  • If the parameter is an array on on , then each page on The array sets the radiation pattern for the corresponding frequency specified in the parameter Operating frequency vector (Hz).

Dependencies

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

Default value

zeros(181,361)

Program usage name

PhasePattern

Tunable

No

Evaluatable

Yes

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

Details

If the parameter value is enabled, the radiation pattern of the antenna element is rotated to align normally to the antenna array. If it is off, then the radiation pattern of the element does not rotate.

If the antenna is used in an antenna array and the Input Pattern Coordinate System parameter has the value az-el, checking this box rotates the radiation pattern so that the x-axis of the element’s coordinate system points along the normal to the antenna array. If there is no choice, the directional pattern of the element without rotation is used.

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

Use this parameter together with the Array Normal parameter. URA and UCA antenna arrays.

Dependencies

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

Default value

true (switched on)

Program usage name

AlignElementNormal

Tunable

No

Evaluatable

No

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

Details

The response frequencies of an acoustic element with a polar radiation pattern, specified as a real scalar or a real vector, are lines 1 on . The response frequencies are in the frequency range specified by the parameter Operating frequency vector (Hz).

Dependencies

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

Default value

1e3

Program usage name

FrequencyPattern

Tunable

No

Evaluatable

Yes

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

Details

Set the response angles of the polar radiation pattern as a vector of 1 to . The angles are measured from the central axis of the acoustic element and should be in the range of −180° to 180° inclusive.

Dependencies

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

Default value

-180:180

Program usage name

AnglePattern

Tunable

No

Evaluatable

Yes

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

Details

Set the value of the polar radiation pattern of the user acoustic element in the form of a real vector-row 1 on , where — the number of frequencies specified in the parameter Polar pattern frequencies (Hz). The string represents the value of the polar radiation pattern measured at the corresponding frequency specified in the Polar pattern frequencies (Hz). The radiation pattern is measured in the azimuthal plane. In the azimuthal plane, the elevation angle is 0°, and the central axis is 0° in azimuth and 0° in elevation. The polar radiation pattern is symmetrical around the central axis. Based on the polar diagram, it is possible to construct a directional diagram of an acoustic element in three-dimensional space.

Dependencies

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

Default value

zeros(1, 361)

Program usage name

PolarPattern

Tunable

No

Evaluatable

Yes

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

Details

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

The units of frequency measurement are Hz.

Dependencies

To use this parameter, set the Element type parameter 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 radiation pattern solution
Scalar / array of real numbers

Details

The angles of the radiation pattern solution in degrees.

Dependencies

To use this parameter, set the Element type parameter 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 radiation axis
String

Details

The direction of the zero radiation axis.

Dependencies

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

Default value

-x

Program usage name

NullAxisDirection

Tunable

No

Evaluatable

Yes

# Exponent of cosine pattern — setting the azimuthal and altitude cosine radiation patterns indicator
Scalar / array of real numbers

Details

The exponents of the cosine radiation pattern are in the form of a non-negative scalar or a 1 by 2 real matrix of non-negative values.

If the Exponent of cosine pattern is a 1 by 2 vector, then the first element is an indicator in the azimuth direction, and the second is in the elevation direction. With a scalar value of this parameter, the cosines in the azimuthal and elevation directions are raised to one power.

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 option to mute the response of the element.

When the response is suppressed, all azimuth angles exceeding ± 90° from the wide side are set to zero. The wide side is defined as the azimuth angle of 0° and the elevation angle of 0°.

Dependencies

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

Default value

false (switched off)

Program usage name

BaffleBackElement

Tunable

No

Evaluatable

No

Subarray

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

Details

The geometry of the antenna sublattice, defined as:

  • 'ULA' is a uniform linear antenna array.

  • URA is a uniform rectangular antenna array.

  • 'UCA' is a 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 elements of the ULA or UCA antenna sublattice
Real number

Details

The number of elements of the ULA or UCA antenna sublattice, set as an integer greater than or equal to 2.

Dependencies

To use this parameter, set the Geometry parameter 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

The radius of the UCA antenna sublattice, a 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 — dimensions of the URA antenna sublattice
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 size of the antenna sublattice is the vector 1 by 2, then the vector has the form [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 in the leftmost column, and then move to the next columns from left to right. The figure shows an antenna sublattice for which the Array size parameter has the value [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) — the distance between the elements of the ULA or URA antenna sublattice
Scalar / array of real numbers

Details

The distance between adjacent elements of the antenna sublattice in the form of 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 — direction of the ULA linear axis
x | y | z

Details

The direction of the ULA linear axis, set as y, x or z. All elements of the ULA antenna sublattice are evenly 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

A grid of URA element positions, defined as rectangular or triangular.

  • 'Rectangular' — aligns all elements in rows and columns.

  • Triangular — shifts the elements of an even row of a rectangular grid towards the positive direction of the row axis. The offset is half the distance between the elements according to the size of the row.

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 — the direction of the URA or ULA antenna sublattice normal
x | y | z

Details

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

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

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

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

  • The 'z` elements of the antenna sublattice lie in the xy-plane. The angular coordinate vectors 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 the elements of the conformal antenna sublattice
Array of real numbers

Details

The positions of the elements of the conformal antenna sublattice, 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 an element of the antenna sublattice 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 meters.

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) — the direction of the normal vectors of the elements of the conformal antenna sublattice
Array of real numbers

Details

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

Parameters of 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 can include translation, azimuth rotation, and elevation rotation. However, transformations that require rotation relative to the normal direction cannot be used.

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 — changing the radiation pattern of the antenna sublattice elements
Scalar / array of real and/or complex numbers

Details

The change in the radiation pattern of the antenna sublattice elements is set as a complex scalar or a complex vector 1 by , where — the number of elements of the antenna sublattice.

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

If the value of the Taper parameter is a scalar, then the same weight is applied to each element. If Taper is a vector, then a weight from the vector is applied to the corresponding element of the antenna sublattice. The number of scales 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 — geometry of the antenna array
ULA | URA | UCA | Conformal array

Details

The geometry of the antenna array, defined as:

  • 'ULA' is a uniform linear antenna array.

  • URA is a uniform rectangular antenna array.

  • 'UCA` is a uniform circular antenna array.

  • `Conformal Array' — arbitrary arrangement of elements.

Dependencies

To use this parameter, set the Specify sensor array as parameter 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 elements of the ULA or UCA antenna array
Real number

Details

The number of antenna array elements for ULA or UCA, set 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) — the 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 has the value `UCA'.

Default value

0.5

Program usage name

RadiusUCA

Tunable

No

Evaluatable

Yes

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

Details

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

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

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

For URA, the antenna array elements are indexed from top to bottom in the leftmost column, and then move to the next columns from left to right. The figure shows an antenna array for which the Array size parameter has the value [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 has the value `URA'.

Default value

[2 2]

Program usage name

ArraySize

Tunable

No

Evaluatable

Yes

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

Details

The distance between adjacent lattice elements in the form of 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 has the value `ULA or `URA'.

Default value

Program usage name

ElementSpacingULA, ElementSpacingURA

Tunable

No

Evaluatable

Yes

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

Details

The direction of the ULA linear axis, set as y, x or z. All elements of the ULA antenna array are evenly distributed along this axis in the local grid 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 has the value `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 grid of URA element positions, set as rectangular or triangular.

  • 'Rectangular' — aligns all elements in rows and columns.

  • Triangular — shifts the elements of an even row of a rectangular grid towards the positive direction of the row axis. The offset is half the distance between the elements according to the size of the row.

Dependencies

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

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLattice

Tunable

No

Evaluatable

No

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

Details

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

The elements of the flat arrays 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 direction of the antenna array normal.

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

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

  • The 'z` elements of the antenna array lie in the xy plane. The angular coordinate vectors 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 has the value `URA or `ULA'.

Values

x | y | z

Default value

Program usage name

ArrayNormalURA, ArrayNormalUCA

Tunable

No

Evaluatable

No

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

Details

The positions of the elements of the conformal antenna array, given as a matrix of real values 3 on , where — the number of elements in the conformal lattice. Each column of this matrix represents the position [x;y;z] of an element of the antenna array 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) — the direction of the normal vectors of the elements of the conformal antenna array
Array of real numbers

Details

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

Parameters of 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 can include translation, azimuth rotation, and elevation rotation. However, transformations that require rotation relative to the normal direction cannot be used.

Dependencies

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

Default value

[0, 0]

Program usage name

ElementNormals

Tunable

No

Evaluatable

Yes

# Taper — changing the radiation pattern of antenna array elements
Scalar / array of real and/or complex numbers

Details

The change in the radiation pattern of the antenna array elements is set as a complex scalar or a complex vector 1 by , where — the number of antenna array elements.

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

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

Dependencies

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

Default value

1

Program usage name

Taper

Tunable

No

Evaluatable

Yes

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

Details

Set the choice of the antenna sublattice in the form of a matrix on , where — the number of sublattices, and — 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 that the element belongs to this sublattice. If the entry is zero, then the element does not belong to the sublattice. A non-zero entry is a complex weight applied to the corresponding element. Each row must contain at least one non-zero entry.

The phase center of each antenna sublattice is located in the geometric center of the sublattice. The geometric center of the sublattice depends on the Subarray definition matrix and Geometry parameters.

Dependencies

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

Default value

[ 1 1 0 0; 0 0 1 1 ]

Program usage name

SubarraySelection

Tunable

No

Evaluatable

Yes

# Subarrays layout — location of the antenna sublattice
Rectangular | Custom

Details

Specify the location of the replicated antenna sublattices.

  • When setting the value to Rectangular, the Grid size and Grid spacing parameters are used to place the antenna sublattices.

  • When setting the value to Custom, the Subarray positions (m) parameters are used to place the antenna sublattices. and Subarray normals.

Dependencies

To use this parameter, set the Sensor array parameter 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 sublattices
Scalar / array of real numbers

Details

The size of the grid of rectangular antenna sublattices, specified as a single positive integer or vector-a string of positive integers 1 by 2.

  • If Grid size is an integer scalar, then the antenna array has an equal number of sublattices 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 sublattices in each column. The second variable is the number of sublattices in each row. The row is located along the local y axis, and the column is located along the local z axis. The figure shows how to reproduce 3-by-2 URA sublattices when the Grid size parameter has the value [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) — the distance between the antenna sublattices on a rectangular grid
String

Details

The distance between the antenna sublattices in a rectangular grid, set as a positive real scalar or vector 1 by 2 or `Auto'. The units of measurement are meters.

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

If Grid spacing is a row vector 1 by 2, then the vector has the form [SpacingBetweenRows, SpacingBetweenColumn], then the first variable sets the distance between the rows along the column. The second variable is the distance between columns in a row.

If the Grid spacing parameter is set to Auto, then when building a complete antenna array, replication preserves the distance between the elements of the sublattices for both rows and columns. This option is only available if the Geometry parameter is set to ULA or `URA'.

Dependencies

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

Default value

Auto

Program usage name

GridSpacing

Tunable

No

Evaluatable

Yes

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

Details

The positions of the antenna sublattices in the user grid, defined as a real matrix 3 on , where — the number of sublattices 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 meters.

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 sublattice normals
Array of real numbers

Details

The direction of the normals of the sublattices of the antenna array. The value of this parameter is a matrix of size 2 by , where — the number of sublattices in the antenna array. Each column of the matrix defines the direction of the normal of the corresponding sublattice in the form of [azimuth;elevation]. The units of measurement of angles are degrees. The angles are set 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 differ by certain transformations. These transformations can include translation, azimuth rotation, and elevation rotation. However, transformations that require rotation relative 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

The sublattice control method, defined as:

  • None

  • Phase

  • Time

Dependencies

To use this parameter, set the Specify sensor array as parameter 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 units of measurement are Hz.

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

3e8

Program usage name

PhaseShifterFrequency

Tunable

No

Evaluatable

Yes

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

Details

The phase shift quantization bits of the sublattice, specified as a non-negative integer. A value of zero means that quantization 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