EngeePhased.ReplicatedSubarray
A phased array antenna formed from copies of antenna sublattices.
| Library |
|
Description
System object EngeePhased.ReplicatedSubarray It is a phased array antenna containing copies of antenna sublattices. Antenna sublattices are created by copying a single preset antenna array.
To create and use an antenna array formed from copies of antenna sublattices, follow these steps:
-
Create an object EngeePhased.ReplicatedSubarray and set its properties.
-
Call the object with arguments as if it were a function.
To learn more about how to work with system objects, see Engee System Objects.
Syntax
Creation
-
array = EngeePhased.ReplicatedSubarray()— creates an antenna array formed from copies of antenna sublattices, with default property values. -
array = EngeePhased.ReplicatedSubarray(Name=Value)— creates an antenna array formed from copies of antenna sublattices, with specified properties in the form of a pairName=Value, whereName— the name of the property, andValue— the appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their default values.
Using
-
RESP = array(FREQ,ANG,V)— returns the radiation pattern RESP of antenna sublattices at the operating frequencies FREQ in the directions ANG. The phase center of each antenna sublattice is located in its geometric center. V is the propagation velocity. The elements in each antenna sublattice are connected to the phase center of the sublattice according to a scheme with alignment of transmission line lengths. -
RESP = array(FREQ,ANG,V,STEERANGLE)— uses the value of the input argument STEERANGLE as the direction of rotation of the antenna sublattice. This syntax is available if the SubarraySteering property is set to"Phase"or"Time". -
RESP = array(FREQ,ANG,V,WS)— uses the value of the input argument WS as the weighting coefficients of the antenna sublattice elements. This syntax is available if the SubarraySteering property is set to"Custom".
Arguments
Input arguments
FREQ — the operating frequencies of the antenna array
+
vector is a string of length L
Details
The operating frequencies of the antenna array, set as a real vector, are strings of length containing positive numbers. Typical values are in the range specified by the properties of the FrequencyRange or FrequencyVector element, depending on the type of element in the antenna array. The element has a zero radiation pattern at frequencies outside this range.
The units of measurement are Hz.
| Типы данных |
|
ANG — azimuth angle and angle of the radiation pattern
+
vector is a string of length M | the 2 by M matrix
Details
The directions of the radiation pattern, specified as a real vector, are strings of length or a real matrix on .
If ANG is a matrix, then each column defines a direction in the form [azimuth; elevation]. The azimuthal angle should be in the range of −180° before 180° inclusive. The angle of the seat should be in the range of −180° before 180° inclusive.
If ANG is a string vector, each element sets the azimuth angle of the direction. In this case, the corresponding seat angle is assumed to be 0°.
The units of measurement are degrees.
| Типы данных |
|
V — signal propagation speed
+
positive scalar
Details
The propagation velocity of the signal, set as a positive scalar.
The units of measurement are m/s.
| Типы данных |
|
STEERANG — angle of rotation of the antenna sublattice
+
the real vector is 2 by 1
Details
The angle of rotation of the antenna sublattice, set as a column vector of length . The vector has the form [azimuthAngle;elevationAngle]. The azimuth angle should be in the range of &minus180;° before 180° inclusive. The angle of the seat should be from −90° before 90° inclusive.
The units of measurement are degrees.
Dependencies
To use this argument, set the SubarraySteering property to "Phase" or "Time".
| Типы данных |
|
WS — weight coefficients of antenna sublattice elements
+
the complex matrix NSE on N
Details
The weighting coefficients of the antenna sublattice elements, specified as a complex matrix on , where — the number of elements in the antenna sublattice, and — the number of antenna sublattices.
Dependencies
To use this argument, set the SubarraySteering property to "Custom".
| Типы данных |
|
| Support for complex numbers |
yes |
Output arguments
RESP — antenna array radiation pattern
+
a complex array of N by M by L
Details
The radiation pattern of the antenna array, returned as a complex array of the size on on , where — the number of elements in the antenna array, — the number of angles specified in ANG, — the number of frequencies specified in FREQ.
Features
# Subarray — antenna sublattice for copying
+
ULA (by default) | antenna array system object
Details
An antenna sublattice for copying, specified as a system object of one of the following types:
-
system object EngeePhased.ULA;
-
system object EngeePhased.URA;
-
system object EngeePhased.UCA;
-
system object EngeePhased.ConformalArray.
# Layout — arrangement of antenna sublattices
+
"Rectangular" (by default) | antenna array system object
Details
The location of the replicated antenna sublattices, defined as "Rectangular" or "Custom".
# GridSize — the size of the rectangular grid
+
[1 2] (by default) | a positive integer | vector of positive integers 1 by 2
Details
The size of a rectangular grid set as a positive integer or vector is a string of two positive integers.
If the GridSize property is set to a scalar value, then the antenna array has the same number of antenna sublattices in each row and each column.
If the GridSize property is set to a vector value, it looks like [NumberOfRows, NumberOfColumns]. Element NumberOfRows This is the number of antenna sublattices along each column. Element NumberOfColumns this is the number of antenna sublattices in each row. The line is positioned along the local axis , and the column is along the local axis .
This figure shows how an URA-sized antenna sublattice is copied. on if GridSize is set to [1,2].
Dependencies
To use this property, set the Layout value "Rectangular".
# GridSpacing — the distance between rectangular grids
+
"Auto" (by default) | positive scalar | The positive real vector is 1 by 2
Details
The distance between rectangular grids of antenna sublattices, defined as a positive real scalar vector on or "Auto".
The units of distance between the grids are m.
If the GridSpacing property is set to a scalar, the distance between rows and columns is the same.
If a vector is set for the GridSpacing property on , then it has the form [SpacingBetweenRows, SpacingBetweenColumn]. Element SpacingBetweenRows sets the distance between rows along the column. Element SpacingBetweenColumn sets the distance between columns in a row.
If the GridSpacing property is set to "Auto" when copying, the distance between the elements in both row and column is preserved. This value is available only if an object is used as an antenna sublattice. EngeePhased.ULA or EngeePhased.URA.
Dependencies
To use this property, set the Layout value "Rectangular".
# SubarrayPosition — positions of antenna sublattices in the user grid
+
[0 0; -0.5 0.5; 0 0] (by default) | the 3 by N matrix
Details
The positions of the antenna sublattices in the user grid, set as a matrix on , where — the number of antenna sublattices in the antenna array. Each column of the matrix represents the position of one antenna sublattice in the local coordinate system of the antenna array in the form [x; y; z].
The units of measurement are m.
Dependencies
To use this property, set the Layout value "Custom".
# SubarrayNormal — directions of the antenna sublattices normals in the user grid
+
[0 0; 0 0] (by default) | the 2 by N matrix
Details
The directions of the antenna sublattices normals in the antenna array, set as a matrix on , where — the number of antenna sublattices in the antenna array. Each column of the matrix sets the direction of the normal of the corresponding antenna sublattice in the form [azimuth; elevation]. Each angle is set in degrees and defined in the local coordinate system.
The SubarrayPosition and SubarrayNormal properties can be used to specify any arrangement in which pairs of antenna sublattices differ by certain transformations. These transformations can include displacement, azimuth rotation, and elevation rotation. However, transformations that require rotation relative to the normal cannot be used.
Dependencies
To use this property, set the Layout value "Custom".
# SubarraySteering — a method of controlling an antenna sublattice
+
"None" (by default) | "Phase" | "Time" | "Custom"
Details
The method of controlling the antenna sublattice is set as "None", "Phase", "Time" or "Custom".
If the SubarraySteering property is set to "Phase", a phase shift is used to control the antenna sublattice. Use the object’s STEERANG argument to determine the direction of rotation.
If the SubarraySteering property is set to "Time" The antenna sublattice is controlled using time delays. Use the object’s STEERANG argument to determine the direction of rotation.
If the SubarraySteering property is set to "Custom" The antenna sublattices are controlled by setting independent weights for all elements in each antenna sublattice. Use the WS argument of the object to determine the weights for all antenna sublattices.
# PhaseShifterFrequency — frequency of the antenna sublattice phase shifter
+
3.0e8 (by default) | positive scalar
Details
The frequency of the antenna sublattice phase shifter is set as a positive scalar. The phase shifters control the antenna sublattice.
The units of measurement are Hz.
Dependencies
To use this property, set the SubarraySteering property to "Phase".
NumPhaseShifterBits — The bit depth of the phase shifter
+
0 (default) | a non-negative integer
Details
The number of bits used to quantize the phase shift component of the weighting coefficients of the beamforming vector or control vector, set as a non-negative integer. A zero value means that quantization is not performed.