EngeePhased.PartitionedArray
A phased array antenna divided into sublattices.
| Library |
|
Description
System object EngeePhased.PartitionedArray simulates an antenna array divided into sublattices.
To create and use an antenna array divided into sublattices, follow these steps:
-
Create an object EngeePhased.PartitionedArray 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.PartitionedArray()— creates an antenna array divided into antenna sublattices with default property values. -
array = EngeePhased.PartitionedArray(Name=Value)— creates an antenna array divided into 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 location
+
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 | a tuple of N elements
Details
The weighting coefficients of the antenna sublattice elements, specified as a complex matrix on or a tuple of elements where — the number of antenna sublattices.
Antenna arrays can have different dimensions. In this case, the weighting coefficients of the antenna sublattices can be set as:
-
matrices on , where — the number of elements in the largest antenna sublattice. First the entries in each column are the weighting coefficients of the antenna sublattices, where — the number of elements in the antenna sublattice;
-
tuples of elements. Each element contains a column vector of weighting coefficients for the corresponding antenna sublattice. The vectors have a length equal to the number of elements in the corresponding antenna sublattice.
Dependencies
To use this argument, set the SubarraySteering property to "Custom".
| Типы данных |
|
| Support for complex numbers |
yes |
Features
# Array — antenna array
+
ULA (by default) | antenna array system object
Details
Antenna array for separation, defined 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.
# SubarraySelection — antenna sublattice matrix
+
[1 1 0 0; 0 0 1 1] (by default) | the real matrix M by N
Details
Set the choice of the antenna sublattice in the form of a real matrix on , where — this is the number of antenna sublattices, and — the number of elements in the antenna array. Each row of the matrix corresponds to an antenna sublattice, and each entry in the row indicates whether an element belongs to the antenna sublattice or not.
If the record is zero, the element does not belong to the antenna sublattice. A non-zero entry is a complex value of a weighting factor applied to the corresponding element. Each row must contain at least one non-zero entry.
The phase center of each antenna sublattice is located in the geometric center of the antenna sublattice. Properties SubarraySelection and Array defines the geometric center.
# 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 (by 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.