URA SUM and Difference
Total-difference monopulse tracker for URA.
blockType: URASUMandDifference
Path in the library:
|
Description
The URA Sum and Difference Monopulse block evaluates the direction of arrival of a narrowband signal to a uniform rectangular array (URA) based on an initial assumption using the sum-difference method of the antenna radiation pattern.
The block obtains a difference control vector by changing the phase of the second half of the total control vector.
Ports
Entrance
X — received pass signal:q[<br>]complex matrix
The input signal is in the form of a matrix, the columns of which correspond to the 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 — initializing signal
non-negative real column vector (1, 1)
Initializing the input signal in the form of a non-negative real column vector.
Data types: Float16
, Float32
, Float64
, Int8
, Int16
, Int32
, Int64
, UInt8
, UInt16
, UInt32
, UInt64
Output
Ang — directions of arrival of pass signals:q[<br>] non-negative real column vector
The arrival directions of the signals returned as a non-negative real column vector. The angle of the arrival direction is the angle between the direction of the source and the axis of the antenna array. The angle measurement units are degrees. The length of the vector is equal to the number of signals specified by the Number of signals parameter. If it is not possible to detect peaks in the spectrum, NaN
is returned as a result.
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 (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.
You can use the physconst function 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 (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
Number of bits in phase shifters — number of phase shift quantization bits
0 (default) | non-negative integer
The number of bits used to quantize the phase shift component of the beamformer or the weights of the control vector. Specify the number of bits as a non-negative integer.
A value of zero means that quantization is not performed.
Sensor Array
Specify sensor array as — method for specifying the pass array:q[<br>] Array (no subarrays)
The method for setting the array specified as `Array (no subarrays)'.
-
`Array (no subarrays)'— the block parameters are used to specify the array.
Element
Element type — types of elements of the pass array:q[<br>] Isotropic Antenna (default)
| Cardioid Antenna
| Cosine Antenna
| Custom Antenna
| Gaussian Antenna
| Sinc Antenna
| Omni Microphone
| Custom Microphone
The 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) — operating frequency range of the antenna or acoustic element
[0 1e20] (default) | real vector-string 1 by 2
The range of operating frequencies of an antenna or acoustic element in the form of a 1-by-2 row vector in the form of `[LowerBound,UpperBound]'. Outside of this frequency range, the element has no response.
The units of frequency measurement are Hz.
Dependencies
To use this parameter, set the Element type parameter to Isotropic Antenna
, Cosine Antenna
, or 'Omni Microphone'.
Baffle the back of the element — set the response of the rear hemisphere of the Isotropic Antenna element
or Omni Microphone
to zero
disabled (by 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 use this parameter, set the Element type parameter to Isotropic Antenna
or `Omni Microphone'.
Null axis direction — the direction of the zero radiation axis.
-x (default)
| +x
| +y
| -y
| +z
| -z
The direction of the zero radiation axis.
Dependencies
To use this parameter, set the Element type parameter to Cardioid Antenna
.
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 non-negative values of 1 by 2
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. With a scalar value of this parameter, the cosines in the azimuthal and elevation directions are raised to one power.
Dependencies
To use this parameter, set the Element type parameter to Cosine Antenna
.
Operating frequency vector (Hz) — operating frequency range of a custom antenna or acoustic element
[0,1e20] (default)
| real vector is a string
The range of operating frequencies of the antenna or acoustic element in the form of a vector row 1 on increasing actual values. The element has no response beyond the frequency range specified 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 parameter to Custom Antenna
or `Custom Microphone'. To set the responses at these frequencies, use the Frequency responses (dB) parameter.
Frequency responses (dB) — frequency responses of the antenna and the acoustic element
[0,0] (default)
| real vector string
The frequency response of a custom antenna or custom acoustic element for frequencies defined by the parameter Operating frequency vector (Hz). The dimensions of the Frequency responses (dB) vector must match the dimensions of the vector specified by the Operating frequency vector (Hz) parameter.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
or `Custom Microphone'.
Input Pattern Coordinate System — the coordinate system of the radiation pattern of the user antenna
az-el (default)
| phi-theta
The coordinate system of the radiation pattern of the user antenna is indicated by az-el
or phi-theta'. When specifying `az-el
, the Azimuth angles (deg) and Elevations angles (deg) parameters are used to set the coordinates of the points of the directional pattern. When specifying the phi-theta
parameter, the Phi angle (deg) and Theta angles (deg) parameters are used to set the coordinates of the part points.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
.
Azimuth angles (deg) — azimuth angles of the antenna radiation pattern
[-180:180] (default)
| real vector is a string
Azimuth angles, which will be used to calculate the radiation pattern of the antenna in the form of a vector-row 1 on P. P must be greater than 2. The azimuth angles must be in the range of −180° up to 180° inclusive and 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
.
Elevation angles (deg) — elevation angles of the antenna radiation pattern
[-90:90] (default)
| real vector is a string
Elevation angles at which it is necessary to calculate the radiation pattern in the form of a vector 1 on . it must be more than 2. The units of measurement of angles are degrees. Elevation angles should be in the range of −90° to 90° inclusive and 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
.
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, set 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 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 — the length of the vector specified by the Phi Angles (deg) parameter.
Value is equal to the value of the Operating frequency vector (Hz) parameter.
-
If the value of this parameter is a matrix on , then the same scheme is applied for all frequencies specified in the parameter Operating frequency vector (Hz).
-
If the parameter is an array on on , then each page on The array specifies a template for the corresponding frequency specified in the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
.
Phase pattern (deg) — phase of the radiation pattern of the user antenna
zeros(181,361) (default)
| real matrix Q on P
| real array Q on P on L
The phase of the radiation pattern of the combined antenna, set 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 specified by the Elevation angles (deg) parameter, and — 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 — the length of the vector specified by the Phi Angles (deg) parameter.
Value is equal to the value of the Operating frequency vector (Hz) parameter.
-
If the value of this parameter is a matrix on , then the same scheme is used for all frequencies specified in the parameter Operating frequency vector (Hz).
-
If the parameter is an array on on , then each page on The array defines a template for the corresponding frequency specified in the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
.
Align element normal with array normal — rotate the antenna element to the normal position of the array
enabled (by default)
| disabled
If the parameter value is enabled
, the radiation pattern of the antenna element is rotated to align with the normal of the array. If it is off
, then the drawing of the element does not rotate.
If the antenna is used in an antenna array and the Input Pattern Coordinate System parameter has the value az-el
, checking this box rotates the radiation pattern so that the x-axis of the element coordinate system points along the normal of the array. If there is no selection, the element template is used without rotation.
If the antenna is used in an antenna array and the Input Pattern Coordinate System parameter has the value phi-theta
, checking this box rotates the radiation pattern so that the z axis of the element coordinate system points along the normal of the array.
Use this parameter together with the Array Normal parameter of the URA and UCA arrays.
Dependencies
To use this parameter, set the Element type parameter to Custom Antenna
.
Radiation pattern beamwidth (deg) — angles of the radiation pattern solution
[10, 10] (default)
| real scalar
| a real vector is a 1 by 2 row
The angles of the radiation pattern solution in degrees.
Dependencies
To use this parameter, set the Element type parameter to Gaussian Antenna
or `Sinc Antenna'.
Polar pattern frequencies (Hz) — frequencies of the acoustic response element of the polar radiation pattern
1e3 (default)
| real scalar
| real vector-row 1 on L
The response frequencies of an acoustic element with a polar radiation pattern, specified as a real scalar or a real vector, are lines 1 on . The response frequencies are in the frequency range specified by the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set the Element type parameter to Custom Microphone
.
Polar pattern angles (deg) — response angles of the polar radiation pattern
[-180:180] (default)
| real vector is row 1 on P
Set the response angles of the polar radiation pattern as a vector of 1 to . The angles are measured from the central axis of the acoustic element and must be in the range of −180° to 180° inclusive.
Dependencies
To use this parameter, set the Element type parameter to Custom Microphone
.
Polar pattern (dB) — polar characteristic of the custom acoustic element
zeros(1,361) (default)
| real vector-row 1 on L
Set the value of the polar radiation pattern of the user acoustic element in the form of a real vector-row 1 on , where — the number of frequencies specified in the parameter Polar pattern frequencies (Hz). The string represents the value of the polar radiation pattern measured at the corresponding frequency specified in the Polar pattern frequencies (Hz). The radiation pattern is measured in the azimuthal plane. In the azimuthal plane, the elevation angle is 0°, and the central axis is 0° in azimuth and 0° in elevation. The polar radiation pattern is symmetrical around the central axis. Based on the polar diagram, it is possible to construct a directional diagram of an acoustic element in three-dimensional space.
Dependencies
To use this parameter, set the Element type parameter to Custom Microphone
.
URA
Array size — the size of the pass array:q[<br>][2 2] (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 parameter is a 1 by 2 vector, then the vector has the form
[NumberOfArrayRows,NumberOfArrayColumns]
. -
If the value of the Array size parameter is an integer, then the array has the same number of rows and columns.
The elements are indexed from top to bottom in the column and then in the following columns from left to right.
In this figure, with the size of the array [3,2]
, the array has three rows and two columns.
Element spacing (m) — the distance between the elements of the antenna array
0.5 (default)
| positive scalar
The distance between adjacent elements of the antenna array is set as a positive scalar.
The units of measurement are m.
Element lattice — view of the lattice of pass elements:q[<br>]Rectangular (default)
| Triangular
Specify the grid of elements as Rectangular
or `Triangular'.
-
If the Element lattice parameter is set to
Rectangular
, all elements are aligned in the direction of rows and columns. -
If the Element lattice parameter is set to
Triangular
, the elements of the even rows of the rectangular grid are shifted in the direction of the positive axis of the row. The elements are shifted by a distance equal to half the distance between the elements in the row.
Array normal — direction of the URA pass array normal:q[<br>] x (default)
| y
| z
Specify the normal of the array as x
, y
, or `z'. All elements of the URA and UCA arrays are placed in the yz, zx or xy planes, respectively, in the coordinate system of the array.
Taper — changing the radiation pattern of the elements of the antenna array
1 (default)
| complex scalar
| complex vector
The change in the radiation pattern of the antenna array elements is set as a complex scalar or a complex vector 1 by , where — the number of elements in the array.
The narrowing coefficients, also called element weights, multiply the responses of the array elements. The cones change both the amplitude and the phase of the response to reduce the side lobes or the direction of the main axis of the response.
If the value of the Taper parameter is a scalar, then the same weight is applied to each element. If Taper is a vector, then a weight from the vector is applied to the corresponding sensor element. The number of weights must match the number of array elements.