URA SUM and Difference
Sum-difference monopulse tracker for URA.
Description
The URA Sum and Difference Monopulse block estimates the direction of arrival of a narrowband signal on a uniform rectangular array (URA) based on an initial assumption using the sum and difference method of the antenna pattern.
The block obtains the difference control vector by changing the phase of the second half of the summation control vector.
Ports
Input
X - received signal
`complex matrix
Input signal as a matrix, columns of which correspond to channels. The rows correspond to the signal samples.
Data types: Float16
, Float32
, Float64
, Int8
, Int16
, Int32
, Int64
, UInt8
, UInt16
, UInt32
, UInt64
.
Support for complex numbers: Yes
Steer - initialising signal
non-negative real vector-column (1, 1)
Initialising input signal as a non-negative real vector-column.
Data types: Float16
, Float32
, Float64
, Int8
, Int16
, Int32
, Int64
, UInt8
, UInt16
, UInt32
, UInt64
Output
Ang - directions of signals arrival
`non-negative real vector column
Signal arrival directions returned as a non-negative real vector-column. The angle of the direction of arrival is the angle between the direction to the source and the antenna array axis. The units of the angle are degrees. The length of the vector is equal to the number of signals specified by the Number of signals parameters. If the peaks in the spectrum cannot be detected, the result returns NaN
.
Data types: Float16
, Float32
, Float64
, Int8
, Int16
, Int32
, Int64
, UInt8
, UInt16
, UInt32
, UInt64
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 299792458 m/s
.
The unit of measurement is m/s.
The physconst function can be used to specify the speed of light.
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
.
Number of bits in phase shifters - number of bits of phase shift quantisation
`0 (by default) | non-negative integer `
Number of bits used to quantise the phase shift component of the beamformer or control vector weights. Specify the number of bits as a non-negative integer.
A value equal to zero means that quantisation is not performed.
Sensor Array
Specify sensor array as - method of specifying an array
Array (no subarrays)
Method of specifying the array specified as Array (no subarrays)
.
-
Array (no subarrays)
- block parameters are used to set the array.
Element
Element type - array element types
Isotropic Antenna (by default)
| Cardioid Antenna
| Cosine Antenna
| Custom Antenna
| Gaussian Antenna
| Sinc Antenna
| Omni Microphone
| Custom Microphone
Type of antenna or acoustic element.
Available values:
-
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-string 1 by 2 `
The operating frequency range of an antenna or acoustic element as a 1-by-2 string vector in the form [LowerBound,UpperBound]
. Outside this frequency range, the element has no response.
The unit of frequency measurement is 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 - 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 use this parameter, set the Element type parameters to Isotropic Antenna
or Omni Microphone
.
Null axis direction - the direction of the null axis.
-x (By default)
| +x
| +y
| -y
| +z
| -z
.
Zero radiation axis direction.
Dependencies
To use this parameter, set the Element type parameters to Cardioid Antenna
.
Exponent of cosine pattern - set the exponents of azimuthal and altitude cosine patterns
[1.5 1.5] (by default)
| non-negative scalar
| real matrix of non-negative values 1 by 2
The exponents 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 in the azimuth direction and the second in the elevation direction. When this parameters is scalar, the cosines in the azimuth and elevation directions are raised to one degree.
Dependencies
To use this parameter, set the Element type parameters to Cosine Antenna
.
Operating frequency vector (Hz) is the operating frequency range of the user’s antenna or acoustic element
[0,1e20] (By default)
| real vector string
The operating frequency range of the antenna or acoustic 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 unit of frequency measurement is 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 and acoustic element
[0,0] (By default)
| real vector-string
.
Frequency response of the user antenna or user acoustic element for frequencies defined 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 - the coordinate system of the custom antenna pattern
az-el (by default)
| phi-theta
.
The user antenna pattern coordinate system is specified by az-el
or phi-theta
. When az-el is specified, the parameters Azimuth angles (deg) and Elevations angles (deg) are used to specify the coordinates of the 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 angles from which the antenna radiation pattern will be calculated as a vector-string 1 to P. P must be greater than 2. The azimuth angles must lie in the range from −180° to 180° inclusive, and must 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) - the elevation angles of the antenna radiation pattern
[-90:90] (by default)
| real vector-string
.
The elevation 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. Elevation angles must lie in the range from −90° to 90° 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
.
Magnitude pattern (dB) is the magnitude of the radiation pattern of the combined 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 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 - rotate the antenna element to the array normal position
On (by default)
| Off
If the value of parameters on
, the antenna element pattern is rotated to align with the array normal. If disabled
, 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) - angles of the radiation pattern solution
[10, 10] (by default)
| real scalar
| real vector-string 1 by 2
Angles of the beamwidth pattern solution in degrees.
Dependencies
To use this parameter, set the Element type parameters to Gaussian Antenna
or Sinc Antenna
.
Polar pattern frequencies (Hz) - frequencies of the acoustic polar pattern response element
1e3 (By default)
| real scalar
| real vector-string 1 on L
The response frequencies of a polar pattern acoustic element, given as a real scalar or real vector-string 1 on . The response 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) - polar pattern response angles
[-180:180] (By default)
| `real vector string 1 on P'.
Set the response angles of the polar radiation pattern as vector-string 1 at . The angles are measured from the centre axis of the acoustic element 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 characteristic of the custom acoustic element
zeros(1,361) (by default)
| `real vector string 1 to L'.
Set the polar pattern magnitude of the custom acoustic element as a real vector-string 1 by , where is the number of frequencies specified in the Polar pattern frequencies (Hz) parameter. 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 elevation angle 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, it is possible to construct the directivity diagram of an acoustic element in three-dimensional space.
Dependencies
To use this parameter, set the Element type parameters to Custom Microphone
.
URA
Array size - array size
[2 2] (by default)
| ` positive integer` | ` vector of positive integers 1 by 2`
Specify the size of the array as a positive integer or a vector of 1 by 2 positive integers.
-
If the value of the Array size parameters is a 1-by-2 vector, the vector is
[NumberOfArrayRows,NumberOfArrayColumns]
. -
If the value of the Array size parameter is an integer, the array has the same number of rows and columns.
Elements are indexed from top to bottom by column and then by next columns from left to right.
In this figure, if the array size is [3,2]
, the array has three rows and two columns.
Element spacing (m) - distance 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 unit of measurement is m.
Element lattice - type of element lattice
Rectangular (by default)
| Triangular
Specify the element lattice as Rectangular
or Triangular
.
-
If Element lattice parameters are set to
Rectangular
- all elements are aligned in row and column direction. -
If the Element lattice parameters is set to
Triangular
- elements of even rows of the rectangular lattice are shifted in the direction of the positive axis of the row. The elements are shifted by a distance equal to half of the distance between the elements in the row.
Array normal - direction of the normal of the URA array
x (by default)
| y
| z
Specify the normal of the array as x
, y
or z
. All elements of the arrays URA and UCA are placed in the yz, zx or xy planes, respectively, in the array coordinate system.
Taper - change of directivity diagram 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 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.