Main Content

planeWaveExcitation

Create plane wave excitation environment for antenna or array

Description

The planeWaveExcitation object creates an environment in which a plane wave excites an antenna or array. Plane wave excitation is a scattering solution that solves the receiver antenna problem.

Creation

Description

example

h = planeWaveExcitation creates an environment in which a plane wave excites an antenna or array. The default receiver antenna is a dipole that is excited by a plane wave travelling along the positive x-axis with a z-polarization.

example

h = planeWaveExcitation(Name=Value) sets properties using one or more name-value arguments. Name is the property name and Value is the corresponding value. You can specify several name-value arguments in any order as Name1=Value1, ..., NameN=ValueN. Properties you do not specify retain their default values.

Properties

expand all

Antenna or array element, specified as an antenna or array object from the catalog.

Example: Element=linearArray

Incidence direction of the plane wave, specified as a three-element real vector containing the Cartesian coordinates of a point in space. The object creates the direction vector by joining a line from origin to this point.

Example: Direction=[0 0 1]

Data Types: double

Polarization of the incident electric field, specified as a three-element complex vector containing the Cartesian components of the electric field in V/m. The polarization gives the orientation and magnitude of the electric field.

Example: Polarization=[0 1 0]

Data Types: double
Complex Number Support: Yes

Solver for the antenna analysis, specified as one of these values:

  • 'MoM' --- Use the method of moments.

  • 'FMM' --- Use the fast multipole method.

Example: SolverType='FMM'

Data Types: string

Object Functions

axialRatioAxial ratio of antenna
beamwidthBeamwidth of antenna
chargeCharge distribution on antenna or array surface
currentCurrent distribution on antenna or array surface
doaDirection of arrival of signal
designDesign prototype antenna or arrays for resonance around specified frequency
EHfieldsElectric and magnetic fields of antennas; Embedded electric and magnetic fields of antenna element in arrays
meshMesh properties of metal, dielectric antenna, or array structure
meshconfigChange mesh mode of antenna structure
patternRadiation pattern and phase of antenna or array; Embedded pattern of antenna element in array
patternAzimuthAzimuth pattern of antenna or array
patternElevationElevation pattern of antenna or array
showDisplay antenna, array structures or shapes

Examples

collapse all

Excite a dipole antenna using a plane wave and view it.

h = planeWaveExcitation;
show(h)

Figure contains 2 axes objects. Axes object 1 with title dipole antenna element contains 3 objects of type patch, surface. These objects represent PEC, feed. Axes object 2 contains 2 objects of type quiver. These objects represent dir, pol.

The blue arrow shows the direction of propagation of the plane wave. The default direction is along the x-axis. The pink arrow shows polarization of the plane wave. The default polarization is perpendicular to the direction of propagation. In this case, the polarization is along the z-axis.

Excite a dipole antenna using plane wave. Calculate the feed current at 70 MHz.

h = planeWaveExcitation 
h = 
  planeWaveExcitation with properties:

         Element: [1×1 dipole]
       Direction: [1 0 0]
    Polarization: [0 0 1]
      SolverType: 'MoM'

cur = feedCurrent(h,70e6)
cur = 0.0182 - 0.0032i

Excite a dipole antenna using a plane wave. The polarization of the wave is along the z-axis and the direction of propagation is along the negative x-axis. View the antenna.

p = planeWaveExcitation(Element=dipole,Direction=[-1 0 0],Polarization=[0 0 1]);
show(p)

Figure contains 2 axes objects. Axes object 1 with title dipole antenna element contains 3 objects of type patch, surface. These objects represent PEC, feed. Axes object 2 contains 2 objects of type quiver. These objects represent dir, pol.

Plot the current distribution on the dipole antenna at 70 MHz.

current(p,70e6);

Figure contains an axes object. The axes object with title Current distribution contains 3 objects of type patch.

Consider a dipole excited by a plane wave.

p = planeWaveExcitation;
p.Direction = [0 1 1];
show(p)

Figure contains 2 axes objects. Axes object 1 with title dipole antenna element contains 3 objects of type patch, surface. These objects represent PEC, feed. Axes object 2 contains 2 objects of type quiver. These objects represent dir, pol.

For this antenna, the polarization and direction are not orthogonal to each other and thus any analysis errors out.

Use the cross-product function to find the appropriate polarization direction of such wave.

p = planeWaveExcitation;
p.Polarization = cross(p.Direction,[0 1 1]);
show(p)

Figure contains 2 axes objects. Axes object 1 with title dipole antenna element contains 3 objects of type patch, surface. These objects represent PEC, feed. Axes object 2 contains 2 objects of type quiver. These objects represent dir, pol.

Calculate the current distribution of the antenna.

current(p,75e6);

Figure contains an axes object. The axes object with title Current distribution contains 3 objects of type patch.

Excite an infinite array using a plane wave.

p = planeWaveExcitation(Element=infiniteArray)
p = 
  planeWaveExcitation with properties:

         Element: [1x1 infiniteArray]
       Direction: [1 0 0]
    Polarization: [0 0 1]
      SolverType: 'MoM'

show(p)

Figure contains 2 axes objects. Axes object 1 with title Unit cell of dipole over a reflector in an infinite Array contains 7 objects of type patch, surface. These objects represent PEC, feed, Air, unit cell. Axes object 2 contains 2 objects of type quiver. These objects represent dir, pol.

References

[1] Balanis, C. A. Antenna Theory. Analysis and Design. 3rd Ed. Hoboken, NJ: John Wiley & Sons, 2005.

Version History

Introduced in R2017a