Engee documentation

Angle Doppler Response

Angular Doppler response.

blockType: AngleDopplerResponse

Path in the library:

/Phased Array Systems/SpaceTimeAdaptiveProcessing/Angle Doppler Response

Description

Block Angle Doppler Response calculates the angular Doppler response of the input signal. The output response is a matrix, the rows of which are Doppler bins and the columns are corner bins.

Ports

Entrance

X — input signal
complex matrix M by N | complex vector M by N

The input signal is specified as a complex matrix of M by N or a complex vector of M by N. M is the number of elements of the antenna array or sublattice, if the antenna array supports the sublattices indicated on 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

The pulse repetition rate, set as a positive scalar.

Dependencies

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

Data types: Float64

El — elevation angle of
scalar

The elevation angle, set as a scalar. The elevation angle should be in the range from -90° to 90° inclusive.

The units of measurement are degrees.

Dependencies

To enable this port, set the Source of elevation angle parameter to `Input port'.

Data types: Float64

Output

Resp — response of the Doppler range
complex matrix P on Q

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

Data types: Float64

Support for complex numbers: Yes

Ang — values of the response angle of the pass matrix:q[<br>]real scalar Q by 1

The 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 set by the Number of angle bins parameter.

Data types: Float64

Dop — values of the Doppler response matrix
real vector P by 1

The values of the Doppler response matrix 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 the Number of Doppler bins parameter.

Data types: Float64

Parameters

Main

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

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

The default value is the speed of light: `299792458 m/s'.

The units of measurement are 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 (default) | positive scalar

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

The units of measurement are Hz.

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

Specify PRF as — the source of the PRF pass value:q[<br>]Property (default) | Input port

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

  • Parameter Pulse repetition frequency (Hz) sets 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 via the PRF input port.

Pulse repetition frequency (Hz) — pulse repetition frequency
1 (default) | positive scalar

The pulse repetition rate, PRF, is set as a positive scalar.

The units of measurement are Hz.

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

Dependencies

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

Source of elevation angle — source of pass positioning directions:q[<br>]Property (default) | Input port

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

Values of the Specify direction as parameter:

Property

The Elevation angle (deg) parameter of this block sets the elevation angle.

Input port

The elevation angle is set using the input port El

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

The elevation angle used to calculate the angular Doppler response is given as a scalar. The angle should be in the range from -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 angular pass counts:q[<br>]256 (default) | a positive integer greater than two

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

Example: 600

Data types: Float64

Number of Doppler bins — number of Doppler pass cells:q[<br>]256 (default) | a positive integer greater than two

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

Example: 128

Data types: Float64

Sensor Array

Specify sensor array as — method for specifying the antenna array
Array (no subarrays) (default)

The method for setting the antenna array, specified as `Array (no subarrays)'.

  • Array (no subarrays) – using the block parameters to set the antenna array.

Element

Element type — types of antenna array elements
Isotropic Antenna (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) — operating frequency range of the antenna or acoustic element
[0 1e20] (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 in the form of `[LowerBound,UpperBound]'. The element has no response outside this frequency range.

The units of frequency measurement are Hz.

Dependencies

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

Operating frequency vector (Hz) — operating frequency range of custom antenna elements or acoustic element
[0 1e20] (default) | real vector of lines 1 by L

Specify the frequencies at which you want to set the frequency characteristics of the antenna and the acoustic element, as a vector of lines 1 by L with increasing real values. The antenna or acoustic element has no response outside the frequency range specified by the minimum and maximum elements of this vector.

The units of frequency measurement are Hz.

Dependencies

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

Baffle the back of the element — set the response of the rear hemisphere of the Isotropic Antenna element or Omni Microphone to zero
off (default) | enabled

Select this option to mute the echo of the element.

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

Dependencies

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

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

Exponentials of the cosine model 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 the exponent in the azimuth direction, and the second is in the elevation direction.

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

Dependencies

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

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

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

Dependencies

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

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

The coordinate system of the custom antenna pattern, 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 directional pattern points.

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

Dependencies

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

Azimuth angles (deg) — azimuth angles of the radiation pattern of the antenna
[-180:180] (default) | real vector of lines 1 on P

Specify the azimuth angles used to calculate the antenna radiation pattern as a vector of lines 1 by P. P must be greater than 2. The azimuthal angles should lie between -180° and 180° inclusive and be arranged 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) — elevation angles of the pass antenna radiation:q[<br>][-90:90] (default) | real vector of rows 1 by Q

Specify the elevation angles at which the radiation pattern will be calculated as vector 1 by Q. Q must be greater than 2.

The units of measurement are degrees.

Elevation angles should range from -90° to 90° inclusive and be arranged 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 radiation pattern of the user antenna
0:360 (default) | real vector of lines 1 on P

Phi-the angles of the points at which the antenna radiation pattern is set are given as a real vector 1 by P. P must be greater than 2.

The units of measurement are degrees.

The Phi angles should range from 0° to 360° and be arranged 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 phi-theta.

Theta Angles (deg) — angular coordinates of the Theta radiation diagram of the custom antenna
0:180 (default) | real vector of lines 1 on Q

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

The units of measurement are degrees.

The theta angles should range from 0° to 360° and be arranged 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 phi-theta.

Magnitude pattern (dB) — the magnitude of the radiation pattern of the combined pass antenna:q[<br>]zeros(181.361) (default) | real matrix Q on P | real array Q on P on L

The value of the radiation pattern of the combined antenna, specified as a matrix Q by P or an array 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 L value is equal to the length of the Operating frequency vector (Hz) vector.

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

  • If the Magnitude pattern (dB) parameter is an array of Q by P by L, each page of the Q by P array sets a template for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.

Dependencies

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

Phase pattern (deg) — Custom antenna radiation phase diagram
zeros(181,361) (default) | real matrix Q on P | real matrix Q on P on L

The radiation phase diagram of a combined antenna, defined as a matrix Q by P or an array 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 L value is equal to the length of the Operating frequency vector (Hz) vector.

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

  • If the Phase pattern (deg) parameter is an array of Q by P by L, 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 parameter to Custom Antenna.

Align element normal with array normal — rotate the antenna element according to the normal of the antenna array
enabled (default) | disabled

Select this option to rotate the antenna element template according to the antenna array normal. If the checkbox is not checked, the element’s outline does not rotate.

  • If the antenna is used in an antenna array and the Input Pattern Coordinate System parameter is set to az-el, select this checkbox to rotate the element so that the x axis of the element’s coordinate system is directed along the grid normal. If the checkbox is not checked, the element template is used without rotation.

  • If the antenna is used in an antenna array and the Input Pattern Coordinate System parameter is set to phi-theta, checking this box rotates the template so that the z axis of the element coordinate system is directed along the grid normal.

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

Dependencies

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

Polar pattern frequencies (Hz) — frequencies of the polar radiation pattern of the acoustic element
1e3 (default) | real scalar | real vector of lines 1 by L

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

Dependencies

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

Polar pattern angles (deg) — angles of the radiation pattern response
[-180:180] (default) | real vector 1 on P

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

Dependencies

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

Polar pattern (dB) — custom polar characteristic of the acoustic element
zeros(1,361) (default) | the real matrix L on P

Set the value of the polar characteristic of the user acoustic element in the form of a matrix on . is the number of frequencies specified in the Polar pattern frequencies (Hz). is the number of angles specified in the Polar pattern angles (deg). Each row of the matrix represents the value of the polar radiation pattern 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 azimuthal plane. In the azimuthal plane, the elevation angle is 0°, and the central axis of capture is 0° degrees in azimuth and 0° degrees in elevation. The radiation pattern is symmetrical around the central axis. Based on the polar radiation pattern, you can build a radiation pattern of an acoustic element in three-dimensional space.

Dependencies

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

Array

Geometry — type of antenna array elements
ULA (default) | URA | UCA | Conformal array

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

  • ULA

  • URA

  • UCA

  • Conformal array

Number of elements — number of pass antenna array elements:q[<br>]2 for ULA antenna array and 5 for UCA antenna arrays (default) | an integer greater than or equal to 2

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

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

Dependencies

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

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

The distance between adjacent elements of the antenna array:

  • ULA – specify the distance between two adjacent antenna array elements as a positive scalar.

  • URA – specify the distance between the elements as a positive scalar or a vector of positive values 1 by 2. If Element spacing (m) is a scalar, the distance between rows and columns is equal. If Element spacing(m) is a vector, then the vector has the form [SpacingBetweenArrayRows,SpacingBetweenArrayColumns].

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

Dependencies

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

Array axis — direction of the ULA pass linear axis:q[<br>]y (default) | x | z

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

Dependencies

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

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

Array size — the dimension of the URA pass antenna array:q[<br>][2,2] (default) | positive integer | vector of positive integers 1 by 2

The dimension 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, then the vector has the form [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 parameter to `Replicated subarray', this parameter is applied to each antenna array.

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.

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

angle doppler response 1

Dependencies

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

Element lattice — grid of positions of URA pass elements:q[<br>]Rectangular (default) | Triangular

A grid of URA element positions, specified as Rectangular or `Triangular'.

  • 'Rectangular' – aligns all elements in the 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 according to the size of the row.

Dependencies

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

Array normal – normal direction of the antenna array
x for the URA antenna array or z for the UCA antenna array (default) | y

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

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

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

The value of the Array Normal parameter

Positions of the elements and directions of sight

x

The elements of the antenna array are located in yz-planes. All the height vectors of the elements are directed along the x axis.

y

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

z

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

Dependencies

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

Radius of UCA (m) — the radius of the UCA pass antenna array:q[<br>]0.5 (default) | positive scalar

The radius of the UCA antenna array, set 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) | a 3-by-N real matrix

The positions of the elements in the conformal antenna array, given as a real matrix 3 on 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 the antenna array element in the local antenna array coordinate system. The origin of the local coordinate system is (0,0,0).

The units of measurement are m.

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

Dependencies

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

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

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

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 column vector 2 by 1, then 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 sublattice.

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

Dependencies

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

Taper — taper of pass antenna array elements:q[<br>]1 (default) | complex scalar | complex vector of lines 1 by N

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

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

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

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

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

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

Set the choice of 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 that the element belongs to the antenna array.

If the record is zero, 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 Subarray definition matrix and Geometry parameters.

Dependencies

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

Subarray steering method — pass antenna sublattice control method:q[<br>]None (default) | Phase | Time

The antenna sublattice control method, defined as one of:

  • None

  • Phase

  • Time

The value of Phase or Time opens the input port Steer on the blocks of the narrowband receiving antenna array, narrowband transmission antenna array, broadband receiving antenna array, broadband transmission antenna array, block Constant Gamma Clutter and the GPU Constant Gamma Clutter block.

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

Dependencies

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

Phase shifter frequency (Hz) — the frequency of the phase shift of the antenna sublattice
3.0e8 (default) | positive real scalar

The operating frequency of phase shifts in the antenna sublattice, given as a positive real scalar.

The units of measurement are 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 quantization bits in the antenna sublattice
0 (default) | non-negative integer

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

Specify the location of the replicated antenna sublattices as Rectangular or `Custom'.

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

  • If you set the Subarrays layout parameter to `Custom', use the Subarray positions (m) parameters and Subarray normals to accommodate antenna sublattices.

Dependencies

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

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

The grid dimension of a rectangular antenna sublattice is set as a single positive integer or as a vector of positive integers 1 by 2 rows.

  • If Grid size is an integer scalar number, then the antenna array has an equal number of antenna sublattices 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 sublattices in each column. The second entry is the number of antenna 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 an URA antenna sublattice of size 3 by 2 can be reproduced using Grid size [1,2].

angle doppler response 2

Dependencies

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

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

The distance between the antenna sublattices on a rectangular grid, set 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 the distance between rows and the distance between columns will be the same.

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

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

Dependencies

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

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

The positions of the antenna sublattices in the user grid, defined as a 3 N real matrix, where N is the number of antenna sublattices 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. Coordinates are expressed as `[x; y; z]'.

The units of measurement are m.

Dependencies

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

Subarray normals — direction of the normal vectors of the antenna sublattices
[0,0;0,0] (default) | a 2-by-N real matrix

Specify the directions of the antenna sublattices normals in the antenna array. The value of this parameter is a matrix 2 by N, where N is the number of antenna sublattices in the antenna array. Each column of the matrix sets the direction of the normal of the corresponding antenna sublattice in the form of [azimuth;elevation].

The units of measurement are degrees.

The angles are determined relative to the local coordinate system.

You can use the Subarray positions and Subarray normals parameters to represent any arrangement in which pairs of antenna sublattices differ by certain transformations. Transformations can combine translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation relative to the normal.

Dependencies

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