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

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

Plot Array Factor

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

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

Input Arguments

object — Input antenna array

object

Input antenna array object, specified as an object.

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

frequency — Frequency value used to calculate array factor

scalar in Hz

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

Example: 70e6

Data Types: double

azimuth — Azimuth angle of antenna

–180:5:180 (default) | vector in degrees

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

Example: –90:5:90

Data Types: double

elevation — Elevation angle of antenna

–90:5:90 (default) | vector in degrees

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

Example: 0:1:360

Data Types: double

Name-Value 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.

CoordinateSystem — Coordinate system of array factor

'polar' (default) | 'rectangular' | 'uv'

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

PatternOptions — Parameter to change pattern plot properties

PatternPlotOptions object (default) | scalar

Parameter to change pattern plot properties, specified as the comma-separated pair consisting of 'PatternOptions' and a PatternPlotOptions output. The properties that you can vary are:

• Transparency

• MagnitudeScale

Other properties used in the 'PatternOptions' for the inset figure are ignored in arrayFactor.

Example: p = PatternPlotOptions('Transparency',0.1); Create a pattern plot option with a transparency of 0.1. antarray = rectangularArray;arrayFactor(antarray,70e6,'PatternOptions',p); Use this pattern plot option to visualize the pattern of a helix antenna.

Data Types: double

Output Arguments

af — Array factor

matrix in dB

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 — Azimuth values

vector in degrees

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

elevation — Elevation values

vector in degrees

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

Version History

Introduced in R2017a