Engee documentation

Constant Gamma Clutter

Constant gamma interference.

blockType: ConstantGammaClutter

Path in the library:

/Radar/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) — interference model
Real number

Details

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

Default value

0

Program usage name

Gamma

Tunable

No

Evaluatable

Yes

# Earth model — The Earth model
Flat | Curved

Details

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

  • If the Earth model parameter is set to Flat, The earth is taken as a plane.

  • If the Earth model parameter is set to Curved The earth is considered 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 interference simulation in the form of 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 interference range
Real number

Details

Specify the maximum range for interference simulation in the form of a positive scalar. The maximum range must be greater than the value specified in the Radar height parameter.

Default value

5000

Program usage name

ClutterMaxRange

Tunable

No

Evaluatable

Yes

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

Details

The azimuthal angle in the Earth’s plane relative to which the interference spots are generated. The spots are generated symmetrically relative to this angle.

Default value

0

Program usage name

ClutterAzimuthCenter

Tunable

No

Evaluatable

Yes

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

Details

Specify the azimuthal 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) — azimuth range of interference spots
Real number

Details

The azimuthal range of each interference spot, given as a positive scalar.

Default value

1

Program usage name

PatchAzimuthSpan

Tunable

No

Evaluatable

Yes

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

Details

The coherence time for interference simulation, given as a positive scalar. After the coherence time has elapsed, the unit updates the random numbers used to simulate interference at the next pulse. When using the default value 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 the signal, given as a real positive scalar.

By default, the speed of light is set to the value returned by the physconst('LightSpeed') function.

Default value

299792458

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

Reflected signal

# Sample rate (Hz) — interference sampling rate
Real number

Details

The interference sampling rate, set 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 rate, PRF, is set as a positive scalar or a vector of strings of positive values.

Default value

1e4

Program usage name

PRF

Tunable

No

Evaluatable

Yes

# Output signal format — output signal format
Pulses | Samples

Details

The output signal format, set as Pulses or Samples.

  • If the Output signal format parameter is set to Samples the output of the block will consist of several samples. The number of samples is equal to the value of the Number of samples in output parameter.

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

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 output of the unit, set as a positive integer.

Dependencies

To use this parameter, set the Output signal format parameter 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 output signal of the block, set 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, set 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 the radar system, given as a positive scalar.

Default value

5000

Program usage name

TransmitERP

Tunable

No

Evaluatable

Yes

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

Details

The height of the radar above the Earth’s surface is set as a non-negative scalar.

Default value

300

Program usage name

PlatformHeight

Tunable

No

Evaluatable

Yes

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

Details

The speed of movement of the radar platform, set as a non-negative scalar.

Default value

300

Program usage name

PlatformSpeed

Tunable

No

Evaluatable

Yes

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

Details

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

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

The default 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) — installation angles of antenna elements
Vector / matrix of real numbers

Details

Specify a three-element vector that defines the proper yaw, pitch, and roll of the antenna element frame relative to the inertial frame. These three elements define rotation around the axes z, y, and x, respectively, in that order. The first rotation rotates the body’s axes around the z axis. Since these angles determine the internal rotations, the second rotation is performed around the y axis in a new position resulting 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 — enabling the input port of the antenna element weights
Logical

Details

Select this option to use the input port of the antenna element weights, W.

Default value

false (switched off)

Program usage name

WeightsInputPort

Tunable

No

Evaluatable

No

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

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

Details

The method of setting the antenna array.

Available values:

  • Array (no subarrays) – The parameters of the block are used to set the antenna array.

  • Partitioned array – use the block parameters to set the antenna array.

  • Replicated subarray – use the block parameters to set the antenna array.

  • Single element – creation of an antenna array from a single 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 — type of antenna array
Isotropic Antenna | Cosine Antenna | Custom Antenna

Details

The type of antenna array.

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 custom antenna array elements
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 to 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 parameter to Custom Antenna. Use the Frequency responses (dB) parameter 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

The frequency response of the user antenna array for the frequencies specified by the parameter Operating frequency vector (Hz). The dimension of the Frequency responses (dB) parameter must correspond to the dimension 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 — the coordinate system of the custom antenna array radiation pattern
az-el | phi-theta

Details

The coordinate system of the user directional pattern of the antenna array, set as az-el or phi-theta.

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

  • If you set the value for this parameter phi-theta, the Phi angles (deg) and Theta angles (deg) parameters are used to set the coordinates of the directional pattern points.

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) — azimuthal angles of the radiation pattern of the antenna array
Vector / matrix of real numbers

Details

Specify the azimuthal angles at which it is necessary to calculate the radiation pattern of the antenna array, in the form of a vector row 1 on P. P must be greater than 2. The azimuthal angles should be in the range from -180° to 180° inclusive and arranged in strictly ascending order.

Dependencies

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

Default value

-180:180

Program usage name

AzimuthAngle

Tunable

No

Evaluatable

Yes

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

Details

Specify the angles of the location at which it is necessary to calculate the radiation pattern in the form of a vector 1 by Q. Q must be greater than 2. The angles of the seat must range from -90° to 90° inclusive and be arranged in strictly ascending order.

Dependencies

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

Default value

-90:90

Program usage name

ElevationAngle_R

Tunable

No

Evaluatable

Yes

# Phi angles (deg) — angular coordinates of the phi radiation pattern of the user antenna array
Vector / matrix of real numbers

Details

Phi are the angles of the radiation pattern of the antenna array, set as a real vector of lines 1 on P. P must be greater than 2. The Phi angles must range from to 360° and be arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna, and for the parameter Input Pattern Coordinate System the value 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 are the angles of the radiation pattern of the antenna array, set as a real vector of lines 1 by Q. Q must be greater than 2. The Theta angles should range from to 360° and be arranged in strictly ascending order.

Dependencies

To use this parameter, set the Element type parameter to Custom Antenna, and for the parameter Input Pattern Coordinate System the value 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 array
String

Details

The value of the radiation pattern of the combined antenna array, set as a matrix Q on P or a lattice 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 specified by the Elevation angles (deg) parameter, and P is equal to the length of the vector specified by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to phi-theta, 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 value of L is equal to the length of the operating frequency vector (Hz).

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

  • If this parameter is a matrix Q on L, each page of the array Q on P sets a 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

No

# Phase pattern (deg) — custom antenna array phase pattern
String

Details

The phase radiation pattern of a combined antenna array, defined as a matrix of Q by P or an array of Q by P by L.

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

  • If the Input Pattern Coordinate System parameter is set to phi-theta, 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 value L is equal to the length of the operating frequency vector (Hz).

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

  • If the parameter is an array of Q on P on L, then each page of the array of Q on P 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

No

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

Details

Select this option to rotate the radiation pattern of the antenna array elements according to the grid normal.

If the flag is not checked, the antenna element’s radiation pattern does not rotate.

If the antenna is used in an antenna array and the parameter Input Pattern Coordinate System is set to az-el If this flag is selected, the radiation pattern rotates so that the x axis of the coordinate system of the element is directed along the normal of the grid.

If the checkbox is not checked, the element’s layout is used without rotation.

If the antenna is used in an antenna array and the parameter Input Pattern Coordinate System is set to phi-theta, then when this checkbox is selected, the radiation pattern rotates so that the axis z of the coordinate system of the element is directed along the normal of the grid.

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

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

Details

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

Dependencies

To use this parameter, set the Element type parameter 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 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 direction of the azimuth, and the second is in the direction of the location. 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 a response Isotropic Antenna element equal to zero
Logical

Details

Select this option to mute the response of the element.

During jamming, the responses at 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.

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 — 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 elements of the antenna sublattice for ULA, set 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 for the Geometry parameter , the value ULA or UCA.

Default value

2

Program usage names

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 for the Geometry parameter , the value 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 for the Geometry parameter , the value 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 for the Geometry parameter , the value ULA or URA.

Default value

0.5

Program usage names

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, defined 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 for the Geometry parameter , the value 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 into 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 for the Geometry parameter , the value URA or UCA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLatticeSubarray

Tunable

No

Evaluatable

No

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

Details

The normal direction of the antenna sublattice, given 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.

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

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

  • z — the 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 for the Geometry parameter , the value URA or UCA.

Values

x | y | z

Default value

x

Program usage names

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, defined as a matrix of real values 3 on N, where N is the number of elements in the conformal sublattice. Each column of this matrix represents a position [x;y;z] the element of the antenna sublattice in the local coordinate system of the antenna sublattice. The origin of the local coordinate system — (0,0,0).

Dependencies

To use this parameter, set the Specify sensor array as parameter to Replicated subarray, and for the Geometry parameter , the value 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, specified as a column vector 2 by 1 or matrix 2 by N, where N means the number of elements in the antenna sublattice. For the matrix, each column sets the direction of the normal of the corresponding element in the form [azimuth;elevation] relative to the local coordinate system. In the local coordinate system, the positive axis x coincides with the direction of the normal to the conformal antenna sublattice. If the parameter value is a column vector 2 by 1, 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 for the Geometry parameter , the value 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 complex vector 1 by N, where N is the number of antenna sublattice elements.

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 sublattice
ULA | URA | UCA | Conformal array

Details

The geometry of the antenna sublattice, defined as:

  • ULA — 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 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 elements of the antenna sublattice for ULA, 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 for the Geometry parameter , the value ULA or UCA.

Default value

2

Program usage names

NumberElementsULA, NumberElementsUCA, NumberElementsULAPart

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 Array (no subarrays), and for the Geometry parameter , the value UCA.

Default value

0.5

Program usage name

RadiusUCA

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 Array (no subarrays), and for the Geometry parameter , 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 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 Array (no subarrays), and for the Geometry parameter , the value ULA or URA.

Default value

0.5

Program usage names

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, defined 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 Array (no subarrays), and for the Geometry parameter , 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, defined as rectangular or triangular.

  • Rectangular — aligns all elements into 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), and for the Geometry parameter , the value URA or UCA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLattice

Tunable

No

Evaluatable

No

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

Details

The normal direction of the antenna sublattice, given 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.

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

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

  • z — the 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 Array (no subarrays), for the Geometry parameter, the value is URA or UCA.

Values

x | y | z

Default value

x

Program usage names

ArrayNormalURA, ArrayNormalUCA

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, defined as a matrix of real values 3 on N, where N is the number of elements in the conformal sublattice. Each column of this matrix represents a position [x;y;z] the element of the antenna sublattice in the local coordinate system of the antenna sublattice. The origin of the local coordinate system — (0,0,0).

Dependencies

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

Default value

[0, 0, 0]

Program usage names

ElementPositions, ElementPositionsPart

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 column vector 2 by 1 or matrix 2 by N, where N means the number of elements in the antenna sublattice. For the matrix, each column sets the direction of the normal of the corresponding element in the form [azimuth;elevation] relative to the local coordinate system. In the local coordinate system, the positive axis x coincides with the direction of the normal to the conformal antenna sublattice. If the parameter value is a column vector 2 by 1, 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 Partitioned array or Array (no subarrays), and for the Geometry parameter , the value Conformal Array.

Default value

[0, 0]

Program usage name

ElementNormals

Tunable

No

Evaluatable

Yes

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

Details

Complex weighting coefficients for antenna array elements, given as a complex scalar, a complex string vector on or a complex column vector on , where It represents the number of antenna array elements. Weighting factors are applied to each antenna element of the antenna array and change the amplitude and phase of the received data.

  • If Taper is a scalar, the same coefficient value is applied to all elements of the antenna array.

  • If Taper is a vector, its own coefficient value is applied to each element of the antenna array.

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 the antenna sublattice as a matrix of M by N. 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 the antenna sublattice.

If the record is zero, then the element does not belong to the antenna sublattice. A non-zero entry is a complex weighting factor 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 antenna sublattice. The geometric center of the antenna sublattice depends on the antenna sublattice definition matrix and the Geometry parameter.

Dependencies

To use this parameter, set the Specify sensor array as parameter 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 — location of the antenna sublattice
Rectangular | Custom

Details

Specify the location of the replicated antenna sublattices.

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

  • When setting the value 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 vector string 1 to 2 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 the sublattices from 3 to 2 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 for the Subarrays layout parameter, the value 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, specified as a positive real scalar or vector 1 by 2 or Auto.

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

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

If the Grid spacing parameter is set to Auto When constructing 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 for the Subarrays layout parameter, the value Rectangular.

Default value

Auto

Program usage name

GridSpacing

Tunable

No

Evaluatable

No

# 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 by N, where N is 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. The coordinates are expressed as [x; y; z].

Dependencies

To use this parameter, set the Sensor array parameter to Replicated subarray and for the Subarrays layout parameter, the value 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 N, where N is 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 [azimuth;elevation]. 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 for the Subarrays layout parameter, the value 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

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 | 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 quantization bits
Real number

Details

Verify sensor array 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