Engee documentation

Angle Doppler Response

Angular Doppler response.

angle doppler response

Description

The Angle Doppler Response block calculates the angular Doppler response of the input signal. The output response is a matrix whose rows are Doppler bins and columns are angular bins.

Ports

Input

X is the input signal
complex matrix M on N | complex vector M on N

The input signal given as a complex matrix M on N or a complex vector M on N. M is the number of antenna array elements, or sublattice elements if the antenna array supports sublattices as specified in the Sensor Array panel. N is the number of data samples. N must be greater than or equal to two.

Data types: Float64

Support for complex numbers: Yes

PRF - pulse repetition rate
`positive scalar

Pulse repetition rate specified as a positive scalar.

Dependencies

To enable this port, set the Specify PRF as parameters to Input port.

Data types: Float64.

El - elevation angle
scalar

Elevation angle specified as a scalar. The elevation angle must lie in the range from -90° to 90° inclusive.

The unit of measurement is degrees.

Dependencies

To enable this port, set the Source of elevation angle parameters to Input port.

Data types: Float64.

Output

Resp - Doppler range response
complex matrix P to Q

The angular Doppler response returned as a matrix P on Q. P is given by the Number of Doppler bins parameter and Q is given by the Number of angle bins parameter.

Data types: Float64.

Support for complex numbers: Yes

Ang - matrix response angle values
real scalar Q by 1

Angular values of the response matrix returned as a real scalar Q by 1. The angular values correspond to the columns of the angular Doppler response matrix. Q is specified by the parameter Number of angle bins.

Data types: Float64.

Dop - values of Doppler response matrix
real vector P at 1

Doppler response matrix values returned as a real vector P by 1. The Doppler values correspond to the rows of the angular Doppler response matrix. P is set by parameters Number of Doppler bins.

Data types: Float64.

Parameters

Main

Signal propagation speed (m/s) - signal propagation speed, m/s
299792458 m/s (by default) | positive scalar

Signal propagation speed as a real positive scalar.

By default, the value of the speed of light is used: 299792458 m/s.

The unit of measurement is m/s.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Operating frequency (Hz) - operating frequency of the system, Hz
3e8 (by default) | positive scalar

The operating frequency of the system specified as a positive scalar.

The unit of measurement is Hz.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Specify PRF as - source of PRF value
Property (By default) | Input port

The source of the PRF value specified as Property or Input port.

  • The Pulse repetition frequency (Hz) parameter specifies the PRF value (i.e. the numeric value of the PRF value).

  • If the Specify PRF as parameter is set to Input port, set the PRF frequency through the PRF input port.

Pulse repetition frequency (Hz) is the pulse repetition frequency
1 (By default) | Positive scalar

Pulse repetition frequency, PRF, specified as a positive scalar.

The unit of measurement is Hz.

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

Dependencies

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

Source of elevation angle - source of positioning directions
Property (By default) | Input port.

The source of positioning directions specified as Property or Input port.

The values of the Specify direction as parameters:

Property

The Elevation angle (deg) parameters of this block specify the elevation angle

Input port

The elevation angle is set using the El input port.

Elevation angle (deg) is the elevation angle used to calculate the Doppler angular response
0 (By default) | scalar

The elevation angle used to calculate the Doppler angle response is specified as a scalar. The angle must be in the range of -90° to 90°.

The units of measurement are degrees.

Example: 45

Dependencies

To enable this parameter, set the Source of elevation angle parameter to Property.

Data types: Float64.

Number of angle bins - number of angle bins
256 (by default) | A positive integer greater than two

The number of angle bins used to calculate the angular Doppler response is set to a positive integer greater than two.

Example: `600

Data types: Float64.

Number of Doppler bins - number of Doppler cells
256 (by default) | positive integer greater than two

The number of samples in the Doppler area used to calculate the Doppler angular response is set as a positive integer greater than two.

Example: 128.

Data types: Float64.

Sensor Array

Specify sensor array as - method of specifying the antenna array
`Array (no subarrays) (by default)

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

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

Element

Element type - types of antenna array elements
Isotropic Antenna (By default) | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

The type of antenna or acoustic element specified as one of the following:

  • Isotropic Antenna.

  • Cardioid Antenna

  • Cosine Antenna

  • `Custom Antenna

  • `Gaussian Antenna

  • `Sinc Antenna

  • `Omni Microphone

  • `Custom Microphone

Operating frequency range (Hz) - the operating frequency range of the antenna or acoustic element
[0 1e20] (by default) | ` real vector of lines 1 by 2`

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

The unit of frequency measurement is Hz.

Dependencies

To enable this parameter, set the Element type parameters to Isotropic Antenna, Cardioid Antenna, Cosine Antenna, Gaussian Antenna, Sinc Antenna or Omni Microphone.

Operating frequency vector (Hz) - the operating frequency range of the custom antenna or acoustic element elements
[0 1e20] (by default) | ` real vector of strings 1 to L`

Specify the frequencies at which the frequency response of the antenna and acoustic element is to be set as a vector of strings of 1 on L with increasing real values. The antenna or acoustic element has no response outside the frequency range given by the minimum and maximum elements of this vector.

The unit of frequency measurement is Hz.

Dependencies

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

Baffle the back of the element - set the back hemisphere response of the Isotropic Antenna element or Omni Microphone to zero
off (by default) | on

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

When diverted back, the echoes 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 enable this checkbox, set the Element type parameters to Isotropic Antenna or Omni Microphone.

Exponent of cosine pattern - specifies the exponents of azimuthal and altitude cosine directional patterns
[1.5 1.5] (by default) | non-negative scalar | real matrix 1 by 2 non-negative values

Cosine model exponents as 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, the first element is the exponent in the azimuth direction and the second element is the exponent in the elevation direction.

  • If Exponent of cosine pattern is a scalar, the cosines in the azimuth and elevation directions are raised to one degree.

Dependencies

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

Frequency responses (dB) - frequency responses of the antenna and acoustic element
[0,0] (by default) | real vector of rows

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

Dependencies

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

Input Pattern Coordinate System - the coordinate system of the custom antenna pattern
az-el (by default) | phi-theta.

Antenna user pattern coordinate system specified as az-el or phi-theta.

  • If the Input Pattern Coordinate System is set as az-el, use the Azimuth angles (deg) and Elevations angles (deg) parameters to set the coordinates of the pattern points.

  • If Input Pattern Coordinate System is set as phi-theta, use the parameters Phi angles (deg) and Theta angles (deg) to specify the coordinates of the pattern points.

Dependencies

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

Azimuth angles (deg) - azimuth angles of the antenna radiation pattern
[-180:180] (by default) | ` real vector of lines 1 to P`.

Specify the azimuth angles at which the antenna radiation pattern is calculated as a vector of lines 1 on P. P must be greater than 2. The azimuthal angles must lie between -180° and 180° inclusive and be in strictly ascending order.

Dependencies

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

Elevation angles (deg) - antenna radiation elevation angles
[-90:90] (by default) | ` real vector of rows 1 on Q`

Specify the elevation angles at which the radiation pattern will be computed as a vector of 1 on Q. Q must be greater than 2.

The units of measurement are degrees.

The elevation angles must lie in the range from -90° to 90° inclusive and be in strictly ascending order.

Dependencies

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

Phi Angles (deg) - angular coordinates of the Phi pattern of the directional radiation pattern of the custom antenna
0:360 (by default) | ` real vector of lines 1 on P`

Phi-angle points where the antenna radiation pattern is specified are specified as a real vector of 1 on P. P must be greater than 2.

The units of measurement are degrees.

Phi-angles must lie in the range from 0° to 360° and be arranged in strictly increasing order.

Dependencies

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

Theta Angles (deg) - Theta angular coordinates of the Theta radiation pattern of the custom antenna
0:180 (by default) | ` real vector of lines 1 to Q`

Theta angles of the points at which the antenna radiation pattern is specified are specified as a real vector of 1 on Q. Q must be greater than 2.

The units of measurement are degrees.

Theta-angles must lie in the range from 0° to 360° and be arranged in strictly increasing order.

Dependencies

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

Magnitude pattern (dB) is the magnitude of the radiation pattern of the combination antenna
zeros(181,361) (by default) | real matrix Q on P | real array Q on P on L

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

  • When 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 the Magnitude pattern (dB) 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 Magnitude pattern (dB) parameter is a Q by P by L array, each page of the Q by P array specifies a pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.

Dependencies

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

Phase pattern (deg) - custom antenna radiation phase pattern
zeros(181,361) (by default) | real matrix Q on P | real matrix Q on P on L

The phase radiation pattern of a compound antenna, given 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 value is equal to the length of the Operating frequency vector (Hz).

  • If the Phase pattern (deg) 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 Phase pattern (deg) parameter is a Q by P by L array, each page of the Q by P array defines a pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.

Dependencies

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

Align element normal with array normal - rotate the antenna element according to the antenna array normal
On (By default) | Off.

Select this check box to rotate the antenna element pattern according to the antenna array normal. If the check box is not selected, the element pattern is not rotated.

  • If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters are set to az-el, select this check box to rotate the element so that the x axis of the element coordinate system is along the normal of the array. If the check box is not selected, the pattern of the element is used without rotation.

  • 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 together with the Array normal parameters of URA and UCA antenna arrays.

Dependencies

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

Polar pattern frequencies (Hz) - frequencies of the polar pattern of the acoustic element
1e3 (By default) | real scalar | real vector of lines 1 to L

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

Dependencies

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

Polar pattern angles (deg) - directional pattern response angles
[-180:180] (By default) | `real vector 1 on P'.

Specify the response angles of the polar pattern angles as vector 1 on . The angles are measured from the centre axis of the acoustic element and must be between -180° and 180° inclusive.

Dependencies

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

Polar pattern (dB) is the custom polar characteristic of the acoustic element
zeros(1,361) (by default) | real matrix L over P.

Set the value of the polar response of the custom acoustic element as a matrix to . - is the number of frequencies specified in Polar pattern frequencies (Hz). - is the number of angles specified in Polar pattern angles (deg). Each row of the matrix represents the polar pattern magnitude measured at the corresponding frequency specified in Polar pattern frequencies (Hz) and all angles specified in Polar pattern angles (deg).

The pattern is measured in the azimuth plane. In the azimuth plane, the elevation angle is 0°, and the centre axis of capture is 0° deg in azimuth and 0° deg in elevation. The radiation pattern is symmetrical around the centre axis. Based on the polar radiation pattern, you can plot the radiation pattern of an acoustic element in three-dimensional space.

Dependencies

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

Array

Geometry - type of antenna elements of the array
ULA (by default) | URA | UCA | Conformal array

Specify the type of antenna elements of the antenna array as one of the following:

  • ULA.

  • URA

  • `UCA

  • Conformal array

Number of elements - number of antenna array elements
2 for ULA antenna array and 5 for UCA antenna arrays (by default) | `an integer greater than or equal to 2'.

The number of elements in ULA or UCA antenna arrays, specified as an integer greater than or equal to 2.

When the Specify sensor array as parameter is set to Replicated subarray, this parameter is applied to each antenna subarray.

Dependencies

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

Element spacing (m) is the distance between the elements of the antenna array
0.5 for ULA antenna array and [0.5,0.5] for URA antenna arrays (by default) | positive scalar for ULA or URA antenna array | `2-element vector of positive values for URA antenna arrays.

Distance between neighbouring elements of the antenna array:

  • ULA - Specify the distance between two neighbouring antenna array elements as a positive scalar.

  • URA - specify the distance between elements as a positive scalar or vector of positive values 1 by 2. If Element spacing (m) is a scalar, the row and column spacing is equal. If Element spacing (m) is a vector, the vector is [SpacingBetweenArrayRows,SpacingBetweenArrayColumns].

  • If you set the Specify sensor array as parameters to Replicated subarray, this parameter is applied to each antenna subarray.

Dependencies

To enable this parameter, set the Geometry parameters to ULA or URA.

Array axis - direction of linear axis of ULA
y (By default) | x | z

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

Dependencies

  • To enable this parameter, set the Geometry parameters to ULA.

  • This parameter is also enabled if the unit only supports ULA antenna arrays.

Array size - dimension of the URA antenna array
[2,2] (by default) | positive integer | vector of positive integers 1 by 2.

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

  • If Array size is a 1-by-2 vector, the vector is [NumberOfArrayRows,NumberOfArrayColumns].

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

  • If you set the Specify sensor array as parameters to Replicated subarray, this parameter is applied to each antenna array.

For URA, the antenna array elements are indexed from top to bottom of the leftmost column and then proceed to the next columns from left to right.

In this figure, the value [3,2] of the Array size parameter creates an antenna array with three rows and two columns.

angle doppler response 1

Dependencies

To enable this parameter, set the Geometry parameters to URA.

Element lattice - the lattice of URA element positions
Rectangular (by default) | Triangular.

Lattice of URA element positions specified as Rectangular or Triangular.

  • Rectangular - aligns all elements in row and column directions.

  • 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 by the row size.

Dependencies

To enable this parameter, set the Geometry parameter to URA.

Array normal - direction of the antenna array normal
x for a URA antenna array or z for a UCA antenna array (by default) | y.

Antenna array normal direction specified as x, y or z.

The elements of planar antenna arrays lie in a plane orthogonal to the selected antenna array normal direction.

The sighting directions of the elements are indicated along the normal direction of the antenna array:

Array Normal parameter value

Element Positions and Sighting Directions

x

The elements of the antenna array lie in the yz-plane. All element height vectors are directed along the x axis.

y

The elements of the antenna array lie in the zx-plane. All axial direction vectors of the elements are directed along the y axis.

z

The elements of the antenna array lie in the xy-plane. All element axial direction vectors are directed along the z-axis.

Dependencies

To enable this parameter, set the Geometry parameters to URA or UCA.

Radius of UCA (m) - radius of UCA antenna array
0.5 (by default) | `positive scalar'.

The radius of the UCA antenna array specified as a positive scalar.

Dependencies

To enable this parameter, set the Geometry parameter to UCA.

Element positions (m) - positions of the elements of the conformal antenna array
[0;0;0] (by default) | ` real matrix 3 by N`

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

The unit of measurement is m.

If you set the Specify sensor array as parameters to Replicated subarray, this parameter is applied to each antenna subarray.

Dependencies

To enable this parameter, set the Geometry parameters to Conformal Array.

Element normals (deg) - direction of normal vectors of elements of the conformal antenna array elements
[0;0] (by default) | vector-column 2 by 1 | matrix 2 by N

The direction of the element normal vectors in a conformal antenna array, given as a vector-column 2 by 1 or a matrix 2 by N. N indicates the number of elements in the antenna array. 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.

The local coordinate system aligns the positive x-axis with the direction of the normal to the conformal antenna array.

If the parameter value is a 2 by 1 column vector, the same direction is used for all elements of the antenna array.

If the Specify sensor array as parameter is set to Replicated subarray, this parameter is applied to each antenna subarray.

You can use the parameters Element positions (m) and Element normals (deg) to represent any arrangement in which pairs of elements are distinguished by certain transformations. The transformations can combine translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to the direction of the normal.

Dependencies

To enable this parameter, set the Geometry parameter to Conformal Array.

Taper - taper of antenna array elements
1 (by default) | complex scalar | complex vector of strings 1 by N

A narrowing of the element pattern, given as a complex scalar or complex vector of lines 1 by _N. In this vector, N represents the number of elements in the antenna array.

Also known as weighting coefficients, cones multiply the responses of the elements of an antenna array. The cones change the amplitude and phase of the response to reduce side lobes or to direct the main axis of the response.

  • If Taper is a scalar, the same weighting factor is applied to each element.

  • If Taper is a vector, the weighting factor from the vector is applied to the corresponding antenna array element. The number of weight coefficients must correspond to the number of antenna array elements.

If the Specify sensor array as parameter is set to Replicated subarray, this parameter is applied to each antenna subarray.

Subarray definition matrix - definition of elements belonging to the antenna sublattice
logic matrix

Define the antenna sublattice selection as a matrix 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 the element’s membership in the antenna array.

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 the antenna sublattice depends on the parameters Subarray definition matrix and Geometry.

Dependencies

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

Subarray steering method - Antenna sub array steering method
None (by default) | Phase | Time.

The antenna sublattice steering method specified as one of:

  • None

  • Phase

  • Time

The Phase or Time value opens the Steer input port on the Narrowband Receive Antenna Array, Narrowband Transmit Antenna Array, Wideband Receive Antenna Array, Wideband Transmit Antenna Array, Constant Gamma Clutter unit and GPU Constant Gamma Clutter unit.

The `Custom' value opens the WS input port on the Narrowband Receive Array, Narrowband Transmit Array, Wideband Receive Array, Wideband Transmit Array, Constant Gamma Clutter and GPU Constant Gamma Clutter units.

Dependencies

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

Phase shifter frequency (Hz) - the phase shift frequency of the antenna sub array
3.0e8 (By default) | Positive real scalar

The operating frequency of the phase shifter frequency of the antenna sublattice, specified as a positive real scalar.

The unit of measurement is Hz.

Dependencies

To enable this parameter, set the Specify sensor array as parameter to Partitioned array or Replicated subarray and the Subarray steering method parameter to Phase.

Number of bits in phase shifters c phase shift quantisation bits in the antenna sublattice
0 (by default) | non-negative integer.

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

Dependencies

To enable this parameter, set the Specify sensor array as parameter to Partitioned array or Replicated subarray and the Subarray steering method parameter to Phase.

Subarrays layout - specification of the position of the antenna subarray
Rectangular (by default) | Custom.

Specify the layout of replicated antenna subarrays as Rectangular or Custom.

  • If you set the Subarrays layout parameter to Rectangular, use the Grid size and Grid spacing parameters to position the antenna subarrays.

  • If you set the Subarrays layout to Custom, use the Subarray positions (m) and Subarray normals parameters to position the antenna arrays.

Dependencies

To enable this parameter, set the Specify sensor array as parameters to `Replicated subarray'.

Grid size - dimensions of the rectangular grid of the antenna sublattice
[1,2] (By default).

Rectangular antenna sublattice grid dimension, set as one positive integer or as a vector of positive integers 1 by 2 rows.

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

  • If Grid size is a 1-by-2 vector of the form [NumberOfRows, NumberOfColumns], then the first entry is the number of antenna sub-grids in each column. The second entry is the number of antenna sublattices in each row. A row is along the local y-axis and a column is along the local z-axis.

The figure shows how a URA antenna sublattice of size 3 by 2 can be reproduced using Grid size [1,2].

angle doppler response 2

Dependencies

To enable this parameter, set the Specify sensor array as parameter to Replicated subarray and the Subarrays layout parameter to Rectangular.

Grid spacing (m) - distance between antenna subarrays on a rectangular grid
Auto (by default) | positive real scalar | positive real vector 1 by 2

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

The units of measurement are m.

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

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

  • If the Grid spacing (m) parameters is set to Auto, replication preserves the spacing between antenna sublattice elements for both rows and columns when building a complete antenna array. This option is available only if you set the Geometry parameters to ULA or URA.

Dependencies

To enable this option, set the Specify sensor array as parameters to Replicated subarray and the Subarrays layout parameters to Rectangular.

Subarray positions (m) - positions of antenna subarrays
[0,0;0.5,0.5;0,0] (by default) | real matrix 3 by N

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

The units of measurement are m.

Dependencies

To enable this parameter, set the Specify sensor array as parameter to Replicated subarray and the Subarrays layout parameter to Custom.

Subarray normals - direction of antenna subarray normal vectors
[0,0;0,0] (by default) | ` real matrix 2 by N`

Specify the directions of the antenna sublattice normals in an antenna array. The value of this parameters is a 2 by N matrix, where N is the number of antenna sub-arrays in the antenna array. Each column of the matrix specifies the normal direction of the corresponding antenna sublattice in the form [azimuth;elevation].

The units of measurement are degrees.

The angles are defined with respect to the local coordinate system.

You can use the Subarray positions and Subarray normals parameters to represent any arrangement in which pairs of antenna sub-arrays are distinguished by certain transformations. The transformations can combine translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to the normal.

Dependencies

To enable this parameter, set the Specify sensor array as parameter to Replicated subarray and the Subarrays layout parameter to Custom.