# 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.1414 0.1120 0.0823 0.0521 0.0212 0.0105 0.0432 0.0765 0.1096 0.1410 ⋮ ```

## Input Arguments

collapse all

Array object, specified as a scalar.

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.

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.