EngeePhased.PartitionedArray
Antenna arrays divided into sublattices.
| Library |
|
Description
System object EngeePhased.PartitionedArray simulates an antenna array divided into antenna sublattices. To create an antenna array and receive the response of its antenna sublattices, follow these steps:
-
Create an EngeePhased object.PartitionedArray and set its properties.
-
Call the object with arguments as if it were a function.
You can also specify a system object. EngeePhased.PartitionedArray as the value of the SensorArray or Sensor property of system objects that perform beamforming, control, and other operations.
Syntax
Creation
The constructor of a system object can be called in the following ways:
-
object = EngeePhased.PartitionedArraycreates an antenna array divided into antenna sublattices with default property values.Example:
array = EngeePhased.PartitionedArray -
object = EngeePhased.PartitionedArray(Name=Value)creates an antenna array divided into antenna sublattices, with each specified Name property set to the specified Value. You can specify additional arguments as a name-value pair in any order (Name1=Value1,…,NameN=ValueN).Example:
array = EngeePhased.PartitionedArray()
Using
-
RESP = object(FREQ,ANG,V)returns responses to the output argument of the RESP antenna sublattices at the operating frequencies specified in the FREQ argument and the directions specified in the ANG argument. 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 antenna sublattice using an equal-channel channel. -
RESP = object(FREQ,ANG,V,STEERANGLE)uses the value of the input argument STEERANGLE as the control direction of the sublattice antenna. This syntax is available when setting values for the SubarraySteering property.PhaseorTime. -
RESP = object(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 when setting the SubarraySteering property toCustom.
Features
Array — antenna array
+
EngeePhased.AbstractAntennaArray
Details
The antenna array object.
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 M by N. M is the number of antenna sublattices, and N is 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. The SubarraySelection and Array properties define the geometric center.
Data types: Float64
SubarraySteering — Antenna sublattice control method
+
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 STEERANG argument of the object to determine the direction of control.
If the SubarraySteering property is set to Time The antenna sublattice is controlled using time delays. Use the STEERANG argument of the object to determine the direction of control.
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.
Example: Time
Data types: char, string
PhaseShifterFrequency — frequency of the antenna sublattice phase shifter
+
300e6 (default) | positive scalar
Details
The frequency of the antenna sublattice phase shifter is set as a positive scalar. Phase shifters control the antenna sublattice.
The units of measurement are Hz.
Example: 1e9
Dependencies
To enable this property, set the SubarraySteering property to Phase.
Data types: Float64
NumPhaseShifterBits — number of phase shift quantization bits
+
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 is set as a non-negative integer. A zero value means that quantization is not performed.
Data types: Float64
Arguments
Entrance
FREQ — the operating frequency of the antenna array
+
the real vector of a series of length L
Details
The operating frequencies of the antenna array, specified as a real vector of strings of length L.
Typical values are in the range specified by the H.Array property.Element. This property is called FrequencyRange or FrequencyVector, depending on the type of antenna array element. At frequencies outside this range, the element has zero response.
The units of measurement are Hz.
Data types: Float64
ANG — azimuth and elevation angles of the response directions
+
a valid vector of strings of length M ` | `the real matrix 2 by M
Details
The direction specified as a real vector of a string of length M or a real matrix of 2 by M.
If ANG is a vector with a line length of M, each element sets the azimuth angle of the direction. In this case, the corresponding elevation angle is assumed to be 0.
If ANG – a 2-by-M matrix, each column of the matrix defines a direction in the form of [azimuth; altitude].
The azimuthal angle is the angle between the x axis and the projection of the direction vector onto the xy plane. This angle is positive when measured from the x axis towards the y axis. The elevation angle is the angle between the direction vector and the xy plane. This angle is positive when measured in the direction of the z axis.
The units of measurement are degrees.
Data types: Float64
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.
Data types: Float64
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 2. The vector has the form [azimuthAngle;elevationAngle]. The azimuth angle must be in the range from -180° to 180° inclusive. The elevation angle should be from -90° to 90° inclusive.
The units of measurement are degrees.
Example: [20;15]
Dependencies
To enable this argument, set the Sensor property to the value of the antenna array supporting the antenna sublattices, and set the SubarraySteering property of this antenna array to Phase or Time.
Data types: Float64
WS —
the complex matrix N_SE by N | array of cells 1 by N
Details
The weighting coefficients of the antenna sublattice elements, specified as a complex matrix N_SE by N or an array of cells 1 by N, where N is 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 N_SE by N, where N_SE is the number of elements in the largest antenna sublattice. The first Q entries in each column are the weighting coefficients of the antenna sublattices, where Q is the number of elements in the antenna sublattice;
-
array of cells 1 by N. Each cell contains a column vector of weights for the corresponding antenna sublattice. The column vectors have a length equal to the number of elements in the corresponding antenna sublattice.
Dependencies
To enable this argument, set the SubarraySteering property to Custom.
Data types: Float64
Output
RESP — volt-ampere characteristic of the antenna sublattice
+
the complex matrix M on L
Details
The voltage response of the antenna sublattice, returned as a complex matrix M by L. In this matrix, M is the number of angles specified in ANG, and L is the number of frequencies specified in FREQ.
Data types: Float64