getSubarrayPosition

Get positions of NR panel array subarrays

Since R2023b

collapse all in page

    Syntax

    N = getSubarrayPosition(array)

    Description

    N = getSubarrayPosition(array) returns the total number of subarrays, N, in the panel array when the EnablePanelSubarray property is set to true. N is returned as 0 when the EnablePanelSubarray property is set to false.

    example

    Examples

    collapse all

    Open Live Script

    Construct a 5G antenna array with panels on a 2-by-2 grid with each panel being a 4-by-4 array. Each antenna element consists of two short-dipole elements. Use each panel as a subarray. The elements are spaced 1/2 wavelength apart and the panels are spaced at 5/2 wavelengths. Plot the response of the array at 6 GHz. Assume the weights for each element within the subarray is unity.

    c = physconst('LightSpeed');
fc = 6e9;
lambda = c/fc;
ant = phased.ShortDipoleAntennaElement;
array = phased.NRRectangularPanelArray(ElementSet={ant,ant}, ...
    Size=[4, 4, 2, 2], ...
    Spacing=[0.5*lambda,0.5*lambda,5*0.5*lambda,5*0.5*lambda], ...
    EnablePanelSubarray=true,SubarraySteering='Custom');

    Display the array pattern.

    pattern(array,fc,'ElementWeights',ones(16,8));

    Figure contains an axes object. The hidden axes object with title 3D Directivity Pattern contains 13 objects of type surface, line, text, patch.

    Compute the number of elements and the number of subarrays.

    getNumElements(array)
    ans = 
128

    getNumSubarrays(array)
    ans = 
8

    Then get the subarray positions.

    getSubarrayPosition(array)
    ans = 3×8

         0         0         0         0         0         0         0         0
   -0.0625   -0.0625   -0.0625   -0.0625    0.0625    0.0625    0.0625    0.0625
    0.0625    0.0625   -0.0625   -0.0625    0.0625    0.0625   -0.0625   -0.0625

    Input Arguments

    collapse all

    Phased array, specified as a phased.NRRectangularPanelArray System object™.

    Output Arguments

    collapse all

    Number of subarrays in panel array, returned as a nonnegative integer. Number of subarrays in the panel array when the EnablePanelSubarray property is set to true. N is returned as 0 when the EnablePanelSubarray property is set to false.

    Version History

    Introduced in R2023b

    See Also