Documentation

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.

customArrayMesh

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

Description

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

Creation

Description

example

customarray = customArrayMesh(points,triangles,numfeeds) creates a 2-D array represented by a custom mesh, based on the specified points and triangles.

Input Arguments

expand all

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

Example: load planarmesh.mat; c = customArrayMesh(p,t,4). Creates a custom array mesh from the points, p, extracted from the planarmesh.mat file.

Data Types: double

Triangles in the mesh, specified as a 4-by-M 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 array. This value sets the 'Triangles' property in the custom array mesh.

Example: load planarmesh.mat; c = customArrayMesh(p,t,4). Creates a custom array mesh from the triangles, t, extracted from the planarmesh.mat file.

Data Types: double

Number of feeding points in array, specified as a scalar. By default, the number of feed points are 2.

Example: load planarmesh.mat; c = customArrayMesh(p,t,4). Creates a custom array mesh requiring 4 feed points.

Data Types: double

Properties

expand all

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

Data Types: double

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

Data Types: double

Number of feeding points in the array, specified as a scalar.

Data Types: double

Feed locations of array, specified as Cartesian coordinates in meters. Feed location is a read-only property. To create a feed for the 2–D custom mesh, use the createFeed method.

Data Types: double

Excitation amplitude of antenna elements, specified as a scalar or a non-negative vector. Set the property value to 0 to model dead elements.

Example: 'AmplitudeTaper',3

Data Types: double

Phase shift for antenna elements, specified as a scalar or a real vector in degrees.

Example: 'PhaseShift',[3 3 0 0]. Creates a custom array mesh of four antennas with phase shifts specified.

Data Types: double

Object Functions

showDisplay antenna or array structure; Display shape as filled patch
infoDisplay information about antenna or array
createFeedCreate feed locations for custom array
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

Examples

expand all

Load a custom mesh and create an array.

load planarmesh.mat;
c = customArrayMesh(p,t,2);

Create feeds for the custom array mesh.

createFeed(c,[0.07,0.01],[0.05,0.05], [-0.07,0.01],[-0.05,0.05])

Calculate the impedance of the array.

Z = impedance(c,1e9)
Z = 
  48.9912 -19.0104i  44.6252 -20.2045i

References

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

Introduced in R2015b

Was this topic helpful?