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.


Create antenna represented by 2-D custom geometry


The customAntennaGeometry object is an antenna represented by a 2-D custom geometry on the X-Y plane. Using customAntennaGeometry, you can import a planar mesh, define the feed for this mesh to create an antenna, analyze the antenna, and use it in finite or infinite arrays. The image shown is a custom slot antenna.



ca = customAntennaGeometry
ca = customAntennaGeometry(Name,Value)



ca = customAntennaGeometry creates a 2-D antenna represented by a custom geometry, based on the specified boundary.


ca = customAntennaGeometry(Name,Value) creates a 2-D planar antenna geometry, with additional properties specified by one or more name-value pair arguments. Name is the property name and Value is the corresponding value. You can specify several name-value pair arguments in any order as Name1, Value1, ..., NameN, ValueN. Properties not specified retain their default values.


expand all

Boundary information in Cartesian coordinates, specified as a cell array in meters.

Data Types: double

Boolean operation performed on the boundary list, specified as a character vector.

Example: 'Operation','P1-P2'

Data Types: double

Antenna feed location in Cartesian coordinates, specified as a three-element vector. The three-element vector is the X, Y, and Z coordinates respectively.

Example: 'FeedLocation', [0 0.2 0]

Data Types: double

Width of feed section, specified as a scalar in meters.

Example: 'FeedWidth',0.05

Data Types: double

Lumped elements added to the antenna feed, specified a lumped element object handle. For more information, see lumpedElement.

Example: 'Load', lumpedelement. lumpedelement is the object handle for the load created using lumpedElement.

Tilt angle of antenna, specified as a scalar or vector with each element unit in degrees.

Example: 'Tilt',90

Example: 'Tilt',[90 90 0]

Data Types: double

Tilt axis of the antenna, specified as:

  • A three-element vector of Cartesian coordinates in meters. In this case, each vector starts at the origin and lies along the specified points on the X, Y, and Z axes.

  • Two points in space as three-element vectors of Cartesian coordinates. In this case, the antenna rotates along the line joining the two points.

  • A string input for simple rotations around the principal planes, X, Y, or Z.

For more information see, Rotate Antenna and Arrays

Example: 'TiltAxis',[0 1 0]

Example: 'TiltAxis',[0 0 0;0 1 0]

Example: 'TiltAxis','Z'

Data Types: double

Object Functions

showDisplay antenna or array structure; Display shape as filled patch
infoDisplay information about antenna or array
axialRatioAxial ratio of antenna
beamwidthBeamwidth of antenna
chargeCharge distribution on metal or dielectric antenna or array surface
currentCurrent distribution on metal or dielectric antenna or array surface
designDesign prototype antenna for resonance at specified frequency
EHfieldsElectric and magnetic fields of antennas; Embedded electric and magnetic fields of antenna element in arrays
impedanceInput impedance of antenna; scan impedance of array
meshMesh properties of metal or dielectric antenna or array structure
meshconfigChange mesh mode of antenna structure
patternRadiation pattern of antenna or array; Embedded pattern of antenna element in array
patternAzimuthAzimuth pattern of antenna or array
patternElevationElevation pattern of antenna or array
returnLossReturn loss of antenna; scan return loss of array
sparametersS-parameter object
showDisplay antenna or array structure; Display shape as filled patch
vswrVoltage standing wave ratio of antenna


expand all

Create a custom dipole antenna and view it.

ca = customAntennaGeometry
ca = 
  customAntennaGeometry with properties:

        Boundary: {[4x3 double]}
       Operation: 'P1'
    FeedLocation: [0 0 0]
       FeedWidth: 0.0200
            Tilt: 0
        TiltAxis: [1 0 0]
            Load: [1x1 lumpedElement]


Create a custom slot antenna using three rectangles and a circle.

Make three rectangles of 0.5 m x 0.5 m, 0.02 m x 0.4 m and 0.03 m x 0.008 m.

pr = em.internal.makerectangle(0.5,0.5);
pr1 = em.internal.makerectangle(0.02,0.4);
pr2 = em.internal.makerectangle(0.03,0.008);

Make a circle of radius 0.05 m.

ph = em.internal.makecircle(0.05);

Translate the third rectangle to the X-Y plane using the coordinates [0 0.1 0].

pf = em.internal.translateshape(pr2,[0 0.1 0]);

Create a custom slot antenna element using the specified boundary shapes. Transponse pr, ph, pr1, and pf to make sure the boundary inputs are column vector arrays.

c = customAntennaGeometry('Boundary',{pr',ph',pr1',pf'},...

Move the feed location to new coordinates.

c.FeedLocation = [0,0.1,0];

Analyze the impedance of the antenna from 300 MHz to 800 MHz.

impedance(c, linspace(300e6,800e6,51));

Analyze the current distribution of the antenna at 575 MHz.


Plot the radiation pattern of the antenna at 575 MHz.



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

Introduced in R2016b

Was this topic helpful?