The CosineAntennaElement
object models an antenna
with a cosine response in
both azimuth and elevation. The main response axis (MRA) points to
0° azimuth and 0° elevation in the antenna coordinate system.
When placed in a linear array, the MRA is normal to the array axis
(see, for example, phased.ULA
).
When placed in a planar array, the MRA points along the array normal
(see, for example, phased.URA
).
To compute the response of the antenna element for specified directions:
Define and set up your cosine antenna element. See Construction.
Call step
to compute the antenna
response according to the properties of phased.CosineAntennaElement
.
The behavior of step
is specific to each object in
the toolbox.
This antenna element is not capable of supporting polarization.
Note:
Starting in R2016b, instead of using the 
H = phased.CosineAntennaElement
creates
a cosine antenna system object, H
, that models
an antenna element whose response is cosine raised to a specified
power greater than or equal to one in both the azimuth and elevation
directions.
H = phased.CosineAntennaElement(
creates
a cosine antenna object, Name
,Value
)H
, with each specified
property set to the specified value. You can specify additional namevalue
pair arguments in any order as (Name1
,Value1
,...,NameN
,ValueN
).

Operating frequency range Specify the operating frequency range (in Hz) of the antenna
element as a 1by2 row vector in the form Default: 

Exponent of cosine pattern Specify the exponents of the cosine pattern as a scalar or a
1by2 vector. Exponent values must be real numbers greater than zero.
When you set Default: 
clone  Create cosine antenna object with same property values 
directivity  Directivity of cosine antenna element 
getNumInputs  Number of expected inputs to step method 
getNumOutputs  Number of outputs from step method 
isLocked  Locked status for input attributes and nontunable properties 
isPolarizationCapable  Polarization capability 
pattern  Plot cosine antenna element directivity and patterns 
patternAzimuth  Plot cosine antenna element directivity or pattern versus azimuth 
patternElevation  Plot cosine antenna element directivity or pattern versus elevation 
plotResponse  Plot response pattern of antenna 
release  Allow property value and input characteristics changes 
step  Output response of antenna element 
The step
method returns the field
response (or field pattern)
$$f(az,el)={\mathrm{cos}}^{m}(az){\mathrm{cos}}^{n}(el)$$
of the cosine antenna element.
In this expression
az is the azimuth angle.
el is the elevation angle.
The exponents m and n are real numbers greater than zero.
The response is defined for azimuth and elevation angles between –90° and 90°, inclusive, and is always positive. There is no response at the backside of a cosine antenna. The cosine response pattern achieves a maximum value of 1 at 0° azimuth and 0° elevation. Larger exponent values narrow the response pattern of the element and increase the directivity.
The power response (or power pattern) is the squared value of the field response.
$$P(az,el)={\mathrm{cos}}^{2m}(az){\mathrm{cos}}^{2n}(el)$$
phased.ConformalArray
 phased.CrossedDipoleAntennaElement
 phased.CustomAntennaElement
 phased.IsotropicAntennaElement
 phased.ShortDipoleAntennaElement
 phased.UCA
 phased.ULA
 phased.URA