ESPRIT DOA
Direction of arrival (DOA) estimation of the signal using the ESPRIT algorithm for ULA.
Description
The ESPRIT DOA block estimates the arrival of a given number of narrowband signals incident on a uniform linear antenna array (ULA) using the ESPRIT algorithm.
Ports
Input
Port_1 - input signal
`complex matrix of size N by M
The input signal is a matrix of size by , where is the number of signal samples and is the number of channels.
Data types: Float16
, Float32
, Float64
, Int8
, Int16
, Int32
, Int64
, UInt8
, UInt16
, UInt32
, UInt64
, Bool
.
Support for complex numbers: Yes
Parameters
Main
Signal propagation speed - speed of signal propagation, m/c
3e8 (by default)
| positive scalar
Signal propagation speed as a real positive scalar. By default, the value of the speed of light is 3e8 m/c
.
The unit of measurement is m/s.
Operating frequency (Hz) - carrier frequency of the system
3e8 (By default)
| positive scalar
Carrier frequency of the system specified as a positive scalar. The unit of measurement is Hz.
Number of signals - number of signals
1 (By default)
| positive integer scalar
Number of signals as a positive integer scalar.
Spatial smoothing - enable spatial smoothing
0 (by default)
| non-negative scalar
.
Sets the number of (non-negative integer) averages that provide spatial smoothing for estimating the covariance matrix. Each increase in this parameters adds one additional coherent source, which in turn reduces the effective number of elements by one. The maximum value of this parameter is , where is the number of elements in the ULA.
Type of least squares method - selection of the type of least squares method
TLS (by default)
| LS
Specify the least squares method used for ESPRIT:
-
`TLS
is the least complete squares method. -
LS
- least squares method.
Forward-backward averaging - enable forward/backward averaging
off (by default)
| on
This parameters allows to set forward/backward averaging for estimation of covariance matrix for antenna array elements with conjugate-symmetric structure of elements.
Row weighting factor - row weighting factor
1 (by default)
| positive integer scalar
Row weighting factor for the eigenvectors of the signal subspace as a positive integer scalar. This parameter controls the weights applied to the selection matrices. In most cases, the higher the value, the better. However, the value can never be greater than , where is the number of antenna array elements.
Sensor Array
Specify sensor array as - method of specifying antenna array element
`Array (no subarrays) (by default)
Method of specifying the antenna array element.
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
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]. Outside this frequency range, the element has no response. Frequency 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 - consider radiation through the rear beam of the pattern to the rear hemisphere of the Isotropic Antenna
or Omni Microphone
element
Off (By default)
| `on
Select this check box 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 is defined as an azimuth angle of 0° and a location 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 emission
-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 is specified 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 antenna array elements
[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) - values of the antenna radiation pattern azimuth angles
[-180:180] (by default)
| real vector-string
The value of the azimuth angles for which the antenna radiation pattern will be calculated as a vector-string 1 on P. P must be greater than 2. The values of the azimuth angles shall lie in the range from −180° to 180° inclusive and shall 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 the antenna radiation 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 values of the angles of place must lie in the range from −90° to 90° inclusive and be arranged in strictly ascending order.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
and the Input Pattern Coordinate System parameter to az-el
.
Phi Angles (deg) - value of the Phi' angles of the antenna radiation pattern
`[0:360] (by default)
| ` real vector-string 1 on P`
`[0:360] (by default)
The value of the Phi
angles 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 Phi
angles 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) - value of the Theta
angles of the antenna radiation pattern
[0:180] (by default)
| real vector-string 1 on Q
The value of the Theta
angles 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 Theta
angles 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
The magnitude of the 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 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
, then is equal to the length of the vector specified by the Theta Angles (deg) parameter, and is equal to the length of the vector specified 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 , the same scheme is applied for all frequencies specified in the Operating frequency vector (Hz) parameter.
-
If the parameter is an array to to , each page to of the array specifies a pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.
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 of the radiation pattern of the combined antenna, given as a matrix to or an array to to .
-
If the Input Pattern Coordinate System parameter is set to
az-el
, then is equal to the length of the vector specified by the Elevation angles (deg) parameter, and 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
, then is equal to the length of the vector specified by the Theta Angles (deg) parameter, and is equal to the length of the vector specified 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 , the same scheme is applied for all frequencies specified in the Operating frequency vector (Hz) parameter.
-
If the parameter is an array to to , each page to of the array specifies a pattern for the corresponding frequency specified in the Operating frequency vector (Hz) parameter.
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 array normal. 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 is set to az-el
, checking this checkbox rotates the pattern so that the x-axis of the element coordinate system points along the array normal. 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
, checking this checkbox rotates the pattern so that the z-axis of the element coordinate system points along the array normal.
Use this parameter together with the Array Normal parameter of the URA and UCA arrays.
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 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 1 on . 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 radiation pattern in three-dimensional space.
Dependencies
To use this parameter, set the Element type parameters to Custom Microphone
.
ULA Parameters
Number of elements - number of array elements
2 (by default)
| an integer greater than or equal to 2
The number of array elements for ULA arrays, specified as an integer greater than or equal to 2.
Element spacing (m) - spacing between antenna array elements
0.5 (by default)
| positive scalar
.
The distance between neighbouring elements of the antenna array is specified as a positive scalar. The dimension is in metres.
Array axis - direction of linear axis of ULA
y (by default)
| x
| z
The direction of the ULA linear axis specified as y
, x
or z
. All elements of the ULA array are uniformly distributed along this axis in the local array coordinate system.
Dependencies
To enable this parameter, set the Geometry parameter to ULA. This parameter is also enabled when the block supports only ULA arrays.
Taper - change the pattern of the 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 by , where is the number of elements in the array.
The tapering coefficients, also called element weights, multiply the responses of the array elements. Cones 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 sensor element. The number of weights must correspond to the number of array elements.