Main Content

getSubarrayPosition

Get positions of NR panel array subarrays

Since R2023b

collapse all in page

    Syntax

    N = getSubarrayPosition(array)

    Description

    example

    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.

    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));

    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