# getNumSubarrays

Number of subarrays in panel array

Since R2023b

## Syntax

``N = getNumSubarrays(array)``

## Description

example

````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.```

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

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