Main Content

wireStack

Create single or multi-feed wire antenna

Since R2020a

Description

The wireStack object converts eligible dipole and loop antennas in the Antenna Catalog to wire antennas with single or multiple feeds. You can now create cylindrical thin-wire antennas and analyze them using the existing analysis functions.

Note

For some antennas, the wire geometry may be altered to allow the placement of the feed. Please use the show function to view the resulting antenna and verify its shape before running any analysis.

Creation

Description

example

ant = wireStack creates a half-wavelength wire dipole antenna. The default wire dipole is center fed with feed point at the origin, and is oriented along the z-axis. The antenna length is chosen for an operating frequency of 75 MHz.

ant = wireStack(element) converts a strip-based antenna from the Dipole Antennas, or Loop Antennas catalog to a wire antenna. Conversion is based on the equivalent radius using the strip2cylinder utility function.

Input Arguments

expand all

Antenna elements, specified as any one of the following antenna objects:

Output Arguments

expand all

Wire antenna, returned as a wireStack object.

Properties

expand all

Note

The wireStack antenna object only accepts dot method to change its properties.

Name of the wire antenna, specified as a string.

Example: ant.Name = "monopole"

Data Types: string

This property is read-only.

Antenna feed locations, returned as an N-by-3 array of Cartesian coordinates in meters.

Example: ant.FeedLocation = [0 2 4]

Data Types: double

Magnitude of excitation voltage in Volts at each feed, specified as a 1-by-N array of doubles.

Example: ant.FeedVoltage = 2

Data Types: double

Phase shift applied to voltage at each feed in degrees, specified as a 1-by-M array of doubles.

Example: ant.FeedVoltage = 60

Data Types: double

Tilt angle of the antenna in degrees, specified as a scalar or vector. For more information, see Rotate Antennas and Arrays.

Example: 90

Example: Tilt=[90 90],TiltAxis=[0 1 0;0 1 1] tilts the antenna at 90 degrees about the two axes defined by the vectors.

Data Types: double

Tilt axis of the antenna, specified as one of these values:

  • Three-element vector of Cartesian coordinates in meters. In this case, each coordinate in the vector starts at the origin and lies along the specified points on the x-, y-, and z-axes.

  • Two points in space, specified as a 2-by-3 matrix corresponding to two three-element vectors of Cartesian coordinates. In this case, the antenna rotates around the line joining the two points.

  • "x", "y", or "z" to describe a rotation about the x-, y-, or z-axis, respectively.

For more information, see Rotate Antennas and Arrays.

Example: [0 1 0]

Example: [0 0 0;0 1 0]

Example: "Z"

Data Types: double | string

Object Functions

axialRatioCalculate and/or plot axial ratio of antenna or array
beamwidthBeamwidth of antenna
chargeCharge distribution on antenna or array surface
currentCurrent distribution on antenna or array surface
EHfieldsElectric and magnetic fields of antennas or embedded electric and magnetic fields of antenna element in arrays
impedanceInput impedance of antenna or scan impedance of array
infoDisplay information about antenna, array, or platform
memoryEstimateEstimate memory required to solve antenna or array mesh
meshMesh properties of metal, dielectric antenna, or array structure
meshconfigChange meshing mode of antenna, array, custom antenna, custom array, or custom geometry
patternPlot radiation pattern and phase of antenna or array or embedded pattern of antenna element in array
patternAzimuthAzimuth plane radiation pattern of antenna or array
patternElevationElevation plane radiation pattern of antenna or array
returnLossReturn loss of antenna or scan return loss of array
showDisplay antenna, array structures, shapes, or platform
sparametersCalculate S-parameters for antennas and antenna arrays
vswrVoltage standing wave ratio (VSWR) of antenna or array element

Examples

collapse all

Create and view a default dipole wire antenna.

ant = wireStack
ant = 
  wireStack with properties:

            Name: 'Dipole'
    FeedLocation: [0 0 0]
     FeedVoltage: 1
       FeedPhase: 0
            Tilt: 0
        TiltAxis: [1 0 0]

show(ant)

Plot the radiation pattern of the antenna at the specified frequency.

pattern(ant,75e6)

Create and view a circular loop wire antenna.

ant = loopCircular(Radius=0.075, Thickness=0.0005);
wireant = wireStack(ant)
wireant = 
  wireStack with properties:

            Name: 'Circular loop'
    FeedLocation: [3.1745e-16 0.0747 0]
     FeedVoltage: 1
       FeedPhase: 0
            Tilt: 0
        TiltAxis: [1 0 0]

show(wireant)

Plot the directivity pattern of the antenna at 1 GHz.

pattern(wireant,1e9);

Version History

Introduced in R2020a