customArrayMesh

Create 2-D custom mesh antenna array on xy-plane

Description

The customArrayMesh object creates an array represented by a 2-D custom mesh on the xy-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

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

example

customarray = customArrayMesh(___,Name=Value) sets properties using one or more name-value arguments. Name is the property name and Value is the corresponding value. You can specify several name-value arguments in any order as Name1=Value1,...,NameN=ValueN. Properties that you do not specify, retain their default values.

Input Arguments

expand all

`points` — Points in custom mesh
`2-by-N` or `3-by-N` matrix of Cartesian coordinates in meters

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` — Triangles in mesh
`4-by-M` matrix

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

`numfeeds` — Number of feeding points in array
`2` (default) | scalar

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` — Points in custom mesh
`2-by-N` or `3-by-N` matrix of Cartesian coordinates

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` — Triangles in mesh
`4-by-M` matrix

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

Data Types: double

`NumFeeds` — Number of feed points
positive scalar

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

Data Types: double

`FeedLocation` — Feed location of array
cartesian coordinates

This property is read-only.

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

Data Types: double

`AmplitudeTaper` — Excitation amplitude of antenna elements
`1` (default) | scalar | non-negative vector

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: 3

Data Types: double

`PhaseShift` — Phase shift for antenna elements
`0` (default) | scalar | real vector

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

`axialRatio`	Calculate and plot axial ratio of antenna or array
`beamwidth`	Beamwidth of antenna
`charge`	Charge distribution on antenna or array surface
`correlation`	Correlation coefficient between two antennas in array
`createFeed`	Create feed at locations on custom array
`current`	Current distribution on antenna or array surface
`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
`layout`	Display array or PCB stack layout
`memoryEstimate`	Estimate memory required to solve antenna or array mesh
`mesh`	Mesh properties of metal, dielectric antenna, or array structure
`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
`pattern`	Plot radiation pattern and phase of antenna or array or embedded pattern of antenna element in 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
`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

collapse all