This is machine translation

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

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

phased.ShortDipoleAntennaElement System object

Short-dipole antenna element


The phased.ShortDipoleAntennaElement object models a short-dipole antenna element. A short-dipole antenna is a center-fed wire whose length is much shorter than one wavelength. This antenna object only supports polarized fields.

To compute the response of the antenna element for specified directions:

  1. Define and set up your short-dipole antenna element. See Construction .

  2. Call step to compute the antenna response according to the properties of phased.ShortDipoleAntennaElement. The behavior of step is specific to each object in the toolbox.


Starting in R2016b, instead of using the step method to perform the operation defined by the System object™, you can call the object with arguments, as if it were a function. For example, y = step(obj,x) and y = obj(x) perform equivalent operations.


h = phased.ShortDipoleAntennaElement creates the system object, h, to model a short-dipole antenna element.

h = phased.ShortDipoleAntennaElement(Name,Value) creates the system object, h, with each specified property Name set to the specified Value. You can specify additional name-value pair arguments in any order as (Name1,Value1,...,NameN,ValueN).



Antenna operating frequency range

Antenna operating frequency range specified as a 1-by-2 row vector in the form of [LowerBound HigherBound]. This vector defines the frequency range over which the antenna has a response. The antenna element has zero response outside this specified frequency range.

Default: [0 1e20]


Dipole axis direction

Dipole axis direction, specified as one of 'X', 'Y' or 'Z'. The dipole axis defines the direction of the dipole current with respect to the local coordinate system. 'X' specifies a dipole along the x-axis, 'Y' specifies a dipole along the y-axis, and 'Z' specifies a dipole along the z-axis.

Default: 'Z'


directivityDirectivity of short-dipole antenna element
isPolarizationCapablePolarization capability
patternPlot short-dipole antenna element directivity and patterns
patternAzimuthPlot short-dipole antenna element directivity or pattern versus azimuth
patternElevationPlot short-dipole antenna element directivity or pattern versus elevation
plotResponsePlot response pattern of antenna
stepOutput response of antenna element
Common to All System Objects

Allow System object property value changes


expand all

Specify a short-dipole antenna with the dipole oriented along the y-axis and operating at 250 MHz. Then, plot the 3-D responses for both the horizontal and vertical polarizations.

Note: This example runs only in R2016b or later. If you are using an earlier release, replace each call to the function with the equivalent step syntax. For example, replace myObject(x) with step(myObject,x).

Create the short-dipole antenna element System object™.

antenna = phased.ShortDipoleAntennaElement(...
fc = 250.0e6;

Plot the horizontal polarization response.


Plot the vertical polarization response.


Plot the combined response.



The total response of a short-dipole antenna element is a combination of its frequency response and spatial response. This System object calculates both responses using nearest neighbor interpolation and then multiplies the responses to form the total response.


[1] Mott, H., Antennas for Radar and Communications, John Wiley & Sons, 1992.

Extended Capabilities

Introduced in R2013a