Engee documentation

Constant Gamma Clutter

Constant gamma interference.

constant gamma clutter

Description

The Constant Gamma Clutter unit generates constant gamma noise reflected from homogeneous terrain for a monostatic radar transmitting a narrowband signal into free space. The radar is assumed to be at a constant altitude and travelling at a constant speed.

Ports

Output

# Y — noise simulation signal
matrix

Details

Interference simulation returned as a complex matrix to . - number of samples output from the block.

  • If the Output signal format parameter is set to Samples, specify using the Number of samples in output parameter.

  • If the Output signal format parameter is set to Pulses, is the total number of samples in the following pulses where is specified in the Number of pulses in output parameter. - is either the number of antenna sub-cavities in the antenna element, or the the number of radiating or collecting elements, if the antenna element does not contain antenna sub-cavities.

Data types

Float64.

Complex numbers support

Yes

Input

# W — antenna element weights
vector

Details

Input port of antenna element weighting coefficients as a vector of length , where is the number of elements in the antenna array.

Dependencies

To use this port, select the Enable weights input checkbox.

Data types

Float64.

Complex numbers support

Yes

# Steer — antenna array rotation direction
scalar | vector

Details

The direction of rotation of an antenna array, given as a scalar or a real vector 2 by 1. If the direction of rotation is a scalar, it represents the azimuth rotation angle. If the direction of rotation is a scalar, it is of the form [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.

Dependencies

To use this port, set the Specify sensor array parameters to Partitioned array or Replicated Subarray and the Subarray steering method parameters to Phase or Time.

Data types

Float64.

Complex numbers support

No

# WS — weight coefficients of the antenna elements of the sublattice
matrix

Details

Input port of antenna sublattice element weighting coefficients as a matrix to .

  • If the Specify sensor array parameters are set to Replicated Subarray, all sublattices have the same size. Then we can set the weights of the sublattice elements as a complex-valued matrix to , where is the number of elements in each sublattice and is the number of sublattices. Each column WS specifies the weights for the corresponding sublattice.

  • If Partitioned array is selected for the Specify sensor array parameters, the sublattices do not have to have the same size. Sublattice element weights can be specified as a complex-valued matrix to , where is the number of elements in the largest sublattice. The first entries in each column are the element weights for the corresponding sublattice, where K is the number of elements in the sublattice.

Dependencies

To use this port, set the Specify sensor array parameters to Partitioned array or Replicated Subarray and the Subarray steering method parameters to Custom.

Data types

Float64.

Complex numbers support

Yes

Parameters

Clutter

# Terrain gamma value (dB) — disturbance model
Real number

Details

Interference model parameter specified as a scalar. This parameter contains the value , used in the interference model with the constant . The value of depends on both terrain type and operating frequency.

Default value

0

Program usage name

Gamma

Tunable

No

Evaluatable

Yes

# Earth model — earth model
Flat | Curved

Details

Specify the Earth model used in interference modelling as Flat or Curved.

  • If the Earth model parameters are set to Flat, the Earth is assumed to be flat.

  • If the Earth model parameters are set to Curved, the Earth is assumed to be spherical.

Values

Flat | Curved

Default value

Flat

Program usage name

EarthModel

Tunable

No

Evaluatable

No

# Minimum range of clutter region (m) — minimum range of the interference area
Real number

Details

Specify the minimum range for modelling interference as a positive scalar. The minimum range must be non-negative.

Default value

0

Program usage name

ClutterMinRange

Tunable

No

Evaluatable

Yes

# Maximum range of clutter region (m) — maximum range of the interference area
Real number

Details

Specify the maximum range for modelling interference as a positive scalar. The maximum range must be greater than the value specified in the Radar height parameters.

Default value

5000

Program usage name

ClutterMaxRange

Tunable

No

Evaluatable

Yes

# Azimuth center of clutter region (deg) — azimuthal centre of the interference area
Real number

Details

The azimuthal angle in the Earth plane relative to which interference spots are generated. Spots are generated symmetrically with respect to this angle.

Default value

0

Program usage name

ClutterAzimuthCenter

Tunable

No

Evaluatable

Yes

# Azimuth span of clutter region (deg) — azimuthal range of the interference area
Real number

Details

Specify the azimuth range of each interference spot as a positive scalar.

Default value

60

Program usage name

ClutterAzimuthSpan

Tunable

No

Evaluatable

Yes

# Azimuth span of clutter patches (deg) — azimuthal range of interference spots
Real number

Details

The azimuth range of each interference spot, specified as a positive scalar.

Default value

1

Program usage name

PatchAzimuthSpan

Tunable

No

Evaluatable

Yes

# Clutter coherence time (s) — coherence time in interference modelling
Real number

Details

The coherence time for interference modelling, specified as a positive scalar. When the coherence time expires, the block updates the random numbers used for interference modelling on the next pulse. By default `Inf', the random numbers are never updated.

Default value

Inf

Program usage name

CoherenceTime

Tunable

No

Evaluatable

Yes

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

Details

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

By default, the value returned by physconst('LightSpeed') is used for the speed of light.

Default value

299792458

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

Reflected signal

# Sample rate (Hz) — noise sampling frequency
Real number

Details

Interference sampling frequency specified as a positive scalar.

Default value

1e6

Program usage name

SampleRate

Tunable

No

Evaluatable

Yes

# Pulse repetition frequency (Hz) — pulse repetition rate
Real number

Details

The pulse repetition frequency, PRF, is specified as a positive scalar or vector of strings of positive values.

Default value

1e4

Program usage name

PRF

Tunable

No

Evaluatable

Yes

# Output signal format — output format
Pulses | Samples

Details

The output signal format specified as Pulses or Samples.

  • When the Output signal format parameters are set to Samples, the block output will consist of multiple samples. The number of samples is equal to the value of the Number of samples in output parameters.

  • If the Output signal format parameter is set to Pulses, the block output will consist of multiple pulses. The number of pulses is the value of the Number of pulses in output parameters.

Values

Pulses | Samples

Default value

Pulses

Program usage name

OutputFormat

Tunable

No

Evaluatable

No

# Number of pulses in output — number of pulses at the output
Real number

Details

The number of pulses in the block output, specified as a positive integer.

Dependencies

To use this parameter, set the Output signal format parameters to Pulses.

Default value

1

Program usage name

NumPulses

Tunable

No

Evaluatable

Yes

# Number of samples in output — number of samples in the output data
Real number

Details

The number of samples in the block output signal, specified as a positive integer.

Dependencies

To use this parameter, set the Output signal format parameter to Samples.

Default value

100

Program usage name

NumSamples

Tunable

No

Evaluatable

Yes

Main

# Operating frequency (Hz) — operating frequency
Real number

Details

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

Default value

3e8

Program usage name

OperatingFrequency

Tunable

No

Evaluatable

Yes

# Effective transmitted power (W) — effective transmitted power of the radar system
Real number

Details

The effective radiated power (ERP) of a radar system, given as a positive scalar.

Default value

5000

Program usage name

TransmitERP

Tunable

No

Evaluatable

Yes

# Radar height (m) — radar height above the Earth’s surface
Real number

Details

Radar height above the Earth’s surface, set as a non-negative scalar.

Default value

300

Program usage name

PlatformHeight

Tunable

No

Evaluatable

Yes

# Radar speed (m/s) — radar platform speed
Real number

Details

The radar platform motion velocity specified as a non-negative scalar.

Default value

300

Program usage name

PlatformSpeed

Tunable

No

Evaluatable

Yes

# Radar motion direction (deg) — direction of movement of the radar platform
Vector / matrix of real numbers

Details

Specify the direction of motion of the radar platform as a real vector 2 to 1 in the form [AzimuthAngle;ElevationAngle].

Azimuth and elevation angle shall be measured in the local coordinate system of the radar antenna or antenna array. The azimuth angle shall be in the range of -180° to 180°. The elevation angle shall be in the range of -90° to 90°.

By default, the value of this parameter means that the radar platform moves perpendicular to the direction of the wide side of the radar antenna array.

Default value

[90; 0]

Program usage name

PlatformDirection

Tunable

No

Evaluatable

Yes

# Sensor mounting angles (deg) — antenna element mounting angles
Vector / matrix of real numbers

Details

Specify the three-element vector that defines the eigen yaw, pitch, and roll of the antenna element frame with respect to the inertial frame. These three elements define rotations about the z, y, and x axes, respectively, in this order. The first rotation rotates the axes of the body about the z axis. Since these angles define the internal rotations, the second rotation is performed about the y axis at the new position obtained from the previous rotation. The last rotation around the x axis is performed around the x axis rotated by the first two rotations in the internal system.

Default value

[0 0 0]

Program usage name

MountingAngles

Tunable

No

Evaluatable

Yes

# Enable weights input — switching on the input port of the antenna element weighting coefficients
Logical

Details

Select this check box to use the antenna element weighting input port, W.

Default value

false (switched off)

Program usage name

WeightsInputPort

Tunable

No

Evaluatable

No

Геометрия антенны

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

Details

A method for specifying an antenna array.

Available values:

  • Array (no subarrays) - use block parameters to specify antenna array.

  • Partitioned array - use block parameters to specify the antenna array.

  • Replicated subarray - use block parameters to specify antenna array.

  • Single element - create antenna array from one element.

Values

Single element | 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 type
Isotropic Antenna | Cosine Antenna | Custom Antenna

Details

Antenna array type.

Available values:

  • Isotropic Antenna.

  • Cosine Antenna

  • Custom Antenna

Values

Isotropic Antenna | Cosine Antenna | Custom Antenna

Default value

Isotropic Antenna

Program usage name

ElementType

Tunable

No

Evaluatable

No

# Operating frequency vector (Hz) — operating frequency range of user elements of the antenna array
Vector / matrix of real numbers

Details

Specify the frequencies at which you want to set the frequency characteristics of the antenna array as a vector of increasing real values in line 1 on L. The antenna has no response outside the frequency range specified by the minimum and maximum elements of this vector.

Dependencies

To use this parameter, set the Element type parameters to Custom Antenna. Use the Frequency responses (dB) parameters to set the responses at these frequencies.

Default value

[0, 1e20]

Program usage name

FrequencyVector

Tunable

No

Evaluatable

Yes

# Frequency responses (dB) — frequency response of the antenna array
Vector / matrix of real numbers

Details

Frequency response of the user antenna array for the frequencies specified by the Operating frequency vector (Hz) parameters. The dimensionality of the Frequency responses (dB) parameter should correspond to the dimensionality of the vector specified by the Operating frequency vector (Hz) parameter.

Dependencies

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

Default value

[0, 0]

Program usage name

FrequencyResponse

Tunable

No

Evaluatable

Yes

# Input pattern coordinate system — coordinate system of the user’s antenna array radiation pattern
az-el | phi-theta

Details

The coordinate system of the custom antenna array pattern, specified as az-el or phi-theta.

  • If this parameter is set to az-el, the Azimuth angles (deg) and Elevations angles (deg) parameters are used to set the coordinates of the directional pattern points.

  • If this parameter is set to phi-theta, the parameters Phi angles (deg) and Theta angles (deg) are used to set 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) — azimuthal angles of the antenna array radiation pattern
Vector / matrix of real numbers

Details

Specify the azimuth angles at which the radiation pattern of an antenna array should be calculated as a vector-string 1 to P. P must be greater than 2. The azimuthal angles must lie in the range from -180° to 180° inclusive and be arranged in strictly increasing 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 array radiation pattern
Vector / matrix of real numbers

Details

Specify the elevation angles at which the radiation pattern as a vector of 1 to Q must be calculated. Q must be greater than 2. The elevation angles must lie in the range from -90° to 90° inclusive and be in strictly increasing 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) — angular coordinates of the phi-diagram of the directional radiation pattern of a user antenna array
Vector / matrix of real numbers

Details

Phi-angles of the antenna array radiation pattern, set as a real vector of rows 1 to P. P must be greater than 2. Phi-angles must lie in the range from to 360° and be arranged in strictly increasing 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) — angular theta-coordinates of the radiation pattern of the user antenna
Vector / matrix of real numbers

Details

Theta angles of the radiation pattern of the antenna array, given as a real vector of rows 1 to Q. Q must be greater than 2. The Theta angles must lie in the range from to 360° and be arranged in strictly increasing 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 array
String

Details

The magnitude of the radiation pattern of a combined antenna array given as a matrix Q on P or an array Q on P on L.

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

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

The L value is equal to the length of the operating frequency vector (Hz).

  • If this parameter is a matrix of Q over P, the same pattern is applied to all frequencies specified by the Operating frequency vector (Hz) parameter.

  • If this parameter is a Q on L matrix, each page of the Q on P array specifies the directional 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) — custom phase diagram of antenna array directivity
String

Details

The phase radiation pattern of a combined antenna array specified as a matrix Q on P or an array of Q on P on L.

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

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

The L is equal to the length of the operating frequency vector (Hz).

  • If this parameter is a Q by P matrix, the same pattern is applied to all frequencies specified by the Operating frequency vector (Hz) parameter.

  • If the parameter is a Q by P by L array, each page of the Q by P array specifies the directional 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 — rotation of the antenna element to the normal of the antenna array
Logical

Details

Select this checkbox to rotate the antenna element pattern according to the normal of the antenna array.

If the checkbox is not selected, the antenna element pattern is not rotated.

If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters is set to az-el, selecting this check box rotates the pattern so that the x axis of the element coordinate system is along the normal of the array.

If the checkbox is not selected, 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 are set to phi-theta, checking this checkbox rotates the pattern so that the z axis of the element coordinate system is directed along the normal of the 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

# Operating frequency range (Hz) — operating frequency range of the antenna array
Array of real numbers

Details

Specify the operating frequency range of the antenna array as a string vector 1 to 2 in the form [LowerBound,UpperBound]. The element has no response outside this frequency range.

Dependencies

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

Default value

[0 1e20]

Program usage name

OperatingFrequencyRange

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 to zero
Logical

Details

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

When muted, the responses at 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 parameter to Isotropic Antenna.

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 antenna sublattice elements
Real number

Details

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

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray and 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

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 or UCA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLatticeSubarray

Tunable

No

Evaluatable

No

# Array normal — direction of normal of the antenna sublattice URA and UCA
x | y | z

Details

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

The elements of planar sublattices lie in the plane orthogonal to the selected direction of the antenna sublattice normal. The angular coordinate directions 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 vectors of angular coordinates of all elements are directed along the x-axis.

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

  • z - the 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 UCA.

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 [x;y;z] position of an antenna sublattice element in the local coordinate system of the antenna sublattice. The origin of the local coordinate system is (0,0,0,0).

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 N matrix, where N denotes the number of elements in the antenna sublattice. For a matrix, each column specifies the normal direction of the corresponding element in the form [azimuth;elevation] with respect to the local coordinate system. In the local coordinate system, the positive x axis coincides with the direction of the normal to the conformal antenna sublattice. If the parameters value is a column vector 2 by 1, 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 by N, where N is the number of the antenna sublattice elements.

The coefficients that change the 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 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 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 sublattice elements
Real number

Details

The number of antenna sub-lattice elements for the ULA, 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 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 Array (no subarrays) and the Geometry parameter to UCA.

Default value

0.5

Program usage name

RadiusUCA

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 Array (no subarrays) and the Geometry parameter to URA.

Default value

[2 2]

Program usage name

ArraySize

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 Array (no subarrays) 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 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 Array (no subarrays) 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

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 Array (no subarrays) and the Geometry parameter to URA or UCA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLattice

Tunable

No

Evaluatable

No

# Array normal — direction of normal of the antenna sublattice URA and UCA
x | y | z

Details

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

The elements of planar sublattices lie in the plane orthogonal to the selected direction of the antenna sublattice normal. The angular coordinate directions 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 vectors of angular coordinates of all elements are directed along the x-axis.

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

  • z - the 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 Array (no subarrays) and the Geometry parameter to URA or UCA.

Values

x | y | z

Default value

Program usage name

ArrayNormalURA, ArrayNormalUCA

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 [x;y;z] position of an antenna sublattice element in the local coordinate system of the antenna sublattice. The origin of the local coordinate system is (0,0,0,0).

Dependencies

To use this parameter, set the Specify sensor array as parameter to Partitioned array or 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 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 vector-column 2 by 1 or a matrix 2 by N, where N denotes the number of elements in the antenna sublattice. For a matrix, each column specifies the normal direction of the corresponding element in the form [azimuth;elevation] with respect to the local coordinate system. In the local coordinate system, the positive x axis coincides with the direction of the normal to the conformal antenna sublattice. If the parameters value is a column vector 2 by 1, 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 Partitioned array or Array (no subarrays) 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 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 by N, where N is the number of the antenna sublattice elements.

The coefficients that change the 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

Taper

Tunable

No

Evaluatable

Yes

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

Details

Specify an antenna sublattice as a M by N matrix. M is the number of antenna sublattices and N 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 when an element belongs to an antenna sublattice.

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

The phase centre of each antenna sublattice is at the geometric centre of the antenna sublattice. The geometric centre of an antenna sublattice depends on the antenna sublattice definition matrix and the Geometry parameters.

Dependencies

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

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 string vector of the form [NumberOfRows, NumberOfColumns], then the first variable is the number of subgrids in each column. The second variable is the number of sublattices in each row. A row is placed along the local y axis and a column is placed along the local z axis. The figure shows how URA 3 sublattices can be reproduced on 2 when the Grid size parameters are 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, given as a positive real scalar or vector 1 by 2 or Auto.

  • If Grid spacing is a scalar, the row and column spacing is the same.

  • If Grid spacing is a row vector 1 by 2, the vector is [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 complete 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 antenna sub-arrays in the user’s grid, specified as a real matrix 3 by N, where N 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. The coordinates are expressed as [x; y; z].

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 sublattice normals of the antenna array. The value of this parameter is a matrix of size 2 by N, where N is the number of sublattices in the antenna array. Each column of the matrix specifies the normal direction of the corresponding sublattice in the form [azimuth;elevation]. The angles are defined relative to the local coordinate system.

The parameters Subarray positions and Subarray normals 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 | Custom

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 | Custom

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.

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 quantisation bits

Details

BSpecify sensor array sublattice phase shift quantisation bits 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