System object: phased.PartitionedArray
Plot partitioned array directivity or pattern versus elevation
PAT = patternElevation(___)
the 2-D array directivity pattern versus elevation (in dBi) for the
sArray at zero degrees azimuth angle. When
a vector, multiple overlaid plots are created. The argument
the operating frequency.
The integration used when computing array directivity has a minimum sampling grid of 0.1 degrees. If an array pattern has a beamwidth smaller than this, the directivity value will be inaccurate.
in addition, plots the 2-D element directivity pattern versus elevation
(in dBi) at the azimuth angle specified by
AZ is a vector, multiple overlaid plots
the array pattern.
PAT = patternElevation(___)
PAT is a matrix whose entries
represent the pattern at corresponding sampling points specified by
'Elevation' parameter and the
sArray — Partitioned array
Partitioned array, specified as a
phased.PartitionedArray System object.
Specify optional pairs of arguments as
the argument name and
Value is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name in quotes.
ElementWeights — Weights applied to elements within subarray
1 (default) | complex-valued NSE-by-N
matrix | 1-by-N cell array
Subarray element weights, specified as complex-valued NSE-by-N matrix or 1-by-N cell array. Weights are applied to the individual elements within a subarray. Subarrays can have different dimensions and sizes.
ElementWeights is a complex-valued
NSE is the number of elements in the
largest subarray and N is the number of subarrays. Each column of the
matrix specifies the weights for the corresponding subarray. Only the first
K entries in each column are applied as weights where
K is the number of elements in the corresponding subarray.
ElementWeights is a 1-by-N cell array. Each
cell contains a complex-valued column vector of weights for the corresponding subarray.
The column vectors have lengths equal to the number of elements in the corresponding
To enable this name-value pair, set the
SubarraySteering property of the array to
Complex Number Support: Yes
Parent — Handle to axis
Handle to the axes along which the array geometry is displayed specified as a scalar.
Plot Elevation Directivity of Partitioned URA
Convert a 2-by-6 URA of isotropic antenna elements into a 1-by-3 partitioned array so that each subarray of the partitioned array is a 2-by-2 URA. Assume that the frequency response of the elements lies between 1 and 6 GHz. The elements are spaced one-half wavelength apart corresponding to the highest frequency of the element response. Plot the directivity for elevation angles from -45 to 45 degrees. For partitioned arrays, weights are applied to the subarrays instead of the elements.
Create partitioned array
fmin = 1e9; fmax = 6e9; c = physconst('LightSpeed'); lam = c/fmax; sIso = phased.IsotropicAntennaElement(... 'FrequencyRange',[fmin,fmax],... 'BackBaffled',false); sURA = phased.URA('Element',sIso,'Size',[2,6],... 'ElementSpacing',[lam/2,lam/2]); subarraymap = [[1,1,1,1,0,0,0,0,0,0,0,0];... [0,0,0,0,1,1,1,1,0,0,0,0];... [0,0,0,0,0,0,0,0,1,1,1,1]]; sPA = phased.PartitionedArray('Array',sURA,... 'SubarraySelection',subarraymap);
Plot elevation directivity pattern
Plot the response of the array at 5 GHz
fc = 5e9; wts = [0.862,1.23,0.862]'; azimangle = 0; patternElevation(sPA,fc,azimangle,... 'Type','directivity',... 'PropagationSpeed',physconst('LightSpeed'),... 'Elevation',[-45:45],... 'Weights',wts)
Directivity describes the directionality of the radiation pattern of a sensor element or array of sensor elements.
Higher directivity is desired when you want to transmit more radiation in a specific direction. Directivity is the ratio of the transmitted radiant intensity in a specified direction to the radiant intensity transmitted by an isotropic radiator with the same total transmitted power
where Urad(θ,φ) is the radiant intensity of a transmitter in the direction (θ,φ) and Ptotal is the total power transmitted by an isotropic radiator. For a receiving element or array, directivity measures the sensitivity toward radiation arriving from a specific direction. The principle of reciprocity shows that the directivity of an element or array used for reception equals the directivity of the same element or array used for transmission. When converted to decibels, the directivity is denoted as dBi. For information on directivity, read the notes on Element Directivity and Array Directivity.
Introduced in R2015a