Custom antenna element
The phased.CustomAntennaElement
System object™ models an antenna element with a custom spatial response pattern. The response
pattern can be defined for polarized or non-polarized fields.
To create a custom antenna element:
Create the phased.CustomAntennaElement
object and set its properties.
Call the object with arguments, as if it were a function.
To learn more about how System objects work, see What Are System Objects?.
creates a System object, antenna
= phased.CustomAntennaElementantenna
, with default property values. The default
response pattern is spatially isotropic.
creates a custom antenna object, antenna
= phased.CustomAntennaElement(Name
,Value
)antenna
, with each specified
property Name set to the specified Value. You can specify additional name-value pair
arguments in any order as
(Name1
,Value1
,...,NameN
,ValueN
).
For example, the output response of the object depends on whether polarization is set or not.
To create a nonpolarized response pattern, set the
SpecifyPolarizationPattern
property to
false
(default). Then, use the
MagnitudePattern
and PhasePattern
properties to define the response pattern.
To create a polarized response pattern, set the
SpecifyPolarizationPattern
property to
true
. Then, use any or all of the
HorizontalMagnitudePattern
,
HorizontalPhasePattern
,
VerticalMagnitudePattern
, and
VerticalPhasePattern
properties to define the response
pattern.
returns the antenna’s voltage response RESP
= antenna(FREQ
,ANG
)RESP
at operating frequencies
specified in FREQ
and directions specified in
ANG
. The form of RESP
depends upon whether the
antenna element supports polarization as determined by the
SpecifyPolarizationPattern
property. If
SpecifyPolarizationPattern
is set to false
,
RESP
is an M-by-L matrix
containing the antenna response at the M angles specified in
ANG
and at the L frequencies specified in
FREQ
. If SpecifyPolarizationPattern
is set to
true
, RESP
is a MATLAB®
struct
containing two fields, RESP.H
and
RESP.V
, representing the antenna's response in horizontal and
vertical polarization, respectively. Each field is an
M-by-L matrix containing the antenna response at
the M angles specified in ANG
and at the
L frequencies specified in FREQ
.
Note
The object performs an initialization the first time the object is executed. This
initialization locks nontunable properties
and input specifications, such as dimensions, complexity, and data type of the input data.
If you change a nontunable property or an input specification, the System object issues an error. To change nontunable properties or inputs, you must first
call the release
method to unlock the object.
To use an object function, specify the
System object as the first input argument. For
example, to release system resources of a System object named obj
, use
this syntax:
release(obj)
The total response of a custom antenna element is a combination
of its frequency response and spatial response. phased.CustomAntennaElement
calculates
both responses using nearest neighbor interpolation, and then multiplies
the responses to form the total response.
phased.ConformalArray
| phased.CosineAntennaElement
| phased.CrossedDipoleAntennaElement
| phased.IsotropicAntennaElement
| phased.ShortDipoleAntennaElement
| phased.ULA
| phased.URA
| phitheta2azel
| phitheta2azelpat
| uv2azel
| uv2azelpat