quadCustom

Create Yagi-Uda custom array antenna

Description

The default quadCustom object creates a Yagi-Uda custom array along the z-axis resonating around 2.44 GHz.

Creation

Syntax

ant = quadCustom

ant = quadCustom(PropertyName=Value)

Description

ant = quadCustom creates a half-wavelength Yagi-Uda custom array antenna along the z-axis with default property values. The default antenna is excited using a dipole and consists of three directors and one reflector. The default dimensions are chosen for an operating frequency of around 2.44 GHz.

ant = quadCustom(PropertyName=Value) sets properties using one or more name-value arguments. PropertyName is the property name and Value is the corresponding value. You can specify several name-value arguments in any order as PropertyName1=Value1,...,PropertyNameN=ValueN. Properties that you do not specify, retain their default values.

For example, ant = quadCustom(Exciter=dipoleFolded) creates a Yagi-Uda custom array antenna with a folded dipole antenna as the exciter.

Properties

Exciter — Antenna to use as exciter

dipole (default) | antenna object

Antenna to use as an exciter, specified as one of the following antenna objects:

• dipoleFolded

• biquad

• dipole

• loopCircular

The quadCustom supports a single exciter.

Example: dipoleFolded

Director — Antenna to use as director element

array of three dipole antennas (default) | cell array of one or more antenna objects

Antenna to use as director element, specified as a cell array consisting of one or more of the following objects:

• dipole

• dipoleVee

• biquad

• loopRectangular

• loopCircular

You can use single or multiple antenna elements as directors.

Example: d = dipoleVee; ant = quadCustom(Director={d d d d}). Yagi-Uda custom array antenna uses V-dipole as its directors.

DirectorSpacing — Spacing between director elements

0.0423 (default) | real-valued scalar | vector

Spacing between the director elements, specified as a real-valued scalar in meters or a vector with each element unit in meters. You can specify a scalar value for equal spacing between the elements and vector value for unequal spacing between the elements. If you use a vector, the first value is the distance between the exciter and the first director element.

Example: [0.234 0.324]

Data Types: double

Reflector — Antenna or 2-D shape to use as reflector element

dipole (default) | cell array of one or more antenna and shape objects

Antenna or 2-D shape to use as reflector element, specified as a cell array of one or more objects from following:

Antennas

• dipole

• dipoleVee

• biquad

• loopRectangular

• loopCircular

2-D shapes

• antenna.Circle

• antenna.Ellipse

• antenna.Polygon

• antenna.Rectangle

Example: d = dipoleVee; ant = quadCustom(Reflector={d d d d}) Yagi-Uda custom array antenna uses V- dipole as its reflectors.

ReflectorSpacing — Spacing between reflector elements

0.0423 (default) | real-valued scalar | vector

Spacing between the reflector elements, specified as a real-valued scalar in meters or a vector with each element unit in meters. You can specify a scalar value for equal spacing between the elements or a vector value for unequal spacing between the elements. If you use a vector, the first value is the distance between the exciter and the first reflector element.

Example: [0.234 0.324]

Data Types: double

BoomLength — Length of boom

0.1800 (default) | real-valued scalar

Length of the boom, specified as a real-valued scalar in meters.

Example: 0.234

Data Types: double

BoomWidth — Width of boom

0.0020 (default) | real-valued scalar

Width of the boom, specified as a real-valued scalar in meters.

Example: 0.00324

Data Types: double

BoomOffset — Signed distance from center of antenna elements

[0 0.0050 0.0450] (default) | three-element vector

Signed distance from center of antenna elements, specified as a three-element vector with each element unit in meters.

Example: [0 0.0060 0.0350]

Data Types: double

Conductor — Type of metal

metal("PEC") (default) | metal object

Type of the metal used as a conductor, specified as a metal object. You can choose any metal from the MetalCatalog or specify a metal of your choice. For more information on metal conductor meshing, see Meshing.

Example: metal("Copper")

Load — Lumped elements

[1x1 lumpedElement] (default) | lumpedElement object

Lumped elements added to the antenna feed, specified as a lumpedElement object. You can add a load anywhere on the surface of the antenna. By default, the load is at the feed.

Example: lumpedElement(Impedance=75)

Tilt — Tilt angle of antenna

0 (default) | scalar | vector

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

TiltAxis — Tilt axis of antenna

[1 0 0] (default) | three-element vector | 2-by-3 matrix | "X" | "Y" | "Z"

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

axialRatio	Calculate and plot axial ratio of antenna or array
bandwidth	Calculate and plot absolute bandwidth of antenna or array
beamwidth	Beamwidth of antenna
charge	Charge distribution on antenna or array surface
current	Current distribution on antenna or array surface
design	Create antenna, array, or AI-based antenna resonating at specified frequency
efficiency	Calculate and plot radiation efficiency of antenna or array
EHfields	Electric and magnetic fields of antennas or embedded electric and magnetic fields of antenna element in arrays
feedCurrent	Calculate current at feed for antenna or array
impedance	Calculate and plot input impedance of antenna or scan impedance of array
info	Display information about antenna, array, or platform
memoryEstimate	Estimate memory required to solve antenna or array mesh
mesh	Generate and view mesh for antennas, arrays, and custom shapes
meshconfig	Change meshing mode of antenna, array, custom antenna, custom array, or custom geometry
msiwrite	Write antenna or array analysis data to MSI planet file
optimize	Optimize antenna and array catalog elements using SADEA or TR-SADEA algorithm
pattern	Plot radiation pattern of antenna, array, or embedded element of array
patternAzimuth	Azimuth plane radiation pattern of antenna or array
patternElevation	Elevation plane radiation pattern of antenna or array
peakRadiation	Calculate and mark maximum radiation points of antenna or array on radiation pattern
rcs	Calculate and plot monostatic and bistatic radar cross section (RCS) of platform, antenna, or array
resonantFrequency	Calculate and plot resonant frequency of antenna
returnLoss	Calculate and plot return loss of antenna or scan return loss of array
show	Display antenna, array structures, shapes, or platform
sparameters	Calculate S-parameters for antenna or array
stlwrite	Write mesh information to STL file
vswr	Calculate and plot voltage standing wave ratio (VSWR) of antenna or array element

Examples

Default Custom Yagi-Uda Array Antenna (quadCustom) and Radiation Pattern

Create and view a custom Yagi-Uda array antenna.

ant = quadCustom

ant = 
  quadCustom with properties:

             Exciter: [1×1 dipole]
            Director: {[1×1 dipole]  [1×1 dipole]  [1×1 dipole]}
     DirectorSpacing: 0.0423
           Reflector: {[1×1 dipole]}
    ReflectorSpacing: 0.0308
          BoomLength: 0.1800
           BoomWidth: 0.0020
          BoomOffset: [0 0.0050 0.0450]
           Conductor: [1×1 metal]
                Tilt: 0
            TiltAxis: [1 0 0]
                Load: [1×1 lumpedElement]

show(ant)

Plot the radiation pattern of the antenna at 2.4 GHz.

pattern(ant,2.4e9)

Custom Yagi-Uda Array Antenna with Seven Directors

Create the default quadCustom, change the number of directors to seven, and view the structure.

 ant = design(dipole,2.4e9);
 ant.Tilt = 90

ant = 
  dipole with properties:

        Length: 0.0587
         Width: 0.0012
    FeedOffset: 0
     Conductor: [1×1 metal]
          Tilt: 90
      TiltAxis: [1 0 0]
          Load: [1×1 lumpedElement]

 ant.TiltAxis = [0 1 0]

ant = 
  dipole with properties:

        Length: 0.0587
         Width: 0.0012
    FeedOffset: 0
     Conductor: [1×1 metal]
          Tilt: 90
      TiltAxis: [0 1 0]
          Load: [1×1 lumpedElement]

 quad_ant = quadCustom(Director={ant,ant,ant,ant,ant,ant,ant})

quad_ant = 
  quadCustom with properties:

             Exciter: [1×1 dipole]
            Director: {[1×1 dipole]  [1×1 dipole]  [1×1 dipole]  [1×1 dipole]  [1×1 dipole]  [1×1 dipole]  [1×1 dipole]}
     DirectorSpacing: 0.0423
           Reflector: {[1×1 dipole]}
    ReflectorSpacing: 0.0308
          BoomLength: 0.1800
           BoomWidth: 0.0020
          BoomOffset: [0 0.0050 0.0450]
           Conductor: [1×1 metal]
                Tilt: 0
            TiltAxis: [1 0 0]
                Load: [1×1 lumpedElement]

 show(quad_ant)

Plot the radiation pattern of the antenna at the frequency 2.4 GHz.

pattern(quad_ant,2.4e9)

References

[1] Bankey, Vinay, and N.Anvesh Kumar. "Design of a Yagi-Uda Antenna with Gain and Bandwidth Enhancement for Wi-Fi and Wi-Max Applications." International Journal of Antennas. Vol.2, Number 1, 2017

Version History

Introduced in R2019b