Main Content

getNumSubarrays

Number of subarrays in panel array

Since R2023b

    Description

    N = getNumSubarrays(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

    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.

    Extended Capabilities

    C/C++ Code Generation
    Generate C and C++ code using MATLAB® Coder™.

    Version History

    Introduced in R2023b