Steering Vector
The control vector of antenna elements.
blockType: SteeringVector
Path in the library:
|
Description
Block Steering Vector calculates the control vector of the antenna elements for the specified directions and frequencies.
Ports
Input
#
FREQ
—
antenna array operating frequency
scalar
Details
The operating frequency, set as a positive scalar.
The units of measurement are Hz.
Dependencies
To use this port, set the Source of operating frequency parameter to `Input port'.
| Data types |
|
| Complex numbers support |
No |
#
ANG
—
vector direction
vector | array
Details
The directions of the control vector, defined as a real vector of length or the real matrix 2 on , where – this is the number of management directions.
-
If ANG is a 2 matrix on , then each column of the matrix defines a direction in space in the form of
[azimuth; elevation]. The azimuth angle should be between -180° and 180°, and the elevation angle should be between -90° and 90°. -
If ANG is a vector of length its values correspond to the azimuth angles of the rudder direction vector, and the elevation angles are set to zero.
The units of measurement are degrees.
| Data types |
|
| Complex numbers support |
No |
Output
#
SV
—
control vector
array
Details
The control vector returned as a complex array on on or a structure containing arrays. Here is the number of antenna array elements, if the antenna array contains sublattices, then – this is the number of sublattices, – this is the number of directions of the control vector, – this is the number of operating frequencies.
| Data types |
|
| Complex numbers support |
Yes |
Parameters
Main
#
Signal propagation speed (m/s) —
signal propagation speed
Real number
Details
The propagation velocity of the signal in the form of a real positive scalar.
The default value is the speed of light.
The units of measurement are m/s.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Source of operating frequency —
operating frequency source
Property | Input port
Details
Operating frequency source: Input port or Property.
If the parameter is set to Input port, then the operating frequency is set via the input port FREQ.
If the parameter is set to Property, then the operating frequency is set using the parameter Operating frequency (Hz).
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Operating frequency (Hz) —
Operating frequency of the system
Real number
Details
The operating frequency of the system, set as a positive scalar.
The units of measurement are Hz.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Output conjugated steering vector —
output of the conjugate control vector
Logical
Details
Select this option to display the conjugate control vector. Otherwise, the control vector will not be conjugate.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Number of bits in phase shifters —
number of phase shift quantization bits
Real number
Details
The number of bits used to quantize the phase shift component of the beamforming vector or control vector weights. Specify the number of bits as a non-negative integer. A value of zero means that quantization is not performed.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
Main
#
Specify sensor array as —
the method of setting the antenna array
Array (no subarrays)
Details
The method of setting the antenna array.
Available values:
-
Array (no subarrays)
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
Element
#
Element type —
type of antenna array element
Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone
Details
The type of antenna or microphone.
Available values:
-
Isotropic Antenna -
Cardioid Antenna -
Cosine Antenna -
Custom Antenna -
Gaussian Antenna -
Sinc Antenna -
Omni Microphone -
Custom Microphone
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Operating frequency vector (Hz) —
The operating frequency range of the user antenna or microphone
Vector / matrix of real numbers
Details
The range of operating frequencies of the antenna or microphone in the form of a vector row 1 on . Outside of this frequency range, the element has no response.
The units of frequency measurement are Hz.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna or Custom Microphone. Use the parameter Frequency responses (dB) to adjust the responses at these frequencies.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Frequency responses (dB) —
frequency response of antenna and microphone
Vector / matrix of real numbers
Details
Frequency response of the user antenna or user microphone for frequencies defined by the parameter Operating frequency vector (Hz). Vector dimensions Frequency responses (dB) must match the size of the vector specified by the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna or Custom Microphone.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Input pattern coordinate system —
the coordinate system of the directional pattern of the user antenna
az-el | phi-theta
Details
The coordinate system of the directional pattern of the user antenna is specified az-el or phi-theta. When specifying az-el to set the coordinates of the points of the directional pattern, the following parameters are used Azimuth angles (deg) and Elevation angles (deg). When specifying a parameter phi-theta to set the coordinates of the points of the directional pattern, the following parameters are used Phi angles (deg) and Theta angles (deg).
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna.
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Azimuth angles (deg) —
azimuth angles of the antenna radiation pattern
Vector / matrix of real numbers
Details
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 for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate system — az-el.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Elevation angles (deg) —
The angles of the antenna radiation pattern
Vector / matrix of real numbers
Details
The angles of the location 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. The angles of the seat should be in the range of −90° to 90° inclusive and arranged in strictly ascending order.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate system — az-el.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Phi angles (deg) —
the values of the Phi angles of the antenna pattern
Vector / matrix of real numbers
Details
The angular coordinates of the Phi points where the antenna radiation pattern is set. They are defined as a real vector string on . There should be more 2. The units of measurement of angles are degrees. The values of the Phi angles must be in the range of 0° before 360° and be arranged in strictly ascending order.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate system — phi-theta.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Theta angles (deg) —
the values of the angles of the Theta radiation pattern of the antenna
Vector / matrix of real numbers
Details
The angular coordinates of the Theta points where the antenna radiation pattern is set. They are defined as a real vector string on . There should be more 2. The units of measurement of angles are degrees. The values of the Theta angles must be in the range of 0° before 180° and be arranged in strictly ascending order.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna, and for the parameter Input pattern coordinate system — phi-theta.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Magnitude pattern (dB) —
the magnitude of the radiation pattern of the combined antenna
String
Details
The value of the radiation pattern of the combined antenna, set as a matrix on or an array on on .
-
If for the parameter Input pattern coordinate system the value is set
az-el, then Q is equal to the length of the vector specified by the parameter Elevation angles (deg), and P is the length of the vector specified by the parameter Azimuth angles (deg). -
If for the parameter Input pattern coordinate system the value is set
phi-thetaThen 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 parameter Operating frequency vector (Hz).
-
If the value of this parameter is a matrix on , then for all frequencies specified in the parameter Operating frequency vector (Hz), the same scheme applies.
-
If the parameter is an array on on , then each page on The array sets the radiation pattern for the corresponding frequency specified in the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Phase pattern (deg) —
user antenna radiation phase diagram
String
Details
The phase radiation pattern of the combined antenna, defined as a matrix on or an array on on .
-
If for the parameter Input pattern coordinate system the value is set
az-elThen is equal to the length of the vector specified by the parameter Elevation angles (deg), and — the length of the vector specified by the parameter Azimuth angles (deg). -
If for the parameter Input pattern coordinate system the value is set
phi-thetaThen 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 parameter Operating frequency vector (Hz).
-
If the value of this parameter is a matrix on , then for all frequencies specified in the parameter Operating frequency vector (Hz), the same scheme applies.
-
If the parameter is an array on on , then each page on The array sets the radiation pattern for the corresponding frequency specified in the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Align element normal with array normal —
rotating the antenna element to the normal position of the antenna array
Logical
Details
If this option is selected, the antenna element’s radiation pattern rotates to align with the antenna array. If the checkbox is unchecked, the directional pattern of the element does not rotate.
If the antenna is used in the antenna array and the parameter Input pattern coordinate system it matters az-el If this flag is selected, the radiation pattern rotates so that the x-axis of the element’s coordinate system points along the normal to the antenna array. If there is no choice, the directional pattern of the element without rotation is used.
If the antenna is used in the antenna array and the parameter Input pattern coordinate system it matters phi-theta, setting this flag rotates the radiation pattern so that the axis The coordinate system of the element was pointed along the normal to the antenna array.
Use this parameter together with the parameter Array normal antenna arrays URA and UCA.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Antenna.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Polar pattern frequencies (Hz) —
response frequencies of a microphone with a polar pattern
Real number
Details
The response frequencies of a microphone with a polar pattern, specified as a real scalar or a real vector string on . The response frequencies are in the frequency range specified by the parameter Operating frequency vector (Hz).
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Microphone.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Polar pattern angles (deg) —
response angles of the polar radiation pattern
Vector / matrix of real numbers
Details
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 microphone and should be in the range of −180° to 180° inclusive.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Microphone.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Polar pattern (dB) —
polar pattern of the user microphone
Vector / matrix of real numbers
Details
Set the value of the polar radiation pattern of the user microphone as 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 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 microphone directional pattern in three-dimensional space.
Dependencies
To use this parameter, set for the parameter Element type meaning Custom Microphone.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Operating frequency range (Hz) —
the operating frequency range of the antenna or microphone
Array of real numbers
Details
The operating frequency range of the antenna or microphone in the form of a vector is a 1 by 2 row in the form [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 for the parameter Element type meaning Isotropic Antenna, Cosine Antenna or Omni Microphone.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Radiation pattern beamwidth (deg) —
angles of the radiation pattern solution
Scalar / array of real numbers
Details
The angles of the radiation pattern solution in degrees.
Dependencies
To use this parameter, set for the parameter Element type meaning Gaussian Antenna or Sinc Antenna.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Null axis direction —
direction of the zero radiation axis
String
Details
The direction of the zero radiation axis.
Dependencies
To use this parameter, set for the parameter Element type meaning Cardioid Antenna.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Exponent of cosine pattern —
setting the azimuthal and altitude cosine radiation patterns indicator
Scalar / array of real numbers
Details
The exponents of the cosine radiation pattern are in the form of a non-negative scalar or a 1 by 2 real matrix of non-negative values.
If Exponent of cosine pattern If the vector is 1 by 2, then the first element is an indicator in the direction of the azimuth, and the second is in the direction of the location. 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 for the parameter Element type meaning Cosine Antenna.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Baffle the back of the element —
set a response Isotropic Antenna or Omni Microphone equal to zero
Logical
Details
Select this option to mute the response of the element.
When the response is suppressed at all azimuth angles exceeding ± 90° from the wide side, the responses are 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 for the parameter Element type meaning Isotropic Antenna or Omni Microphone.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
Array
#
Geometry —
geometry of the antenna array
ULA | URA | UCA | Conformal array
Details
The geometry of the antenna array, defined as:
-
ULA— uniform linear antenna array. -
URA— uniform rectangular antenna array. -
UCA— uniform circular antenna array. -
Conformal array— arbitrary arrangement of elements.
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Number of elements —
number of elements of the ULA or UCA antenna array
Real number
Details
The number of antenna array elements for ULA or UCA, set as an integer greater than or equal to 2.
Dependencies
To use this parameter, set for the parameter Geometry meaning ULA or UCA.
| Default value |
|
| Program usage names |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Radius of UCA (m) —
the radius of the UCA antenna array
Real number
Details
The radius of the UCA antenna array, a positive scalar.
Dependencies
To use this parameter, set for the parameter Geometry meaning UCA.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Array size —
URA antenna array dimensions
Scalar / array of real numbers
Details
The dimensions of the URA antenna array, specified as a positive integer or a vector of positive integers 1 by 2.
-
If the size of the antenna array is a 1 by 2 vector, then the vector has the form [NumberOfArrayRows, NumberOfArrayColumns].
-
If the size of the antenna array is an integer, then the array has the same number of rows and columns.
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. The figure shows an antenna array for which the parameter Array size it matters [3,2], that is, it has three rows and two columns.
Dependencies
To use this parameter, set for the parameter Geometry meaning URA.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Element spacing (m) —
the distance between the elements of the antenna array
Scalar / array of real numbers
Details
The distance between adjacent elements of the ULA or URA lattices in the form of a positive scalar.
Dependencies
To use this parameter, set for the parameter Geometry meaning ULA or URA.
| Default value |
|
| Program usage names |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Array axis —
direction of the ULA linear axis
x | y | z
Details
The direction of the ULA linear axis, defined as y, x or z. All elements of the ULA antenna array are evenly distributed along this axis in the local grid coordinate system.
Dependencies
To use this parameter, set for the parameter Geometry meaning ULA.
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Element lattice —
grid of URA element positions
Rectangular | Triangular
Details
A grid of URA element positions, defined as rectangular or triangular.
-
Rectangular— aligns all elements into rows and columns. -
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 along the dimension of the row.
Dependencies
To use this parameter, set for the parameter Geometry meaning URA.
| Values |
|
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
No |
#
Array normal —
URA or UCA antenna array normal direction
x | y | z
Details
The direction of the antenna array normal, set as x, y or z.
The elements of the flat arrays 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 direction of the antenna array normal.
-
x— the elements of the antenna array lie in the yz-plane. The angular coordinate vectors of all elements are directed along the x-axis. -
y— the antenna array elements lie in the zx plane. The angular coordinate vectors of all elements are directed along the y axis. -
z— the elements of the antenna array lie in the xy-plane. The angular coordinate vectors of all elements are directed along the z axis.
Dependencies
To use this parameter, set for the parameter Geometry meaning URA or UCA.
| Values |
|
| Default value |
|
| Program usage names |
|
| Tunable |
No |
| Evaluatable |
No |
#
Element positions (m) —
positions of the elements of the conformal antenna array
Array of real numbers
Details
The positions of the elements of the conformal antenna array, given as a matrix of real values 3 on , where — the number of elements in the conformal lattice. Each column of this matrix represents the position [x;y;z] of an element of the antenna array 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 m.
Dependencies
To use this parameter, set for the parameter Geometry meaning Conformal array.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Element normals (deg) —
the direction of the normal vectors of the elements of the conformal antenna array
Array of real numbers
Details
The direction of the normal vectors of the elements of the conformal antenna array, defined as a 2-by-1 column vector or a 2-by-1 matrix , where indicates the number of elements in the antenna array. For the matrix, each column sets the direction of the normal of the corresponding element in the form [azimuth;elevation] relative to the local coordinate system. In the local coordinate system, the positive axis is coincides with the direction of the normal to the conformal antenna array. If the parameter value is a 2-by-1 column vector, then the same pointing direction is used for all elements of the antenna array.
Parameters Element positions (m) and Element normals (deg) It can be used to represent any arrangement in which pairs of elements differ from each other by certain transformations. These transformations can include translation, azimuth rotation, and elevation rotation. However, transformations that require rotation relative to the normal direction cannot be used.
Dependencies
To use this parameter, set for the parameter Geometry meaning Conformal array.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |
#
Taper —
complex weighting coefficients for amplitude weighing
Scalar / array of real and/or complex numbers
Details
Complex weighting coefficients for antenna array elements, given as a complex scalar, a complex string vector on or a complex column vector on , where It represents the number of antenna array elements. Weighting factors are applied to each antenna element of the antenna array and change the amplitude and phase of the received data.
-
If Taper – scalar, the same coefficient value is applied to all elements of the antenna array.
-
If Taper – a vector, its own coefficient value is applied to each element of the antenna array.
| Default value |
|
| Program usage name |
|
| Tunable |
No |
| Evaluatable |
Yes |