# correlation

Correlation coefficient between two antennas in array

## Syntax

``correlation(array,frequency,elem1,elem2,z0)``
``rho = correlation(array,frequency,elem1,elem2,z0)``

## Description

example

````correlation(array,frequency,elem1,elem2,z0)` calculates and plots the correlation coefficient between two antenna elements, `elem1` and `elem2` of an array. The correlation values are calculated for a specified frequency and impedance and for a specified impedance `z0`.```

example

````rho = correlation(array,frequency,elem1,elem2,z0)` returns the correlation coefficient between two antenna elements, `elem1` and `elem2` of an array. ```

## Examples

collapse all

Plot the correlation between 1 and 2 antenna elements in a default linear array over a frequency range of 50MHz to 100MHz.

```h = linearArray; correlation (h,50e6:1e6:100e6,1,2);``` Calculate correlation coefficient of default rectangular array at a frequency range of 50MHz to 100MHz.

```h = rectangularArray; rho = correlation (h, 50e6:1e6:100e6, 1, 2)```
```rho = 51×1 0.1406 0.1110 0.0812 0.0510 0.0200 0.0119 0.0448 0.0782 0.1114 0.1427 ⋮ ```

## Input Arguments

collapse all

Array object, specified as a scalar handle.

Frequency range used to calculate correlation, specified as a vector in Hz.

Example: 50e6:1e6:100e6

Data Types: `double`

Antenna elements in an array, specified as a scalar handle.

Reference impedance, specified as a scalar in ohms.

Example: 70

Data Types: `double`

## Output Arguments

collapse all

Correlation coefficient between two antenna elements of an array, returned as a vector.

 S. Blanch, J. Romeu, and I. Corbella. Exact representation of antenna system diversity performance from input parameter description. Electron. Lett., vol. 39, pp. 705-707, May 2003.