customAntennaMesh

Create 2-D custom mesh antenna on X-Y plane

Description

The customAntennaMesh object creates an antenna represented by a 2-D custom mesh on the X-Y plane. You can provide an arbitrary antenna mesh to the Antenna Toolbox™ and analyze this mesh as a custom antenna for port and field characteristics.

Creation

Description

example

customantenna = customAntennaMesh(points,triangles) creates a 2-D antenna represented by a custom mesh, based on the specified points and triangles.

Input Arguments

expand all

Points in a custom mesh, specified as a 2-by-N or 3-by-N integer matrix of Cartesian coordinates in meters. N is the number of points. In case you specify a 3xN integer matrix, the Z-coordinate must be zero or a constant value. This value sets the 'Points' property in the custom antenna mesh.

Example: [0 1 0 1;0 1 1 0]

Data Types: double

Triangles in the mesh, specified as a 4-by-M integer matrix. M is the number of triangles. The first three rows are indices to the points matrix and represent the vertices of each triangle. The fourth row is a domain number useful for identifying separate parts of an antenna. This value sets the 'Triangles' property in the custom antenna mesh.

Data Types: double

Properties

expand all

Points in a custom mesh, specified as a 2-by-N or 3-by-N integer matrix of Cartesian coordinates in meters. N is the number of points.

Example: [0.1 0.2 0]

Data Types: double

Triangles in the mesh, specified as a 4-by-M integer matrix. M is the number of triangles.

Data Types: double

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

Example: 'Tilt',90

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

Data Types: double

Tilt axis of the antenna, specified as:

  • Three-element vectors 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, each specified as three-element vectors of Cartesian coordinates. In this case, the antenna rotates around the line joining the two points in space.

  • A string input describing simple rotations around one of the principal axes, 'X', 'Y', or 'Z'.

For more information, see Rotate Antennas and Arrays.

Example: 'TiltAxis',[0 1 0]

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

Example: ant.TiltAxis = 'Z'

Object Functions

showDisplay antenna or array structure; Display shape as filled patch
infoDisplay information about antenna or array
createFeedCreate feed location for custom antenna
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
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 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
returnLossReturn loss of antenna; scan return loss of array
sparametersS-parameter object
vswrVoltage standing wave ratio of antenna

Examples

collapse all

Load a custom planar mesh. Create the antenna and antenna feed. View the custom planar mesh antenna and calculate the impedance at 100 MHz.

load planarmesh.mat;
c = customAntennaMesh(p,t);
show(c)

createFeed(c,[0.07,0.01],[0.05,0.05]);
Z = impedance(c,100e6)
Z = 0.5091 + 57.2103i

References

[1] Balanis, C.A. Antenna Theory: Analysis and Design. 3rd Ed. New York: Wiley, 2005.

Introduced in R2015b