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. Please click here
To view all translated materials including this page, select Japan from the country navigator on the bottom of this page.


Create circular antenna array


The circularArray object is a circular antenna array. Circular arrays finds application in direction of arrival (DoA) systems. You can sue circular arrays to perform 2-D scanning, while lowering element counts. These arrays also have the ability for 360 degree scanning. The individual elements in the circular array are part of the same array environment. This property reduces the impact of edge effects and other coupling variation.



ca = circularArray
ca = circularArray(Name,Value)


ca = circularArray creates a circular antenna array in the X-Y plane.


ca = circularArray(Name,Value) class to create a circular antenna array, 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

Individual antenna type, specified as a vector of objects. This property supports scalar expansion.

Example: 'Element',[monopole,monopole]

Number of elements in the array,specified as a positive scalar integer. The elements in the array are arranged along the X-axis.

Example: 'NumElements',4

Data Types: double

Radius of array, specified as a positive scalar integer in meters.

Example: 'Radius',0.4

Data Types: double

Starting angle offset for first element in array, specified as a real scalar in degrees.

Example: 'AngleOffset',8

Data Types: double

Excitation amplitude for antenna elements in the array, specified as a real positive vector of size 'Element'.

Example: 'AmplitudeTaper',[0 1]

Data Types: double

Phase shift for each element in the array, specified as a real vector of size 'Element' in degrees.

Example: 'PhaseShift',[0 2]

Data Types: double

Tilt angle of array, 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 array, 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
layoutDisplay array layout
showDisplay antenna or array structure; Display shape as filled patch
beamwidthBeamwidth of antenna
chargeCharge distribution on metal or dielectric antenna or array surface
correlationCorrelation coefficient between two antennas in array
currentCurrent distribution on metal or dielectric antenna or array surface
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
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


expand all

Create a circular antenna array using 10 antenna elements. View the layout of the antenna elements in the array.

ca = circularArray('NumElements',10)
ca = 

  circularArray with properties:

           Element: [1x1 dipole]
       NumElements: 10
            Radius: 1
       AngleOffset: 0
    AmplitudeTaper: 1
        PhaseShift: 0
              Tilt: 0
          TiltAxis: [1 0 0]

Display the array.


Plot the elevation pattern of the circular array at a frequency of 70 MHz.


Introduced in R2016b

Was this topic helpful?