Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

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.

collapse all

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.

Introduced in R2017a

Was this topic helpful?