patternMultiply

Radiation pattern of array using pattern multiplication

Syntax

patternMultiply(array,frequency)

patternMultiply(array,frequency,azimuth)

patternMultiply(array,frequency,azimuth, elevation)

patternMultiply(___,Name,Value)

[fieldval,azimuth,elevation] = patternMultiply(array,frequency)

[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth)

[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth,elevation)

[fieldval,azimuth,elevation] = patternMultiply(___,Name,Value)

Description

patternMultiply(array,frequency) plots the 3-D radiation pattern of the array object over a specified frequency. patternMultiply calculates the full array pattern without taking the effect of mutual coupling between the different array elements.

patternMultiply(array,frequency,azimuth) plots the radiation pattern of the array object for the given azimuth angles. Elevation angles retain default values.

patternMultiply(array,frequency,azimuth, elevation) plots the radiation pattern of the array object for the given azimuth and elevation angles.

patternMultiply(___,Name,Value) uses additional options specified by one or more Name,Value pair arguments. Specify name-value pair arguments after all other input arguments.

[fieldval,azimuth,elevation] = patternMultiply(array,frequency) returns the field value such as the directivity of the lossless array in dBi or gain of the lossy array in dBi at the specified frequency. The size of the field value matrix is (number of elevation values) x (number of azimuth values).

[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth) returns the field value at the specified azimuth angles. Elevation angles retain default values.

[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth,elevation) returns the field value at the specified azimuth angles, and elevation angles.

[fieldval,azimuth,elevation] = patternMultiply(___,Name,Value) returns the field value using additional options specified by one or more Name,Value pair arguments. Specify name-value pair arguments after all other input arguments.

Examples

Radiation Pattern of Rectangular Array

Plot the radiation pattern of a default rectangular array at 70 MHz. Pattern multiplication does not take into consideration the effect of mutual coupling in array elements.

h = rectangularArray;
patternMultiply(h,70e6);

Radiation Pattern of Linear Array in Rectangular Coordinates

Plot the radiation pattern of a 10-element linear array at 70 MHz. Visualize the pattern using the rectangular coordinate system.

l = linearArray('NumElements',10);
patternMultiply(l,70e6,'CoordinateSystem','rectangular');

Rectangular Array Using Pattern Options

Plot the radiation pattern of a rectangular array with PatternOptions using a transparency of 0.6 and a magnitude scale of [-5 5].

h = rectangularArray; 
p = PatternPlotOptions;
p.Transparency = 0.6;
p.MagnitudeScale = [-5 5];
patternMultiply(h, 70e6,'PatternOptions',p);

Input Arguments

array — Input antenna array

object

Array object, specified as an object.

Example: r = rectangularArray; patternMultiply(r,70e6). Plot the pattern of a rectangular array.

frequency — Frequency used to calculate array pattern

scalar in Hz

Frequency used to calculate array pattern, 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 radiation pattern

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

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

Example: 'CoordinateSystem', 'polar'

Data Types: char

Type — Value to plot

'directivity' (default) | 'efield' | 'power' | 'powerdb'

Value to plot, specified as a comma-separated pair consisting of 'Type' and one of these values:

• 'directivity' – Radiation intensity of antenna in dBi in a given direction

• 'efield' – Electric field of antenna in volt/meter

• 'power' – Antenna power in (Volt/meter)²

• 'powerdb' – Antenna power in dB

Note

For more information, refer Field Calculation in Antennas.

Example: 'Type', 'efield'

Data Types: char

Normalize — Normalize field pattern

true (default) | false | boolean

Normalize field pattern, specified as the comma-separated pair consisting of 'Normalize' and either true or false. For directivity patterns, this property is not applicable.

Example: 'Normalize', false

Data Types: double

Polarization — Field polarization

'combined' (default) | 'H' | 'V' | 'RHCP' | 'LHCP'

Field polarization, specified as the comma-separated pair consisting of 'Polarization' and one of these values:

• 'combined'

• 'H' – Horizontal polarization

• 'V' – Vertical polarization

• 'RHCP' – Right-hand circular polarization

• 'LHCP' – Left-hand circular polarization

By default, you can visualize a combined polarization.

Example: 'Polarization', 'RHCP'

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

• SizeRatio

• AntennaOffset

• MagnitudeScale

Example: p = PatternPlotOptions('Transparency',0.1); Create a pattern plot option with a transparency of 0.1. antennaarray = linearArray;patternMultiply(antennaarray,75e6,'PatternOptions',p); Use this pattern plot option to visualize the pattern of a helix antenna.

Data Types: double

Output Arguments

fieldval — Array directivity or gain

matrix in dBi

Array directivity or gain, returned as a matrix in dBi. The matrix size is the product of the number of elevation values and azimuth values.

azimuth — Azimuth angles

vector in degrees

Azimuth angle used to calculate field values, returned as a vector in degrees.

elevation — Elevation angles

vector in degrees

Elevation angles used to calculate field values, returned as a vector in degrees.

Version History

Introduced in R2017a