Engee documentation

ADPCA Canceller

Adaptive pulse suppression device of an antenna array with an offset phase center (ADPCA) for a homogeneous linear antenna array.

blockType: ADPCACanceller

Path in the library:

/Phased Array Systems/SpaceTimeAdaptiveProcessing/ADPCA Canceller

Description

Block ADPCA Canceller filters out interference falling on a homogeneous linear antenna array using an adaptive pulse suppressor with an offset phase center.

Ports

Input

# X — The input signal
complex array M by N by P

Details

The input signal, specified as a complex array on on , where – number of range counts, – the number of channels, and – the number of pulses.

Data types

Float64

Complex numbers support

Yes

# Idx — index of the range cells
a positive integer

Details

The index of the range cells for calculating the processing weights.

Data types

Float64

Complex numbers support

No

# Dop — frequency of Doppler positioning
scalar

Details

The Doppler positioning frequency of the current pulse, set as a scalar.

Dependencies

To use this port, check the box for the parameter Output pre-Doppler result and for the parameter Specify targeting Doppler as meaning Input port.

Data types

Float64

Complex numbers support

No

# Ang — directions of arrival of signals
a 2-by-1 real vector

Details

The direction of arrival of the signals, set as a real vector 2 by 1. The vector has the form [AzimuthAngle;ElevationAngle]. The azimuth angle should be in the range from -180° to 180° inclusive, and the elevation angle should be in the range from -90° to 90° inclusive. The angles are determined relative to the local coordinate system of the array.

The angle measurement units are degrees.

Dependencies

To use this port, set the parameter Specify direction as meaning Input port.

Data types

Float64

Complex numbers support

No

# PRF — pulse repetition rate
positive scalar

Details

The pulse repetition rate, set as a positive scalar.

Dependencies

To use this port, set the parameter Specify PRF as meaning Input port.

Data types

Float64

Complex numbers support

No

Output

# Y — beam shaper output signal
complex vector M by 1

Details

The output signal of the beamformer, specified as a complex vector on , where – the number of range samples on the input port X.

Data types

Float64

Complex numbers support

Yes

# W — weight factors
complex matrix N on P

Details

Weight coefficients given as a complex matrix on , where – this is the number of channels, and – the number of pulses.

Dependencies

To use this port, check the box for the parameter Enable weights output.

Data types

Float64

Complex numbers support

No

Parameters

Main

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

Details

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

Default value

299792458

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

# Operating frequency (Hz) — operating frequency of the system, Hz
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

# Specify PRF as — The source of the pulse repetition rate value
Property | Input port

Details

The source of the pulse repetition rate (PRF) value:

  • Property — parameter Pulse repetition frequency (Hz) sets the numeric value of the PRF value.

  • Input port — The numerical value of the PRF value is received through the input port PRF.

Values

Property | Input port

Default value

Property

Program usage name

PRF_Type

Tunable

No

Evaluatable

No

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

Details

Pulse repetition rate (PRF), set as a positive scalar.

Set this parameter to the same value that is set in any library block used in modeling. Waveforms.

Dependencies

To enable this parameter, set for the parameter Specify PRF as meaning Property.

Default value

1

Program usage name

PRF

Tunable

No

Evaluatable

Yes

# Specify direction as — the source of the positioning direction values
Property | Input port

Details

The source of the positioning direction values:

  • Property — parameter Receiving mainlobe direction (deg) sets the positioning direction.

  • Input port — The positioning directions are sent to the input port Ang.

Values

Property | Input port

Default value

Property

Program usage name

Dir_Type

Tunable

No

Evaluatable

No

# Receiving mainlobe direction (deg) — pointing direction of the antenna array pattern
Array of real numbers

Details

Specify the direction of the radiation pattern of the antenna array of the antenna element in the form of a real vector 2 by 1. The direction is set in the format [AzimuthAngle; ElevationAngle]. The azimuth angle should be in the range from -180° to 180°, and the elevation angle should be from -90° to `90°'.

Dependencies

To enable this parameter, set for the parameter Specify direction as meaning Property.

Default value

[0; 0]

Program usage name

Direction

Tunable

No

Evaluatable

Yes

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

Details

The number of bits used to quantize the phase shift component of the beamformer or control vector weights. Specify the number of bits as a non-negative integer. A value of zero means that quantization is not performed.

Default value

0

Program usage name

NumPhaseShifterBits

Tunable

No

Evaluatable

Yes

# Specify targeting Doppler as — source of Doppler guidance on target
Property | Input port

Details

Source of Doppler guidance on target:

  • Property — parameter Targeting Doppler (Hz) sets the Doppler positioning values.

  • `Input port' — Doppler positioning values are sent to the input port Dop.

Values

Property | Input port

Default value

Property

Program usage name

Dop_Type

Tunable

No

Evaluatable

No

# Targeting Doppler (Hz) — Doppler positioning of the STAP processor
Real number

Details

The Doppler positioning of the STAP processor, set as a scalar.

Dependencies

To use this option, uncheck the option. Output pre-Doppler result and set for the parameter Specify targeting Doppler as meaning Property.

Default value

0

Program usage name

Doppler

Tunable

No

Evaluatable

Yes

# Number of guard cells — number of safety cells used for training
Int64 integer

Details

The number of safety cells used for training is set as a positive even integer. If possible, the set of protective cells is divided equally into areas before and after the test cell.

Default value

2

Program usage name

NumGuardCells

Tunable

No

Evaluatable

Yes

# Number of training cells — number of cells used for training
Int64 integer

Details

The number of cells used for training is set as a positive even integer. If possible, the set of training cells is divided equally into areas before and after the test cell.

Default value

2

Program usage name

NumTrainingCells

Tunable

No

Evaluatable

Yes

# Enable weights output — enabling the output of the beam shaper weights
Logical

Details

Check this box to get the beam shaper weights via the output port W.

Default value

false (switched off)

Program usage name

WeightOutputPort

Tunable

No

Evaluatable

No

# Output pre-Doppler result — enabling output of results before Doppler filtering
Logical

Details

Select this option to display the results before Doppler filtering.

Uncheck this box to display the result of processing after Doppler filtering.

Default value

false (switched off)

Program usage name

PreDopplerOutputPort

Tunable

No

Evaluatable

No

Main

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

Details

The method of setting the antenna array, specified as Array (no subarrays).

Values

Array (no subarrays)

Default value

Array (no subarrays)

Program usage name

SpecifySensorArray

Tunable

No

Evaluatable

No

Element

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

Details

The type of antenna or acoustic element.

Available values:

  • Isotropic Antenna

  • Cardioid Antenna

  • Cosine Antenna

  • Custom Antenna

  • Gaussian Antenna

  • Sinc Antenna

  • Omni Microphone

  • Custom Microphone

Values

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

Default value

Isotropic Antenna

Program usage name

ElementType

Tunable

No

Evaluatable

No

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

Details

The range of operating frequencies of the antenna or acoustic element in the form of a vector row 1 on . Outside of this frequency range, the element has no response.

The units of frequency measurement are Hz.

Dependencies

To use this parameter, set for the parameter Element type meaning Custom Antenna or Custom Microphone. Use the parameter Frequency responses (dB) to adjust 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 and acoustic element
Vector / matrix of real numbers

Details

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

Dependencies

To use this parameter, set for the parameter Element type meaning Custom Antenna or Custom Microphone.

Default value

[0, 0]

Program usage name

FrequencyResponse

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

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

Values

az-el | phi-theta

Default value

az-el

Program usage name

CoordinateSystem

Tunable

No

Evaluatable

No

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

Details

Azimuth angles, which will be used to calculate the radiation pattern of the antenna in the form of a vector row 1 on P. P must be greater than 2. The azimuth angles must be in the range of −180° up to 180° inclusive and arranged in strictly ascending order.

Dependencies

To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate systemaz-el.

Default value

-180:180

Program usage name

AzimuthAngle

Tunable

No

Evaluatable

Yes

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

Details

Elevation angles at which it is necessary to calculate the radiation pattern in the form of a vector 1 on . it must be more than 2. The units of measurement of angles are degrees. Elevation angles should be in the range of −90° to 90° inclusive and arranged in strictly ascending order.

Dependencies

To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate systemaz-el.

Default value

-90:90

Program usage name

ElevationAngle_R

Tunable

No

Evaluatable

Yes

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

Details

The angular coordinates of the Phi points where the antenna radiation pattern is set. They are defined as a real vector-row 1 on . it must be more than 2. The units of measurement of angles are degrees. The values of the Phi angles should be in the range from 0° to 360° and arranged in strictly ascending order.

Dependencies

To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate systemphi-theta.

Default value

0:360

Program usage name

PhiAngles

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate systemphi-theta.

Default value

0:180

Program usage name

ThetaAngles

Tunable

No

Evaluatable

Yes

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

Details

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

  • If for the parameter Input pattern coordinate system the value is set az-el Then is equal to the length of the vector specified by the parameter Elevation angles (deg), and — the length of the vector specified by the parameter Azimuth angles (deg).

  • If for the parameter Input pattern coordinate system the value is set phi-theta Then is equal to the length of the vector specified by the parameter Theta angles (deg), and — the length of the vector specified by the parameter Phi angles (deg).

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

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

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

Dependencies

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

Default value

zeros(181,361)

Program usage name

MagnitudePattern

Tunable

No

Evaluatable

Yes

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

Details

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

  • If for the parameter Input pattern coordinate system the value is set az-el Then is equal to the length of the vector specified by the parameter Elevation angles (deg), and — the length of the vector specified by the parameter Azimuth angles (deg).

  • If for the parameter Input pattern coordinate system the value is set phi-theta Then is equal to the length of the vector specified by the parameter Theta angles (deg), and — the length of the vector specified by the parameter Phi angles (deg).

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

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

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

Dependencies

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

Default value

zeros(181,361)

Program usage name

PhasePattern

Tunable

No

Evaluatable

Yes

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

Details

If this option is selected, the antenna element’s radiation pattern rotates to align with the antenna array. If the checkbox is unchecked, the directional pattern of the element does not rotate.

If the antenna is used in the antenna array and the parameter Input pattern coordinate system it matters az-el If this flag is selected, the radiation pattern rotates so that the x-axis of the element’s coordinate system points along the normal to the antenna array. If there is no choice, the directional pattern of the element without rotation is used.

If the antenna is used in the antenna array and the parameter Input pattern coordinate system it matters phi-theta, setting this flag rotates the radiation pattern so that the axis The coordinate system of the element was pointed along the normal to the antenna array.

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

Dependencies

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

Default value

true (switched on)

Program usage name

AlignElementNormal

Tunable

No

Evaluatable

No

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

Details

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

Dependencies

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

Default value

1e3

Program usage name

FrequencyPattern

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

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

Default value

-180:180

Program usage name

AnglePattern

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

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

Default value

zeros(1, 361)

Program usage name

PolarPattern

Tunable

No

Evaluatable

Yes

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

Details

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

The units of frequency measurement are Hz.

Dependencies

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

Default value

[0 1e20]

Program usage name

OperatingFrequencyRange

Tunable

No

Evaluatable

Yes

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

Details

The angles of the radiation pattern solution in degrees.

Dependencies

To use this parameter, set for the parameter Element type meaning Gaussian Antenna or Sinc Antenna.

Default value

[10, 10]

Program usage name

RadiationPatternBeamwidth

Tunable

No

Evaluatable

Yes

# Null axis direction — direction of the zero radiation axis
String

Details

The direction of the zero radiation axis.

Dependencies

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

Default value

-x

Program usage name

NullAxisDirection

Tunable

No

Evaluatable

Yes

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

Details

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

If Exponent of cosine pattern If the vector is 1 by 2, then the first element is an indicator in the direction of azimuth, and the second is in the direction of elevation. 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 for the parameter Element type meaning 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 or Omni Microphone equal to zero
Logical

Details

Select this option to mute the response of the element.

When the response is suppressed at all azimuth angles exceeding ± 90° from the normal to the grid axis, the responses are set to zero. The normal to the grid axis is defined as the azimuth angle of 0° and the elevation angle of 0°.

Dependencies

To use this parameter, set for the parameter Element type meaning Isotropic Antenna or Omni Microphone.

Default value

false (switched off)

Program usage name

BaffleBackElement

Tunable

No

Evaluatable

No

Subarray

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

Details

The geometry of the antenna array, defined as:

  • ULA — uniform linear antenna array.

  • URA — uniform rectangular antenna array.

  • UCA — uniform circular antenna array.

  • Conformal array — arbitrary arrangement of elements.

Values

ULA | URA | UCA | Conformal array

Default value

ULA

Program usage name

GeometrySubarray

Tunable

No

Evaluatable

No

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

Details

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

Dependencies

To use this parameter, set for the parameter Geometry meaning ULA or UCA.

Default value

Program usage name

NumberElementsULASubarray, NumberElementsUCASubarray

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

To use this parameter, set for the parameter Geometry meaning UCA.

Default value

0.5

Program usage name

RadiusUCASubarray

Tunable

No

Evaluatable

Yes

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

Details

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

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

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

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

mvdr beamformer 1

Dependencies

To use this parameter, set for the parameter Geometry meaning URA.

Default value

[2 2]

Program usage name

ArraySizeSubarray

Tunable

No

Evaluatable

Yes

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

Details

The distance between adjacent elements of the ULA or URA lattices in the form of a positive scalar.

Dependencies

To use this parameter, set for the parameter Geometry meaning ULA or URA.

Default value

Program usage name

ElementSpacingULASubarray, ElementSpacingURASubarray

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

To use this parameter, set for the parameter Geometry meaning 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 along the dimension of the row.

Dependencies

To use this parameter, set for the parameter Geometry meaning URA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLatticeSubarray

Tunable

No

Evaluatable

No

# Array normal — URA or UCA antenna array normal direction
x | y | z

Details

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

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

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

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

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

Dependencies

To use this parameter, set for the parameter Geometry meaning URA or UCA.

Values

x | y | z

Default value

Program usage name

ArrayNormalURASubarray, ArrayNormalUCASubarray

Tunable

No

Evaluatable

No

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

Details

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

The units of measurement are m.

Dependencies

To use this parameter, set for the parameter Geometry meaning Conformal array.

Default value

[0, 0, 0]

Program usage name

ElementPositionsSubarray

Tunable

No

Evaluatable

Yes

# Element normals (deg)the description is missing
Array of real numbers

Details

The description is missing.

Default value

[0, 0]

Program usage name

ElementNormalsSubarray

Tunable

No

Evaluatable

Yes

# Taper — the direction of the normal vectors of the elements of the conformal antenna array
Scalar / array of real and/or complex numbers

Details

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

Parameters Element positions (m) and Element normals (deg) It 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 for the parameter Geometry meaning Conformal array.

Default value

1

Program usage name

TaperSubarray

Tunable

No

Evaluatable

Yes

Array

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

Details

The geometry of the antenna array, defined as:

  • ULA — uniform linear antenna array.

  • URA — uniform rectangular antenna array.

  • UCA — uniform circular antenna array.

  • Conformal array — arbitrary arrangement of elements.

Values

ULA | URA | UCA | Conformal array

Default value

ULA

Program usage name

Geometry

Tunable

No

Evaluatable

No

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

Details

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

Dependencies

To use this parameter, set for the parameter Geometry meaning ULA or UCA.

Default value

Program usage name

NumberElementsULA, NumberElementsUCA, NumberElementsULAPart

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

To use this parameter, set for the parameter Geometry meaning UCA.

Default value

0.5

Program usage name

RadiusUCA

Tunable

No

Evaluatable

Yes

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

Details

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

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

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

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

mvdr beamformer 1

Dependencies

To use this parameter, set for the parameter Geometry meaning URA.

Default value

[2 2]

Program usage name

ArraySize

Tunable

No

Evaluatable

Yes

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

Details

The distance between adjacent elements of the ULA or URA lattices in the form of a positive scalar.

Dependencies

To use this parameter, set for the parameter Geometry meaning ULA or URA.

Default value

Program usage name

ElementSpacingULA, ElementSpacingURA

Tunable

No

Evaluatable

Yes

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

Details

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

Dependencies

To use this parameter, set for the parameter Geometry meaning 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 along the dimension of the row.

Dependencies

To use this parameter, set for the parameter Geometry meaning URA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLattice

Tunable

No

Evaluatable

No

# Array normal — URA or UCA antenna array normal direction
x | y | z

Details

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

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

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

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

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

Dependencies

To use this parameter, set for the parameter Geometry meaning URA or UCA.

Values

x | y | z

Default value

Program usage name

ArrayNormalURA, ArrayNormalUCA

Tunable

No

Evaluatable

No

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

Details

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

The units of measurement are m.

Dependencies

To use this parameter, set for the parameter Geometry meaning Conformal array.

Default value

Program usage name

ElementPositions, ElementPositionsPart

Tunable

No

Evaluatable

Yes

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

Details

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

Parameters Element positions (m) and Element normals (deg) It 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 for the parameter Geometry meaning Conformal array.

Default value

[0, 0]

Program usage name

ElementNormals

Tunable

No

Evaluatable

Yes

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

Details

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

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

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

Default value

1

Program usage name

Taper

Tunable

No

Evaluatable

Yes

# Subarray definition matrixthe description is missing
Array of real numbers

Details

The description is missing.

Default value

[ 1 1 0 0; 0 0 1 1 ]

Program usage name

SubarraySelection

Tunable

No

Evaluatable

Yes

# Subarrays layoutthe description is missing
Rectangular | Custom

Details

The description is missing.

Values

Rectangular | Custom

Default value

Rectangular

Program usage name

SubarraysLayout

Tunable

No

Evaluatable

No

# Grid sizethe description is missing
Scalar / array of real numbers

Details

The description is missing.

Default value

[1 2]

Program usage name

GridSize

Tunable

No

Evaluatable

Yes

# Grid spacing (m)the description is missing
String

Details

The description is missing.

Default value

Auto

Program usage name

GridSpacing

Tunable

No

Evaluatable

Yes

# Subarray positions (m)the description is missing
Array of real numbers

Details

The description is missing.

Default value

[0 0;-0.5 0.5;0 0]

Program usage name

SubarrayPositions

Tunable

No

Evaluatable

Yes

# Subarray normals (deg)the description is missing
Array of real numbers

Details

The description is missing.

Default value

[0 0;0 0]

Program usage name

SubarrayNormals

Tunable

No

Evaluatable

Yes

# Subarray steering methodthe description is missing
None | Phase | Time

Details

The description is missing.

Values

None | Phase | Time

Default value

None

Program usage name

SubarraySteeringMethod

Tunable

No

Evaluatable

No

# Phase shifter frequency (Hz)the description is missing
Real number

Details

The description is missing.

Default value

3e8

Program usage name

PhaseShifterFrequency

Tunable

No

Evaluatable

Yes

# Number of bits in phase shiftersthe description is missing

Details

The description is missing.

Default value

0

Program usage name

NumberBitsPhaseShifters_fog

Tunable

No

Evaluatable

Yes