Documentation

# arrayFactor

Array factor in dB

## Syntax

``arrayFactor(object,frequency)``
``arrayFactor(object,frequency,azimuth,elevation)``
``arrayFactor(___,Name,Value)``
``[af] = arrayFactor(object,frequency)``
``[af,azimuth,elevation] = arrayFactor(___)``
``[af,azimuth,elevation] = arrayFactor(___,Name,Value)``

## Description

example

````arrayFactor(object,frequency)` plots the 3-D array factor over the specified frequency value in dB.```
````arrayFactor(object,frequency,azimuth,elevation)` plots the array factor over the specified frequency, azimuth, and elevation values.```
````arrayFactor(___,Name,Value)` plots the array factor using additional options specified by one or more `Name,Value` pair arguments. Specify name-value pair arguments after all other input arguments.```
````[af] = arrayFactor(object,frequency)` returns the 3-D array factor over the specified frequency value.```
````[af,azimuth,elevation] = arrayFactor(___)` returns the array factor at the specified frequency, azimuth, and elevation values. ```
````[af,azimuth,elevation] = arrayFactor(___,Name,Value)` returns the array factor using additional options specified by one or more `Name,Value` pair arguments. Specify name-value pair arguments after all other input arguments.```

## Examples

collapse all

Plot the array factor of a default rectangular array at a frequency of 70 MHz.

```ra = rectangularArray; arrayFactor(ra,70e6);```

## Input Arguments

collapse all

Input antenna array object, specified as an object handle.

Example: `r = rectangularArray; arrayFactor (r,70e6)`. Calculates the array factor of a rectangular array.

Frequency value used to calculate array factor, specified as a scalar in Hz.

Example: `70e6`

Data Types: `double`

Azimuth angle of the antenna, specified as a vector in degrees.

Example: `–90:5:90`

Data Types: `double`

Elevation angle of the antenna, specified as a vector in degrees.

Example: `0:1:360`

Data Types: `double`

### Name-Value Pair Arguments

Example: `'CoordinateSystem'`, `rectangular`

Specify optional comma-separated pairs of `Name,Value` pair arguments. `Name` is the argument name and `Value` is the corresponding value. `Name` must appear inside single quotes (`''`). You can specify several name and value pair arguments in any order as ```Name1, Value1, ..., NameN, ValueN```.

Coordinate system of array factor, specified as the comma-separated pair consisting of `'CoordinateSystem'` and one of these values: `'polar'`, `'rectangular'`, `'uv'`.

Example: `'CoordinateSystem'`, `'polar'`

Data Types: `char`

## Output Arguments

collapse all

Array factor, returned as a matrix in `dB`. The matrix size is the product of number of elevation values and number of azimuth values.

Azimuth values used to calculate the array factor, returned as a vector in degrees.

Elevation values used to calculate the array factor, returned as a vector in degrees.