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.

pattern

Radiation pattern of antenna or array; Embedded pattern of antenna element in array

Syntax

pattern(object,frequency)
pattern(object,frequency,azimuth,elevation)
pattern(___,Name,Value)
[fieldval,azimuth,elevation] = pattern(object,frequency)
[pat,azimuth,elevation] = pattern(object,frequency,azimuth,elevation)
[pat,azimuth,elevation] = pattern(___,Name,Value)

Description

example

pattern(object,frequency) plots the 3-D radiation pattern of the antenna or array object over a specified frequency. By default, in Antenna Toolbox™, the far-field radius is set to 100λ.

pattern(object,frequency,azimuth,elevation) plots the radiation pattern of the antenna or array object using the specified azimuth and elevation angles.

pattern(___,Name,Value) uses additional options specified by one or more Name, Value pair arguments. You can use any of the input arguments from previous syntaxes.

Use the 'ElementNumber' and 'Termination' property to calculate the embedded pattern of the antenna element in an array connected to a voltage source. The voltage source model consists of an ideal voltage source of 1 volt in series with a source impedance. The embedded pattern includes the effect of mutual coupling due to the other antenna elements in the array.

[fieldval,azimuth,elevation] = pattern(object,frequency) returns the field value of an antenna or array object over a specified frequency. azimuth and elevation are the angles at which the pattern function calculates the directivity.

[pat,azimuth,elevation] = pattern(object,frequency,azimuth,elevation) returns the pattern value, pat, value of an antenna or array object at specified frequency. azimuth and elevation are the angles at which the pattern function calculates the directivity.

[pat,azimuth,elevation] = pattern(___,Name,Value) uses additional options specified by one or more Name,Value pair arguments.

Examples

collapse all

Calculate radiation pattern of default linear array for a frequency of 70 MHZ.

l = linearArray;
pattern(l,70e6)

h = helix;
pattern (h, 2e9, 0, 1:1:360);

Calculate the embedded element pattern of a linear array. Excite the first antenna element in the array.Terminate all the other antenna elements using a 50-ohm resistance.

l = linearArray;
pattern(l, 70e6,'ElementNumber', 1,'Termination', 50);

Calculate the directivity of a helix antenna.

h = helix;
D = pattern(h, 2e9, 0, 1:1:360);

Showing the first five directivity values.

Dnew = D(1:5)
Dnew =

   -6.5225
   -6.3032
   -6.0698
   -5.8242
   -5.5686

Input Arguments

collapse all

Antenna or array element, specified as an objects.

Frequency to calculate or plot antenna or array radiation pattern, specified as a scalar in Hz.

Example: 70e6

Data Types: double

Azimuth angles and spacing between the angles to visualize radiation pattern, specified vector in degrees. If the coordinate system is set to uv, then the U values are specified in this parameter. The values of U are between -1 to 1.

Example: 90

Data Types: double

Elevation angles and spacing between the angles to visualize radiation pattern, specified vector in degrees. If the coordinate system is set to uv, then the V values are specified in this parameter. The values of V are between -1 to 1.

Example: 0:1:360

Data Types: double

Name-Value Pair Arguments

Example: 'CoordinateSystem', 'uv'

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 to visualize 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

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

  • directivity – Directivity in dBi (lossless antenna or array)

  • gain – Gain in dBi (lossy antenna or array)

  • efield – Electric field in volt/meter

  • power – Power in watts

  • powerdb – Power in dB

The default value is 'directivity' for a lossless antenna and 'gain' for a lossy antenna. You cannot plot the 'directivity' of a lossy antenna.

Example: 'Type', 'efield'

Data Types: char

Normalize field pattern, specified as the comma-separated pair consisting of 'Normalize' and either true or false. You cannot use this property if the 'Type' is set to 'directivity'.

Example: 'Normalize', false

Data Types: double

2-D pattern display style when frequency is vector, specified as the comma-separated pair consisting of 'PlotStyle' and one of these values:

  • 'overlay' – Overlay frequency data in a 2-D line plot

  • 'waterfall' – Plot frequency data in a waterfall plot

You can use this property when using pattern function with no output arguments.

Example: 'PlotStyle', 'waterfall'

Data Types: char

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

  • '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

Antenna element in array, specified as the comma-separated pair consisting of 'ElementNumber' and scalar This antenna element is connected to the voltage source.

Example: 'ElementNumber',1

Data Types: double

Note

Use this property to calculate the embedded pattern of an array.

collapse all

Impedance value for array element termination, specified as the comma-separated pair consisting of 'Termination' and scalar. The impedance value terminates other antenna elements of an array while calculating the embedded pattern of the antenna connected to the voltage source.

Example: 'Termination',40

Data Types: double

Note

Use this property to calculate the embedded pattern of an array.

Output Arguments

collapse all

Radiation pattern of antenna or array or embedded pattern of array, returned as a matrix of number f elevation values by number of azimuth values. The pattern is one of the following:

  • directivity – Directivity in dBi (lossless antenna or array)

  • gain – Gain in dBi (lossy antenna or array)

  • efield – Electric field in volt/meter

  • power – Power in watts

  • powerdb – Power in dB

Matrix size is number of elevation values multiplied by number of azimuth values.

Azimuth angles to calculate radiation pattern, returned as a vector in degrees.

Elevation angles to calculate radiation pattern, returned as a vector in degrees.

See Also

|

Introduced in R2015a

Was this topic helpful?