GCC DOA and TOA
Generalised phase-transformed cross-correlator.
Description
The GCC DOA and TOA block estimates the direction and time of signal arrival at the antenna array. The block uses generalised cross-correlation with phase transform (GCC-PHAT).
Ports
Input
X - input signal
`complex matrix of size M by N
The input signal is a matrix of size by , where is the number of samples of the signal and is the number of antenna array elements.
Data types: Float32
, Float64
.
Support for complex numbers: Yes
Output
Ang - angles defining the directions of signal arrival
real vector 2 by 1
Angles defining the directions of signals arrival, returned as a vector with real values in the form [azimuth, elevation]
. If the antenna elements are a linear antenna array (ULA), then Ang is a scalar representing the angle of the transverse direction of radiation. The units of the angle are degrees, defined relative to the local coordinate system of the antenna array.
Data types: Float64
.
Tau - arrival time delays
real vector-string 1 on P
Arrival time delays output as a real-valued vector-string 1 on , where is the number of pairs of antenna array elements selected from the antenna array.
-
If the Source of sensor pairs parameter is set to
Auto
, then , where is the number of antenna array elements in the antenna array. -
If the Source of sensor pairs parameter has the
Property
value, then is the number of antenna array element pairs specified by the Sensor pairs parameter.
The unit of time measurement is seconds.
Dependencies
To use this port, set the Enable delay output parameters to `enable'.
Data types: Float64
.
Rxy - estimated cross-correlation
`complex matrix of size (2M+1) on P
The calculated cross-correlation between pairs of antenna array elements, is derived as a complex matrix of size by , where is the number of pairs of antenna array elements selected from the antenna array, and is the number of time samples in the input signal.
-
If the Source of sensor pairs parameter is set to
Auto
, then , where is the number of sublattice elements in the antenna array. The columns in Rxy contain the correlations between the first element of the antenna array and all other elements. -
If the Source of sensor pairs parameter is
Property
, then is the number of antenna array element pairs specified by the Sensor pairs parameter. Each column in Rxy contains the correlation for the corresponding pair of antenna array elements.
Dependencies
To use this port, set the Enable correlation output parameters to `enabled'.
Data types: Float64
.
Support for complex numbers: Yes
Lag - lag time.
real vector-column (2M+1) by 1
The lag time values output as a real vector-column by 1, where is the number of time samples in the input signal. Each lag time value refers to the corresponding row of the cross-correlation matrix.
Dependencies
To use this port, set the Enable correlation output parameters to `enable'.
Data types: Float64
.
Parameters
Main
Signal propagation speed (m/s) - signal propagation speed
299792458 (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.
Inherit sample rate - inherit sample rate
On (By default)
| Off
.
Select the checkbox to inherit sample rate from upstream blocks. Otherwise, set the sample rate using the Sample rate (Hz) parameters.
Sample rate (Hz) - sampling rate
1e6 (by default)
| `positive real scalar'.
The sampling frequency of the signal as a positive scalar. The unit of measurement is Hz.
Dependencies
To use this parameter, set the Inherit sample rate parameter to off
.
Source of sensor pairs - option to specify pairs of antenna array elements
Auto (by default)
| `Property `
Options for selection:
-
Property
- Specify pairs of antenna array elements to calculate correlation using the Sensor pairs parameters. -
Auto
- correlation calculation is performed between the first element and all other elements. The first element serves as a reference channel.
Sensor pairs - pairs of antenna array elements
[2; 1]
Pairs of antenna array elements given as matrix 2 at of positive integers.
Dependencies
To use this parameter, set the Source of sensor pairs parameter to Property
.
Enable correlation output - option to enable the correlation output port
disabled (by default)
| enabled
.
Select this checkbox to output the correlation values calculated using the GCC-PHAT algorithm, as well as the corresponding lag times between pairs of antenna array elements. The correlation values are output through the Rxy port and the lag times are output through the Lags port.
Enable delay output - option to enable the arrival delay time output port
enable (by default)
| enabled
.
Select this checkbox to output the delay corresponding to the signal arrival angle between pairs of antenna array elements. The delay is output to the Tau port.
Sensor Array
Specify sensor array as - method to specify antenna array
Array (no subarrays) (by default)
| Partitioned array
| Replicated subarray
Specify an antenna element or antenna array. An antenna array may also contain subarrays or be partitioned.
Available values:
-
Array (no subarrays)
. -
Partitioned array
-
Replicated subarray
Element
Element type - types of antenna elements
Isotropic Antenna (by default)
| Cardioid Antenna
| Cosine Antenna
| Custom Antenna
| Gaussian Antenna
| Sinc Antenna
| Omni Microphone
| Custom Microphone
Type of antenna array element.
Available values:
-
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 array element
[0,1e20] (by default)
| ` real vector-string 1 by 2`
The operating frequency range of the antenna array element as a 1-by-2 string vector element as [LowerBound, UpperBound]. The element has no response outside this frequency range. Frequency measurement units are Hz.
Dependencies
To use this parameter, set the Element type parameters to Isotropic Antenna
, Cosine Antenna
or Omni Microphone
.
Baffle the back of the element - take into account the radiation pattern to the rear hemisphere of the Isotropic Antenna element
or Omni Microphone
.
off (by default)
| on
.
Set this flag to exclude radiation to the rear hemisphere. The response from the rear hemisphere at all azimuth angles outside the ±90° interval from the broadside are set to zero. The broadside direction is defined as an azimuth angle of 0° and a place angle of 0°.
Dependencies
To use this parameter, set the Element type parameters to Isotropic Antenna
or Omni Microphone
.
Null axis direction - the direction of the axis along the null radiation.
-x (By default)
| +x
| +y
| -y
| +z
| -z
.
Axis direction along the null radiation.
Dependencies
To use this parameter, set the Element type parameters to Cardioid Antenna
.
Exponent of cosine pattern - exponent of exponent degree when specifying the shape of cosine pattern
[1.5, 1.5] (By default)
| non-negative scalar
| real matrix of non-negative values 1 by 2
.
The exponent of the degree of the exponent of cosine model 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 of the exponent degree in the azimuth direction and the second element is the exponent of the exponent degree in the angle-of-place direction. When this parameters is scalar, the cosines in the azimuth and elevation directions are raised to the same degree.
Dependencies
To use this parameter, set the Element type parameter to Cosine Antenna
.
Operating frequency vector (Hz) - array of operating frequencies of the antenna array element
[0,1e20] (by default)
| real string vector
The array of operating frequencies of the antenna array element as a string vector 1 on of increasing real values. The element has no response outside the frequency range given by the minimum and maximum elements of this vector. The units of frequency measurement are Hz.
Dependencies
To use this parameter, set the Element type parameters to Custom Antenna
or Custom Microphone
. To set the response at these frequencies, use the Frequency responses (dB) parameters.
Frequency responses (dB) - frequency responses of the antenna array element
[0,0] (by default)
| real vector-string
.
The frequency response of custom antenna array elements is determined by the Operating frequency vector (Hz) parameters. The dimensions of the Frequency responses (dB) vector must match the dimensions of the vector defined by the Operating frequency vector (Hz) parameters.
Dependencies
To use this parameter, set the Element type parameters to Custom Antenna
or Custom Microphone
.
Input Pattern Coordinate System - selects the coordinate system of the custom antenna pattern
az-el (by default)
| phi-theta
.
Selects the user antenna pattern coordinate system, either az-el
or phi-theta
is specified. When az-el is selected, the Azimuth angles (deg) and Elevations angles (deg) parameters are used to specify the coordinates of the directional pattern points. When the `phi-theta
parameter is specified, the Phi angle (deg) and Theta angles (deg) parameters are used to specify the coordinates of the pattern points.
Dependencies
To use 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-string
The azimuth angle values for which the antenna radiation pattern will be calculated as vector-string 1 at . must be greater than 2. The values of the azimuth angles must lie in the range from −180° to 180° inclusive and be in strictly ascending order.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
and the Input Pattern Coordinate System parameter to az-el
.
Elevation angles (deg) - values of antenna pattern location angles
[-90:90] (by default)
| real vector-string
.
The values of the place angles at which you want to calculate the radiation pattern as vector 1 at . must be greater than 2. The units of measurement of the angles are degrees. The elevation angles must lie in the range from −90° up to and including 90° and be in strictly ascending order.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
and the Input Pattern Coordinate System parameter to az-el
.
Phi Angles (deg) - values of Phi angles of the antenna pattern
[0:360] (by default)
| ` real vector-line 1 on P`
Angular coordinates Phi of the points at which the antenna radiation pattern is specified. Defined as a real vector-string 1 on . must be greater than 2. The units of measurement of the angles are degrees. The values of the angles Phi
must lie in the range from 0° to 360° and be arranged in strictly ascending order.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
and the Input Pattern Coordinate System parameter to phi-theta
.
Theta Angles (deg) - values of Theta angles of the antenna radiation pattern
[0:180] (by default)
| real vector-string 1 on Q
Theta angular coordinates of the points where the antenna radiation pattern is specified. Defined as a real vector-string 1 on . must be greater than 2. The units of measurement of the angles are degrees. Values of the angles Theta
must lie in the range from 0° to 180° and be arranged in strictly ascending order.
Dependencies
To use 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 antenna pattern
zeros(181,361) (by default)
| real matrix Q on P
| real array Q on P on L
Antenna pattern magnitude given as a matrix by or an array by by .
-
If the Input Pattern Coordinate System parameter is set to
az-el
, then is equal to the length of the vector defined by the Elevation angles (deg) parameter, in turn, is equal to the length of the vector defined by the Azimuth angles (deg) parameter. -
If the Input Pattern Coordinate System parameter is set to
phi-theta
, then is equal to the length of the vector defined by the Theta Angles (deg) parameter, in turn, is equal to the length of the vector defined by the Phi Angles (deg) parameter.
The value of is equal to the value of the Operating frequency vector (Hz) parameters.
-
If the value of this parameter is a matrix to , then the same scheme is applied for all frequencies specified in the Operating frequency vector (Hz) parameter.
-
If the value is an array to to , each element to of the array specifies a pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameters.
Dependencies
To use this parameter, set the Element type parameters to Custom Antenna
.
Phase pattern (deg) - the phase of the radiation pattern of the custom antenna
zeros(181,361) (By default)
| real matrix Q on P
| real array Q on P on L
The phase radiation pattern of the combined antenna, given as a matrix on or an array on on .
-
If the Input Pattern Coordinate System parameter is set to
az-el
, then is equal to the length of the vector defined by the Elevation angles (deg) parameter, in turn, is equal to the length of the vector defined by the Azimuth angles (deg) parameter. -
If the Input Pattern Coordinate System parameter is set to
phi-theta
, then is equal to the length of the vector defined by the Theta Angles (deg) parameter, in turn, is equal to the length of the vector defined by the Phi Angles (deg) parameter.
The value of is equal to the value of the Operating frequency vector (Hz) parameters.
-
If the value of this parameter is a matrix to , then the same scheme is applied for all frequencies specified in the Operating frequency vector (Hz) parameter.
-
If the value is an antenna array to to , each element to of the array sets the pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameters.
Dependencies
To use this parameter, set the Element type parameters to Custom Antenna
.
Align element normal with array normal - align the normal of the antenna array element with the array normal
On (By default)
| Off
.
If the parameters value is On
, the pattern of the antenna element is rotated to align with the normal of the antenna array. If off
, the pattern of the element is not rotated.
If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters are set to az-el
, selecting this check box rotates the element pattern so that the x-axis of the element coordinate system points along the normal of the antenna array. If no selection is made, the element pattern without rotation is used.
If the antenna is used in an antenna array and the Input Pattern Coordinate System parameters is set to phi-theta
, selecting this check box rotates the pattern so that the z-axis of the element coordinate system points along the normal of the antenna array.
Use this parameter in conjunction with the Array Normal parameters of the URA and UCA antenna array.
Dependencies
To use this parameter, set the Element type parameters to Custom Antenna
.
Radiation pattern beamwidth (deg) - width of the antenna pattern beamwidth
[10, 10] (by default)
| real scalar
| real vector-string 1 by 2
Antenna pattern beamwidth in degrees.
Dependencies
To use this parameter, set the Element type parameters to Gaussian Antenna
.
Polar pattern frequencies (Hz) - values of frequencies for polar pattern of the microphone
1e3 (By default)
| real scalar
| real vector-string 1 by L
.
The frequency values for the polar radiation pattern are given as a real scalar or real vector-string 1 on . The frequencies lie within the frequency range specified by the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set the Element type parameters to Custom Microphone
.
Polar pattern angles (deg) - angle values for the polar pattern of the microphone
[-180:180] (by default)
| real vector string 1 on P
.
The angle values for the microphone’s polar pattern are specified as a vector . The angles are measured from the centre axis of the microphone and should range from −180° to 180° inclusive.
Dependencies
To use this parameter, set the Element type parameters to Custom Microphone
.
Polar pattern (dB) - polar pattern of the microphone
zeros(1,361) (by default)
| `real vector string 1 to L'.
Set the polar pattern magnitude of the user microphone element as a real vector-string 1 by , where is the number of frequencies specified in the Polar pattern frequencies (Hz) parameters. The string represents the polar pattern magnitude measured at the corresponding frequency specified in Polar pattern frequencies (Hz). The directional pattern is measured in the azimuth plane. In the azimuth plane, the angle of place is 0° and the centre axis is 0° in azimuth and 0° in elevation. The polar pattern is symmetrical around the centre axis. Based on the polar diagram, you can construct the microphone’s directional pattern in three-dimensional space.
Dependencies
To use this parameter, set the Element type parameters to Custom Microphone
.
Array
Geometry - geometry of the antenna array
ULA (by default)
| URA
| UCA
| Conformal Array
The geometry of the antenna array defined as:
-
ULA
is a uniform linear antenna array. -
URA
- uniform rectangular antenna array. -
UCA
- uniform circular antenna array. -
Conformal Array
- arbitrary arrangement of elements.
Number of elements - number of antenna array elements
2 for ULA antenna array and 5 for UCA (by default)
| `an integer greater than or equal to 2'.
The number of antenna array elements for ULA or UCA, 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 subarray.
Dependencies
To use this parameter, set the Geometry parameters to ULA
or UCA
.
Array size - URA antenna array dimensions
[2,2] (by default)
| positive integer
| vector of positive integers 1 by 2
URA antenna array dimensions specified as a positive integer or a vector of positive integers 1 by 2.
-
If the antenna array size is a 1-by-2 vector, the vector is of the form [NumberOfArrayRows, NumberOfArrayColumns].
-
If the antenna array size is an integer, the array has the same number of rows and columns.
When the Specify sensor array as parameter is set 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. The figure shows an antenna array for which the Array size parameter is set to [3,2]
, that is, it has three rows and two columns.
Dependencies
To use this parameter, set the Geometry parameter to URA
.
Element spacing (m) - distance between antenna array elements
` 0.5 for ULA arrays and [0.5,0.5] for URA arrays (by default)` | ` positive scalar for ULA or URA arrays | ` two-element vector of positive values for URA arrays`.
Distance between neighbouring lattice elements:
-
ULA
- specify the distance between two neighbouring antenna array elements as a positive scalar. -
URA
- specify the distance as a positive scalar or vector of positive values 1 by 2. If Element spacing (m) is a scalar, the distances between rows and columns are equal. If Element spacing (m) is a vector, the vector is[SpacingBetweenArrayRows,SpacingBetweenArrayColumns]
.
When the Specify sensor array as parameter is set to Replicated subarray
, this parameter is applied to each antenna array.
Dependencies
To use this parameter, set the Geometry parameters to ULA
or URA
.
Array axis - direction of the 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 array coordinate system.
Dependencies
-
To use this parameter, set the Geometry parameter to
ULA
. -
This parameter is also used if the unit only supports ULA arrays.
Element lattice - lattice of URA element positions
Rectangular (by default)
| Triangular
.
Lattice of URA element positions specified as rectangular or triangular.
-
Rectangular
- aligns all elements by rows and columns. -
Triangular
- shifts elements of the even row of the rectangular lattice towards the positive direction of the row axis. The offset is half the distance between the elements by the row size.
Dependencies
-
To use this parameter, set the Geometry parameter to
URA
.
Array normal - direction of the antenna array normal
x for URA arrays or z for UCA arrays (by default)
| y
.
Antenna array normal direction specified as x
, y
or z
.
The elements of planar gratings 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 normal direction of the antenna array.
-
x
- the antenna array elements lie in the yz-plane. The angular coordinate vectors of all elements are directed along the x-axis. -
y
- the elements of the antenna array lie in the zx-plane. The vectors of angular coordinates of all elements are directed along the y-axis. -
z
- elements of the antenna array lie in the xy-plane. The vectors of angular coordinates of all elements are directed along the z-axis.
Dependencies
To use this parameter, set the Geometry parameter to URA
or UCA
.
Radius of UCA (m) - radius of UCA antenna array
0.5 (by default)
| positive scalar
Radius of UCA antenna array, positive scalar.
Dependencies
To use this parameter, set the Geometry parameter to UCA
.
Element positions (m) - positions of the conformal antenna array elements
[0;0;0] (by default)
| ` real matrix 3 by N`
The positions of the elements of a conformal antenna array, given as a 3-by-N matrix of real values, where N is the number of elements in the conformal array. Each column of this matrix represents the position [x;y;z] of the antenna array element 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 metres.
When the Specify sensor array as parameter is set to Replicated subarray
, this parameter is applied to each subarray.
Dependencies
To use this parameter, set the Geometry parameter to Conformal Array
.
Element normals (deg) - direction of the normal vectors of the conformal antenna array elements
[0;0] | `vector-column 2 by 1
| matrix 2 by N
The direction of the vectors of normals of the elements of a conformal antenna array, given as a 2-by-1 column vector or a 2-by-N matrix. N denotes the number of elements in the antenna array. For a matrix, each column specifies the direction of the normal of the corresponding element as [azimuth;elevation] with respect to the local coordinate system. In the local coordinate system, the positive x-axis coincides with the normal direction of the conformal antenna array. If the parameter value is a 2-by-1 column vector, the same pointing direction is used for all elements of the antenna array.
When the Specify sensor array as parameter is set to Replicated subarray
, this parameter is applied to each antenna subarray.
The Element positions (m) and Element normals (deg) parameters can be used to represent any arrangement in which pairs of elements differ from each other by certain transformations. These transformations may include translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation with respect to the direction of the normal.
Dependencies
To use this parameter, set the Geometry parameters to Conformal Array
.
Taper - change of directional pattern of antenna array elements
1 (by default)
| complex scalar
| complex vector
.
The change of the directivity diagram of the antenna array elements is specified as a complex scalar or complex vector 1 at , where is the number of antenna array elements.
The coefficients that change the directivity pattern, also called element weights, multiply the responses of the antenna array elements. The coefficients change both the amplitude and phase of the response to reduce side lobes or the direction of the main response axis.
If the value of the Taper parameters is a scalar, the same weight is applied to each element. If Taper is a vector, then the weight from the vector is applied to the corresponding antenna array element. The number of weights must correspond to the number of antenna array elements.
When the Specify sensor array as parameter is set to Replicated subarray
, this parameter is applied to each antenna subarray.
Subarray
Subarray definition matrix - determining whether elements belong to an antenna sublattice
`logic matrix
Set the antenna sublattice selection as a matrix to , where is the number of sublattices and 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 whether the element belongs to that sublattice. If the entry is zero, the element does not belong to the sublattice. A non-zero entry represents the complex weight 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 sublattice. The geometric centre of the sublattice depends on the sublattice definition matrix and Geometry parameters.
Dependencies
To use this parameter, set the Specify sensor array as parameters to Partitioned Array
.
Subarray steering method - sublattice beam steering method
None (by default)
| Phase
| Time
Sublattice steering method specified as:
-
None
. -
Phase
-
Time
Dependencies
To use this parameter, set the Specify sensor array as parameters to Partitioned Array
or Replicated subarray
.
Phase shifter frequency (Hz) - phase shift frequency of the antenna sub array
3.0e8 (by default)
| positive scalar
The operating frequency of the antenna sublattice phase shift, specified as a positive real scalar. The unit of measurement is Hz.
Dependencies
To use this parameter, set the Sensor array parameters to Partitioned array
or Replicated subarray
and set the Subarray steering method parameters to Phase
.
Number of bits in phase shifters - phase shift quantisation bits
0 (by default)
| non-negative integer
.
The antenna sublattice phase shift quantisation bits, specified as a non-negative integer. A value equal to zero means that quantisation is not performed.
Dependencies
To use this parameter, set the Sensor array parameter to Partitioned array
or Replicated subarray
and set the Subarray steering method parameter to Phase
.
Subarrays layout - antenna subarray layout
Rectangular (by default)
| Custom
Specify the layout of replicated antenna sublattices.
-
When
Rectangular
is set, the Grid size and Grid spacing parameters are used to position the antenna sub-arrays. -
When `Custom' is set, the Subarray positions (m) and Subarray normals parameters are used to position the antenna arrays.
Dependencies
To use this parameter, set the Sensor array parameters to Replicated subarray
.
Grid size - dimensions of the rectangular grid of antenna subarrays
[1,2] (By default)
.
Rectangular antenna sub-grid grid size specified as a single positive integer or a vector-string of positive integers 1 by 2.
-
If Grid size is an integer scalar, the antenna array has an equal number of sub-grids in each row and each column.
-
If Grid size is a 1-by-2 row vector of the form [NumberOfRows, NumberOfColumns], then the first variable is the number of sub-grids in each column. The second variable is the number of 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 URA 3 by 2 subgrids can be reproduced when the Grid size parameters is set to
[1,2]
.
Dependencies
To use this parameter, set the Sensor array 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 scalar
| positive real vector 1 by 2
The distance between antenna sublattices in a rectangular grid, specified as a positive real scalar or a 1-by-2 vector or Auto
. The units of measurement are metres.
If Grid spacing is a scalar, the distance between rows and columns is the same.
If Grid spacing is a 1 by 2 row vector, the vector is of the form [SpacingBetweenRows, SpacingBetweenColumn], the first variable specifies the row spacing along the column. The second variable is the spacing between columns along the row.
If the Grid spacing parameters are set to Auto
, replication preserves the spacing between subgrid elements for both rows and columns when building a full antenna array. This option is available only if ULA
or URA
is selected for the Geometry parameters.
Dependencies
To use this option, set the Sensor array parameters to Replicated subarray
and the Subarrays layout parameters to Rectangular
.
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 real matrix 3 by , where is the number of sub-arrays in the antenna array. Each column of the matrix represents the position of one sublattice in the local coordinate system of the antenna array. Coordinates are expressed as [x; y; z]. The units of measurement are metres.
Dependencies
To use this parameter, set the Sensor array parameter to Replicated subarray
and the Subarrays layout parameter to Custom
.
Subarray normals - direction of antenna subarrays normals
[0,0;0,0] (by default)
| ` real matrix 2 by N`
The direction of the antenna array sublattice normals. The value of this parameters is a matrix of size 2 by , where is the number of sublattices in the antenna array. Each column of the matrix specifies the direction of the normal of the corresponding sublattice in the form [azimuth;elevation]. The units of angles are degrees. The angles are defined relative to the local coordinate system.
The Subarray positions and Subarray normals parameters can be used to represent any arrangement in which pairs of antenna sublattices are distinguished by certain transformations. These transformations may include translation, azimuth rotation, and elevation rotation. However, transformations that require rotation with respect to the normal cannot be used.
Dependencies
To use this parameter, set the Sensor array parameter to Replicated subarray
and the Subarrays layout parameter to Custom
.